Comparación mensual de dominios por categoría

Compara el rendimiento mensual en búsquedas de varios dominios de una categoría de productos. Llama a la API de Comparación mensual de dominios por categoría mediante REST o MCP para automatizar la investigación SEO en tu aplicación o agente de IA.

CosteEstimación: 19 créditos / llamada

Probar en línea

POST · https://api.nexscope.ai/seo/categoryDomainComparisonMCP · nexscope_seo_category_domain_comparison

Competidores y tráfico

Qué hace esta API

Compara el rendimiento mensual en búsquedas de varios dominios de una categoría de productos.

Casos de uso de la API de Comparación mensual de dominios por categoría

Comparar la visibilidad de competidores

Para comparar la visibilidad de competidores, un especialista en marketing de búsqueda envía las entradas específicas de la operación a Comparación mensual de dominios por categoría. Los resultados específicos de la operación permiten identificar sitios web que compiten por la visibilidad en búsquedas relevantes.

Identificar páginas para continuar la investigación

Un especialista en marketing de búsqueda utiliza Comparación mensual de dominios por categoría con las entradas específicas de la operación para identificar páginas para continuar la investigación. Los resultados específicos de la operación permiten seleccionar páginas o consultas para una comparación más detallada.

Preparar una revisión del rendimiento de un sitio web

En este flujo de trabajo, un especialista en marketing de búsqueda llama a Comparación mensual de dominios por categoría con las entradas específicas de la operación para preparar una revisión del rendimiento de un sitio web. El resultado permite reunir pruebas para analizar el rendimiento de un sitio web.

Preguntas frecuentes sobre la API de Comparación mensual de dominios por categoría

¿Qué devuelve la API de Comparación mensual de dominios por categoría?

Compara el rendimiento mensual en búsquedas de varios dominios de una categoría de productos. Los campos opcionales pueden faltar; un valor ausente no debe interpretarse como un cero medido. Los valores de ejemplo ilustran la estructura de la respuesta, no resultados reales de la cuenta.

¿Cuántos créditos cuesta la API de Comparación mensual de dominios por categoría?

El coste documentado actualmente es Estimación: 19 créditos / llamada. Es el mismo coste que se muestra en la parte superior de esta página. Si se muestra un intervalo o una estimación, el cargo final depende de la solicitud. Revisa tus créditos disponibles y la página de precios antes de llamar a la API, y consulta los registros de uso de la API para conocer el cargo real.

¿Cómo llamo a la API de Comparación mensual de dominios por categoría desde mi aplicación o un cliente MCP?

Envía una solicitud POST a /api/skill-api/v1/skills/seo-category-domain-comparison/run con tu clave de API como token Bearer y las entradas JSON mostradas en Integración de API. En un cliente MCP compatible, como Claude o Cursor, conecta Nexscope y llama a nexscope_seo_category_domain_comparison. Se aplican los mismos parámetros de solicitud documentados; utiliza Prueba en línea para revisar una solicitud antes de incorporarla a tu aplicación.

Ver planes y créditos Conectar esta API mediante MCP (en inglés)

Prueba esta API

Endpoint

https://api.nexscope.ai/seo/categoryDomainComparison

Método MCP

nexscope_seo_category_domain_comparison

Paso 1 de 3 · Autenticarse

Autenticación

Todos los endpoints de ejecución requieren una clave de API de usuario. Envíala como token bearer en la cabecera Authorization .

Authorization: Bearer nk-xxxxxxxxxxxxxxxxx

Las claves de API ausentes o no válidas devuelven un error de autenticación. Gestiona las claves desde .

Paso 2 de 3 · Enviar una solicitud

POSThttps://api.nexscope.ai/seo/categoryDomainComparison

Ejecutar una API

Envía un cuerpo de solicitud JSON usando los parámetros descritos abajo.

Solicitud de ejemplo

Sustituye YOUR_API_KEY y ejecuta este comando en tu terminal.

curl -X POST 'https://api.nexscope.ai/seo/categoryDomainComparison' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "categoryIds": [
    12191
  ],
  "firstMonth": "2026-01",
  "language": "en",
  "limit": 10,
  "market": "US",
  "secondMonth": "2026-02"
}'

Ejemplo de código

{
  "categoryIds": [
    12191
  ],
  "firstMonth": "2026-01",
  "language": "en",
  "limit": 10,
  "market": "US",
  "secondMonth": "2026-02"
}

Paso 3 de 3 · Inspeccionar el resultado

Comprueba la respuesta

Consulta code para ver el estado de la solicitud y data para ver el resultado. Abre la referencia de parámetros y respuestas para consultar las definiciones completas de los campos.

Códigos de estado HTTP

Código	Descripción
200	Respuesta HTTP predeterminada tanto para el éxito como para muchos errores de negocio. Solo el código JSON externo 0 indica éxito o aceptación asíncrona; consulta data para obtener el resultado.
429	Límite de admisión de ejecuciones; respeta Retry-After cuando esté presente.
503	La admisión de ejecuciones no está disponible temporalmente; respeta Retry-After cuando esté presente.
Opcional	X-Nexscope-Http-Status: semantic asigna estados HTTP a los errores de negocio gestionados por el controlador en las rutas de ejecución y tareas. Los fallos previos a la autenticación, como la ausencia de una clave API (code 11209), pueden seguir devolviendo HTTP 200 antes de esta asignación. Comprueba siempre el código JSON externo; las solicitudes malformadas y los fallos de infraestructura también pueden devolver respuestas HTTP distintas de 200.

Ver parámetros y respuesta Probar en línea

Todas las categorías/ Competitors & Traffic

POSThttps://api.nexscope.ai/seo/categoryDomainComparison

Ejecutar esta API

Envía una solicitud JSON para ejecutar esta API y recibir los datos de respuesta documentados.

Abrir área de pruebas

Endpoint

Método	`POST`
Ruta	`https://api.nexscope.ai/seo/categoryDomainComparison`
Autenticación	`Bearer API key`
Content-Type	`application/json`

Parámetros de la solicitud

Nombre	Tipo	Obligatorio	Descripción
`categoryIds`	`array`	obligatorio	Valor de Category ids usado por esta operación de API. Cantidad mínima de elementos: 1 Cantidad máxima de elementos: 5
`categoryIds[]`	`integer`	obligatorio	Elemento de categoryIds. Mínimo: 1 Máximo: 2147483647
`firstMonth`	`string`	obligatorio	Valor de First month usado por esta operación de API. Patrón: ^\d{4}-\d{2}$
`language`	`string`	opcional	Valor de Language usado por esta operación de API. Constante: en Predeterminado: en
`limit`	`integer`	opcional	Valor de Limit usado por esta operación de API. Predeterminado: 10 Mínimo: 1 Máximo: 20
`market`	`string`	opcional	Valor de Market usado por esta operación de API. Constante: US Predeterminado: US
`secondMonth`	`string`	obligatorio	Valor de Second month usado por esta operación de API. Patrón: ^\d{4}-\d{2}$

Respuesta de ejemplo

Estructura de respuesta de ejemplo del contrato documentado de la API de SEO.

{
  "code": 0,
  "cost": "-1",
  "data": {
    "callId": "synthetic-call",
    "completedAt": null,
    "coverage": {
      "missing": [
        {
          "field": "synthetic",
          "reason": "UPSTREAM_FIELD_MISSING"
        }
      ],
      "status": "PARTIAL"
    },
    "requestedAt": "123",
    "result": {
      "categoryIds": [
        1
      ],
      "comparisonDirection": "synthetic",
      "engine": "synthetic",
      "firstMonth": "synthetic",
      "items": [
        {
          "categoryIds": [
            1
          ],
          "change": {
            "estimatedMonthlyVisits": 1.25,
            "serpCount": 9007199254740992
          },
          "currentEstimatedMonthlyVisits": 1.25,
          "currentSerpCount": 9007199254740992,
          "domain": "synthetic",
          "first": {
            "month": "synthetic",
            "organic": {
              "estimatedEquivalentAdsCostUsd": "synthetic",
              "estimatedMonthlyVisits": 1.25,
              "positions": {
                "p1": 9007199254740992,
                "p11to20": 9007199254740992,
                "p21to30": 9007199254740992,
                "p2to3": 9007199254740992,
                "p31to40": 9007199254740992,
                "p41to50": 9007199254740992,
                "p4to10": 9007199254740992,
                "p51to60": 9007199254740992,
                "p61to70": 9007199254740992,
                "p71to80": 9007199254740992,
                "p81to90": 9007199254740992,
                "p91to100": 9007199254740992
              },
              "serpCount": 9007199254740992
            }
          },
          "mainDomain": "synthetic",
          "missing": [
            {
              "field": "synthetic",
              "reason": "synthetic"
            }
          ],
          "second": {
            "month": "synthetic",
            "organic": {
              "estimatedEquivalentAdsCostUsd": "synthetic",
              "estimatedMonthlyVisits": 1.25,
              "positions": {
                "p1": 9007199254740992,
                "p11to20": 9007199254740992,
                "p21to30": 9007199254740992,
                "p2to3": 9007199254740992,
                "p31to40": 9007199254740992,
                "p41to50": 9007199254740992,
                "p4to10": 9007199254740992,
                "p51to60": 9007199254740992,
                "p61to70": 9007199254740992,
                "p71to80": 9007199254740992,
                "p81to90": 9007199254740992,
                "p91to100": 9007199254740992
              },
              "serpCount": 9007199254740992
            }
          }
        }
      ],
      "language": "synthetic",
      "market": "synthetic",
      "missing": [
        {
          "field": "synthetic",
          "reason": "synthetic"
        }
      ],
      "normalizedCategoryIds": [
        1
      ],
      "ordering": "synthetic",
      "requestedLimit": 1,
      "returnedCount": 1,
      "secondMonth": "synthetic",
      "sourceProduct": "synthetic",
      "taxonomy": "synthetic",
      "trafficKind": "synthetic",
      "truncated": false
    },
    "schemaVersion": "synthetic",
    "source": "synthetic",
    "status": "PARTIAL",
    "usage": {
      "billingStatus": "UNAPPROVED",
      "chargedCredits": "0"
    }
  },
  "msg": null,
  "time": "2026-01-01 00:00:00",
  "traceId": "synthetic-trace",
  "ts": "9007199254740993"
}

Campos de respuesta

Nombre	Tipo	Obligatorio	Descripción
`code`	`integer`	obligatorio	0 indica un sobre de respuesta satisfactorio; comprueba data.status por separado. Permitidos: 0, 42008, 42009
`cost`	`string`	obligatorio	Milisegundos transcurridos de procesamiento; no es el precio. -1 en un contexto no web.
`data`	`object`	obligatorio	Valor de Data usado por esta operación de API.
`data.callId`	`string \| null`	opcional	Valor de Call id usado por esta operación de API.
`data.completedAt`	`string \| integer \| null`	opcional	Valor de Completed at usado por esta operación de API.
`data.coverage`	`object`	opcional	Valor de Coverage usado por esta operación de API.
`data.coverage.missing`	`array`	opcional	Valor de Missing usado por esta operación de API.
`data.coverage.missing[]`	`object`	obligatorio	Elemento de data coverage missing.
`data.coverage.missing[].field`	`string`	opcional	Valor de Field usado por esta operación de API.
`data.coverage.missing[].reason`	`string`	opcional	Valor de Reason usado por esta operación de API.
`data.coverage.status`	`string`	opcional	Valor de Status usado por esta operación de API.
`data.requestedAt`	`string \| integer \| null`	opcional	Valor de Requested at usado por esta operación de API.
`data.result`	`object \| null`	obligatorio	Valor de Result usado por esta operación de API.
`data.result.categoryIds`	`array`	obligatorio	Valor de Category ids usado por esta operación de API. Cantidad mínima de elementos: 1 Cantidad máxima de elementos: 5
`data.result.categoryIds[]`	`integer`	obligatorio	Elemento de data result categoryIds. Mínimo: 1
`data.result.comparisonDirection`	`string`	obligatorio	Valor de Comparison direction usado por esta operación de API. Constante: second_minus_first
`data.result.engine`	`string`	obligatorio	Valor de Engine usado por esta operación de API. Constante: google
`data.result.firstMonth`	`string`	obligatorio	Valor de First month usado por esta operación de API.
`data.result.items`	`array`	obligatorio	Valor de Items usado por esta operación de API. Cantidad mínima de elementos: 0 Cantidad máxima de elementos: 20
`data.result.items[]`	`object`	obligatorio	Elemento de data result items.
`data.result.items[].categoryIds`	`array`	obligatorio	Valor de Category ids usado por esta operación de API. Cantidad mínima de elementos: 0 Cantidad máxima de elementos: 10000
`data.result.items[].categoryIds[]`	`integer`	obligatorio	Elemento de data result items[] categoryIds. Mínimo: 1
`data.result.items[].change`	`object`	obligatorio	Valor de Change usado por esta operación de API.
`data.result.items[].change.estimatedMonthlyVisits`	`number \| null`	obligatorio	Valor de Estimated monthly visits usado por esta operación de API.
`data.result.items[].change.serpCount`	`integer \| null`	obligatorio	Valor de Serp count usado por esta operación de API.
`data.result.items[].currentEstimatedMonthlyVisits`	`number \| null`	obligatorio	Valor de Current estimated monthly visits usado por esta operación de API. Mínimo: 0
`data.result.items[].currentSerpCount`	`integer \| null`	obligatorio	Valor de Current serp count usado por esta operación de API. Mínimo: 0
`data.result.items[].domain`	`string`	obligatorio	Valor de Domain usado por esta operación de API.
`data.result.items[].first`	`object`	obligatorio	Valor de First usado por esta operación de API.
`data.result.items[].first.month`	`string`	obligatorio	Valor de Month usado por esta operación de API.
`data.result.items[].first.organic`	`object`	obligatorio	Valor de Organic usado por esta operación de API.
`data.result.items[].first.organic.estimatedEquivalentAdsCostUsd`	`string \| null`	obligatorio	Valor de Estimated equivalent ads cost usd usado por esta operación de API. Patrón: ^(0\|[1-9][0-9]*)(\.[0-9]+)?$
`data.result.items[].first.organic.estimatedMonthlyVisits`	`number \| null`	obligatorio	Valor de Estimated monthly visits usado por esta operación de API. Mínimo: 0
`data.result.items[].first.organic.positions`	`object`	obligatorio	Valor de Positions usado por esta operación de API.
`data.result.items[].first.organic.positions.p1`	`integer \| null`	obligatorio	Valor de P1 usado por esta operación de API. Mínimo: 0
`data.result.items[].first.organic.positions.p11to20`	`integer \| null`	obligatorio	Valor de P11to20 usado por esta operación de API. Mínimo: 0
`data.result.items[].first.organic.positions.p21to30`	`integer \| null`	obligatorio	Valor de P21to30 usado por esta operación de API. Mínimo: 0
`data.result.items[].first.organic.positions.p2to3`	`integer \| null`	obligatorio	Valor de P2to3 usado por esta operación de API. Mínimo: 0
`data.result.items[].first.organic.positions.p31to40`	`integer \| null`	obligatorio	Valor de P31to40 usado por esta operación de API. Mínimo: 0
`data.result.items[].first.organic.positions.p41to50`	`integer \| null`	obligatorio	Valor de P41to50 usado por esta operación de API. Mínimo: 0
`data.result.items[].first.organic.positions.p4to10`	`integer \| null`	obligatorio	Valor de P4to10 usado por esta operación de API. Mínimo: 0
`data.result.items[].first.organic.positions.p51to60`	`integer \| null`	obligatorio	Valor de P51to60 usado por esta operación de API. Mínimo: 0
`data.result.items[].first.organic.positions.p61to70`	`integer \| null`	obligatorio	Valor de P61to70 usado por esta operación de API. Mínimo: 0
`data.result.items[].first.organic.positions.p71to80`	`integer \| null`	obligatorio	Valor de P71to80 usado por esta operación de API. Mínimo: 0
`data.result.items[].first.organic.positions.p81to90`	`integer \| null`	obligatorio	Valor de P81to90 usado por esta operación de API. Mínimo: 0
`data.result.items[].first.organic.positions.p91to100`	`integer \| null`	obligatorio	Valor de P91to100 usado por esta operación de API. Mínimo: 0
`data.result.items[].first.organic.serpCount`	`integer \| null`	obligatorio	Valor de Serp count usado por esta operación de API. Mínimo: 0
`data.result.items[].mainDomain`	`string \| null`	obligatorio	Valor de Main domain usado por esta operación de API.
`data.result.items[].missing`	`array`	obligatorio	Valor de Missing usado por esta operación de API. Cantidad mínima de elementos: 0
`data.result.items[].missing[]`	`object`	obligatorio	Elemento de data result items[] missing.
`data.result.items[].missing[].field`	`string`	obligatorio	Valor de Field usado por esta operación de API.
`data.result.items[].missing[].reason`	`string`	obligatorio	Valor de Reason usado por esta operación de API. Permitidos: UPSTREAM_FIELD_MISSING, UPSTREAM_FIELD_INVALID, DUPLICATE_UPSTREAM_ITEM, UPSTREAM_ITEM_MISSING
`data.result.items[].second`	`object`	obligatorio	Valor de Second usado por esta operación de API.
`data.result.items[].second.month`	`string`	obligatorio	Valor de Month usado por esta operación de API.
`data.result.items[].second.organic`	`object`	obligatorio	Valor de Organic usado por esta operación de API.
`data.result.items[].second.organic.estimatedEquivalentAdsCostUsd`	`string \| null`	obligatorio	Valor de Estimated equivalent ads cost usd usado por esta operación de API. Patrón: ^(0\|[1-9][0-9]*)(\.[0-9]+)?$
`data.result.items[].second.organic.estimatedMonthlyVisits`	`number \| null`	obligatorio	Valor de Estimated monthly visits usado por esta operación de API. Mínimo: 0
`data.result.items[].second.organic.positions`	`object`	obligatorio	Valor de Positions usado por esta operación de API.
`data.result.items[].second.organic.positions.p1`	`integer \| null`	obligatorio	Valor de P1 usado por esta operación de API. Mínimo: 0
`data.result.items[].second.organic.positions.p11to20`	`integer \| null`	obligatorio	Valor de P11to20 usado por esta operación de API. Mínimo: 0
`data.result.items[].second.organic.positions.p21to30`	`integer \| null`	obligatorio	Valor de P21to30 usado por esta operación de API. Mínimo: 0
`data.result.items[].second.organic.positions.p2to3`	`integer \| null`	obligatorio	Valor de P2to3 usado por esta operación de API. Mínimo: 0
`data.result.items[].second.organic.positions.p31to40`	`integer \| null`	obligatorio	Valor de P31to40 usado por esta operación de API. Mínimo: 0
`data.result.items[].second.organic.positions.p41to50`	`integer \| null`	obligatorio	Valor de P41to50 usado por esta operación de API. Mínimo: 0
`data.result.items[].second.organic.positions.p4to10`	`integer \| null`	obligatorio	Valor de P4to10 usado por esta operación de API. Mínimo: 0
`data.result.items[].second.organic.positions.p51to60`	`integer \| null`	obligatorio	Valor de P51to60 usado por esta operación de API. Mínimo: 0
`data.result.items[].second.organic.positions.p61to70`	`integer \| null`	obligatorio	Valor de P61to70 usado por esta operación de API. Mínimo: 0
`data.result.items[].second.organic.positions.p71to80`	`integer \| null`	obligatorio	Valor de P71to80 usado por esta operación de API. Mínimo: 0
`data.result.items[].second.organic.positions.p81to90`	`integer \| null`	obligatorio	Valor de P81to90 usado por esta operación de API. Mínimo: 0
`data.result.items[].second.organic.positions.p91to100`	`integer \| null`	obligatorio	Valor de P91to100 usado por esta operación de API. Mínimo: 0
`data.result.items[].second.organic.serpCount`	`integer \| null`	obligatorio	Valor de Serp count usado por esta operación de API. Mínimo: 0
`data.result.language`	`string`	obligatorio	Valor de Language usado por esta operación de API. Constante: en
`data.result.market`	`string`	obligatorio	Valor de Market usado por esta operación de API. Constante: US
`data.result.missing`	`array`	obligatorio	Valor de Missing usado por esta operación de API. Cantidad mínima de elementos: 0
`data.result.missing[]`	`object`	obligatorio	Elemento de data result missing.
`data.result.missing[].field`	`string`	obligatorio	Valor de Field usado por esta operación de API.
`data.result.missing[].reason`	`string`	obligatorio	Valor de Reason usado por esta operación de API. Permitidos: UPSTREAM_FIELD_MISSING, UPSTREAM_FIELD_INVALID, DUPLICATE_UPSTREAM_ITEM, UPSTREAM_ITEM_MISSING
`data.result.normalizedCategoryIds`	`array`	obligatorio	Valor de Normalized category ids usado por esta operación de API. Cantidad mínima de elementos: 1 Cantidad máxima de elementos: 5
`data.result.normalizedCategoryIds[]`	`integer`	obligatorio	Elemento de data result normalizedCategoryIds. Mínimo: 1
`data.result.ordering`	`string`	obligatorio	Valor de Ordering usado por esta operación de API. Constante: current_organic_etv_desc
`data.result.requestedLimit`	`integer`	obligatorio	Valor de Requested limit usado por esta operación de API. Mínimo: 1 Máximo: 20
`data.result.returnedCount`	`integer`	obligatorio	Valor de Returned count usado por esta operación de API. Mínimo: 0
`data.result.secondMonth`	`string`	obligatorio	Valor de Second month usado por esta operación de API.
`data.result.sourceProduct`	`string`	obligatorio	Valor de Source product usado por esta operación de API. Constante: dataforseo_labs
`data.result.taxonomy`	`string`	obligatorio	Valor de Taxonomy usado por esta operación de API. Constante: google_product_service
`data.result.trafficKind`	`string`	obligatorio	Valor de Traffic kind usado por esta operación de API. Constante: estimated
`data.result.truncated`	`boolean`	obligatorio	Valor de Truncated usado por esta operación de API.
`data.schemaVersion`	`string \| null`	opcional	Valor de Schema version usado por esta operación de API.
`data.source`	`string \| null`	opcional	Valor de Source usado por esta operación de API.
`data.status`	`string`	opcional	Valor de Status usado por esta operación de API. Permitidos: SUCCESS, PARTIAL, EMPTY, PROCESSING, UNKNOWN, FAILED
`data.usage`	`object \| null`	opcional	Valor de Usage usado por esta operación de API.
`data.usage.billingStatus`	`string \| null`	opcional	Valor de Billing status usado por esta operación de API.
`data.usage.chargedCredits`	`string \| integer \| null`	opcional	Valor de Charged credits usado por esta operación de API.
`msg`	`string \| null`	obligatorio	Para los casos satisfactorios y los fallos se prefiere el valor disponible de msg/errmsg/message del proveedor; el chino se traduce al inglés. Si falta el mensaje de éxito, su valor es null. Los errores propios de la plataforma y los estados de las tareas utilizan el inglés de la plataforma. El texto del mensaje nunca determina el éxito ni el reintento.
`time`	`string`	obligatorio	yyyy-MM-dd HH:mm:ss
`traceId`	`string \| null`	obligatorio	Valor de Trace id usado por esta operación de API.
`ts`	`string`	obligatorio	Milisegundos desde el inicio de la época; serializador global de enteros long.

Respuesta de procesamiento aceptado

code 0 confirma la aceptación. Usa data.callId para consultar la misma solicitud; el procesamiento no implica finalización.

Nombre	Tipo	Obligatorio	Descripción
`code`	`integer`	obligatorio	0 indica un sobre de respuesta satisfactorio; comprueba data.status por separado. Constante: 0
`cost`	`string`	obligatorio	Milisegundos transcurridos de procesamiento; no es el precio. -1 en un contexto no web.
`data`	`object`	obligatorio	Valor de Data usado por esta operación de API.
`data.callId`	`string \| null`	obligatorio	Valor de Call id usado por esta operación de API.
`data.reason`	`string`	obligatorio	Valor de Reason usado por esta operación de API. Constante: IN_PROGRESS
`data.retryable`	`boolean`	opcional	Valor de Retryable usado por esta operación de API.
`data.status`	`string`	obligatorio	Valor de Status usado por esta operación de API. Constante: PROCESSING
`data.taskId`	`string \| null`	opcional	Valor de Task id usado por esta operación de API.
`msg`	`string \| null`	obligatorio	Para los casos satisfactorios y los fallos se prefiere el valor disponible de msg/errmsg/message del proveedor; el chino se traduce al inglés. Si falta el mensaje de éxito, su valor es null. Los errores propios de la plataforma y los estados de las tareas utilizan el inglés de la plataforma. El texto del mensaje nunca determina el éxito ni el reintento.
`time`	`string`	obligatorio	yyyy-MM-dd HH:mm:ss
`traceId`	`string \| null`	obligatorio	Valor de Trace id usado por esta operación de API.
`ts`	`string`	obligatorio	Milisegundos desde el inicio de la época; serializador global de enteros long.

Respuesta de error

Nombre	Tipo	Obligatorio	Descripción
`code`	`integer`	obligatorio	0 indica un sobre de respuesta satisfactorio; comprueba data.status por separado.
`cost`	`string`	obligatorio	Milisegundos transcurridos de procesamiento; no es el precio. -1 en un contexto no web.
`data`	`object`	obligatorio	Valor de Data usado por esta operación de API.
`data.callId`	`string \| null`	obligatorio	Valor de Call id usado por esta operación de API.
`data.reason`	`string \| null`	obligatorio	Valor de Reason usado por esta operación de API.
`data.retryable`	`boolean`	opcional	Valor de Retryable usado por esta operación de API.
`data.status`	`string \| null`	obligatorio	Valor de Status usado por esta operación de API.
`data.taskId`	`string \| null`	opcional	Valor de Task id usado por esta operación de API.
`msg`	`string \| null`	obligatorio	Para los casos satisfactorios y los fallos se prefiere el valor disponible de msg/errmsg/message del proveedor; el chino se traduce al inglés. Si falta el mensaje de éxito, su valor es null. Los errores propios de la plataforma y los estados de las tareas utilizan el inglés de la plataforma. El texto del mensaje nunca determina el éxito ni el reintento.
`time`	`string`	obligatorio	yyyy-MM-dd HH:mm:ss
`traceId`	`string \| null`	obligatorio	Valor de Trace id usado por esta operación de API.
`ts`	`string`	obligatorio	Milisegundos desde el inicio de la época; serializador global de enteros long.

Obtener un resultado en procesamiento

Una respuesta conPROCESSING y un callIdsignifica que el resultado aún se está preparando. Usa la consulta de resultado siguiente con el identificador devuelto. Esta consulta lee el resultado guardado y no consume créditos.

curl -X GET https://api.nexscope.ai/seo/categoryDomainComparison/calls/{callId} \
  -H "Authorization: Bearer nk-xxxxxxxxxxxxxxxxx"

Respuestas

Código	Descripción
200	Respuesta HTTP predeterminada tanto para el éxito como para muchos errores de negocio. Solo el código JSON externo 0 indica éxito o aceptación asíncrona; consulta data para obtener el resultado.
429	Límite de admisión de ejecuciones; respeta Retry-After cuando esté presente.
503	La admisión de ejecuciones no está disponible temporalmente; respeta Retry-After cuando esté presente.
Opcional	X-Nexscope-Http-Status: semantic asigna estados HTTP a los errores de negocio gestionados por el controlador en las rutas de ejecución y tareas. Los fallos previos a la autenticación, como la ausencia de una clave API (code 11209), pueden seguir devolviendo HTTP 200 antes de esta asignación. Comprueba siempre el código JSON externo; las solicitudes malformadas y los fallos de infraestructura también pueden devolver respuestas HTTP distintas de 200.

Fuente de datos, vigencia y limitaciones

La fuente, la vigencia, la cobertura, los límites de frecuencia y las notas de estimación no se especifican en esta definición de API salvo que aparezcan en la documentación de campos de solicitud o respuesta anterior. No supongas datos oficiales del mercado ni actualización en tiempo real cuando no estén documentados explícitamente.

Paso 1 de 2 · Conectar tu cliente MCP

MCP

Usa el endpoint MCP cuando un agente necesite descubrir y llamar a herramientas de API con JSON-RPC.

GET /mcp/legacy

POST /mcp/legacy
Authorization: Bearer nk-xxxxxxxxxxxxxxxxx
Content-Type: application/json

Paso 2 de 2 · Llamar a la herramienta

Llamar a una herramienta

{
  "jsonrpc": "2.0",
  "id": "tool-call-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_seo_category_domain_comparison",
    "arguments": {
      "categoryIds": [
        12191
      ],
      "firstMonth": "2026-01",
      "language": "en",
      "limit": 10,
      "market": "US",
      "secondMonth": "2026-02"
    }
  }
}

Prueba en línea

Ejecuta la API actual con tu clave de API y la carga JSON. Las pruebas en línea usan el entorno de API configurado de este sitio; el Endpoint y los ejemplos que puedes copiar usan la dirección de integración pública.

Usa tu sesión iniciada en Nexscope

Laboratorio de API SEO

Comparación mensual de dominios por categoría

Solicitud en tiempo real

Estimación: 19 créditos / llamadaRegistros de uso de la API

Identificadores de categoría

Valor enviado como parámetro «categoryIds» de la solicitud.

1–5 valores

Primer mes

Valor enviado como parámetro «firstMonth» de la solicitud.

Idioma

Valor enviado como parámetro «language» de la solicitud.

Límite

Valor enviado como parámetro «limit» de la solicitud.

1–20

Mercado

Valor enviado como parámetro «market» de la solicitud.

Segundo mes

Valor enviado como parámetro «secondMonth» de la solicitud.

Las llamadas en tiempo real pueden consumir créditos de datos.

Resultado del procesamiento

Si una solicitud sigue procesándose, usa el identificador devuelto para recuperar su resultado guardado. El probador reconoce el identificador automáticamente y las consultas de resultados no consumen créditos.

Respuesta en tiempo real

Resultados

Aquí aparecerá el resultado en tiempo real.

Completa los campos de la solicitud anteriores y ejecuta la API. No se sustituye el resultado por una respuesta de ejemplo.

Probar con una clave API o MCP

Estimación: 19 créditos / llamadaRegistros de uso de la API

Pruébalo

Envía una solicitud real con el mismo contrato que se muestra en la referencia.

Endpoint

/seo/categoryDomainComparison

Processing result endpoint

https://api.nexscope.ai/seo/categoryDomainComparison/calls/{resultId}

Método de MCP

nexscope_seo_category_domain_comparison

Clave de API*

Contenido JSON*

cURL

curl -X POST \
  https://api.nexscope.ai/seo/categoryDomainComparison \
  -H "Authorization: Bearer nk-..." \
  -H "Content-Type: application/json" \
  -d '{ "categoryIds": [ 12191 ], "firstMonth": "2026-01", "language": "en", "limit": 10, "market": "US", "secondMonth": "2026-02" }'

Respuesta

Todavía no hay respuesta. Ejecuta la solicitud para ver la respuesta aquí.

Resultado del procesamiento

Usa el identificador recibido al ejecutar la solicitud. La herramienta de pruebas selecciona automáticamente la consulta de resultados correcta y estas consultas no consumen créditos.

Identificador del resultado

Respuesta del resultado

No task result yet. Query the task to see the generated output here.

API relacionadas

Palabras clave orgánicas posicionadas de un dominio

Enumera las palabras clave orgánicas para las que se posiciona un dominio, con sus posiciones. Llama a la API de Palabras clave orgánicas posicionadas de un dominio mediante REST o MCP para automatizar la investigación SEO.

Páginas con más palabras clave orgánicas posicionadas

Encuentra las páginas de un dominio que se posicionan para el mayor número de palabras clave orgánicas. Llama a la API de Páginas con más palabras clave orgánicas posicionadas mediante REST o MCP para automatizar la investigación SEO.

Intersección de palabras clave orgánicas entre dominios

Encuentra las palabras clave orgánicas para las que varios dominios se posicionan en común. Llama a la API de Intersección de palabras clave orgánicas entre dominios mediante REST o MCP para automatizar la investigación SEO.

Intersección de palabras clave orgánicas entre páginas

Encuentra las palabras clave orgánicas para las que varias páginas se posicionan en común. Llama a la API de Intersección de palabras clave orgánicas entre páginas mediante REST o MCP para automatizar la investigación SEO.