Nexscope

Volumen de búsqueda basado en clickstream

Obtén estimaciones del volumen de búsqueda de palabras clave a partir de datos de clickstream. Llama a la API de Volumen de búsqueda basado en clickstream mediante REST o MCP para automatizar la investigación SEO.

CosteRecent 19 credits / call
Probar en línea
POST · https://api.nexscope.ai/seo/clickstreamSearchVolumeMCP · nexscope_seo_clickstream_search_volume
Investigación de palabras clave

Qué hace esta API

Obtén estimaciones del volumen de búsqueda de palabras clave a partir de datos de clickstream.

Casos de uso de la API de Volumen de búsqueda basado en clickstream

Crear una lista de palabras clave

Para crear una lista de palabras clave, un especialista en marketing de búsqueda envía las entradas específicas de la operación a Volumen de búsqueda basado en clickstream. Los resultados específicos de la operación permiten seleccionar términos de búsqueda candidatos para investigarlos más a fondo.

Comparar señales de demanda de búsqueda

Un especialista en marketing de búsqueda utiliza Volumen de búsqueda basado en clickstream con las entradas específicas de la operación para comparar señales de demanda de búsqueda. Los resultados específicos de la operación permiten comparar la demanda de palabras clave dentro del mercado solicitado.

Planificar una prueba de contenido o publicidad

En este flujo de trabajo, un especialista en marketing de búsqueda llama a Volumen de búsqueda basado en clickstream con las entradas específicas de la operación para planificar una prueba de contenido o publicidad. El resultado permite seleccionar términos para una prueba de contenido o publicidad.

Preguntas frecuentes sobre la API de Volumen de búsqueda basado en clickstream

¿Qué devuelve la API de Volumen de búsqueda basado en clickstream?

Obtén estimaciones del volumen de búsqueda de palabras clave a partir de datos de clickstream. 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 Volumen de búsqueda basado en clickstream?

El coste documentado actualmente es Recent 19 credits / call. 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 Volumen de búsqueda basado en clickstream desde mi aplicación o un cliente MCP?

Envía una solicitud POST a /api/skill-api/v1/skills/seo-clickstream-search-volume/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_clickstream_search_volume. 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éditosConectar esta API mediante MCP

Prueba esta API
Endpoint
https://api.nexscope.ai/seo/clickstreamSearchVolume
Método MCP
nexscope_seo_clickstream_search_volume

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/clickstreamSearchVolume

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/clickstreamSearchVolume' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "keywords": [
    "nexscope"
  ],
  "market": "US"
}'

Ejemplo de código

{
  "keywords": [
    "nexscope"
  ],
  "market": "US"
}

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ódigoDescripción
200Respuesta 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.
429Límite de admisión de ejecuciones; respeta Retry-After cuando esté presente.
503La admisión de ejecuciones no está disponible temporalmente; respeta Retry-After cuando esté presente.
OpcionalX-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 una clave API ausente o no válida (code 11209, incluida una copia incompleta o dañada) o una sesión web caducada (code 12001), 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.
Todas las categorías/ Keyword Research
POSThttps://api.nexscope.ai/seo/clickstreamSearchVolume

Ejecutar esta API

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

Endpoint

MétodoPOST
Rutahttps://api.nexscope.ai/seo/clickstreamSearchVolume
AutenticaciónBearer API key
Content-Typeapplication/json

Parámetros de la solicitud

NombreTipoObligatorioDescripción
keywordsarrayobligatorio
Valor de Keywords usado por esta operación de API.
Cantidad mínima de elementos: 1
Cantidad máxima de elementos: 20
keywords[]stringobligatorio
Tras eliminar los espacios Unicode de los extremos: de 3 a 80 letras ASCII, dígitos, espacios ordinarios, apóstrofos o guiones; al menos una letra o un dígito; como máximo diez palabras.
Longitud mínima: 1
marketstringopcional
Valor de Market usado por esta operación de API.
Constante: US
Predeterminado: US

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": {
      "inputKeywords": [
        "synthetic"
      ],
      "items": [
        {
          "averageMonthlySearches": 9007199254740992,
          "keyword": "synthetic",
          "missing": [
            {
              "field": "synthetic",
              "reason": "synthetic"
            }
          ],
          "months": [
            {
              "missing": [
                {
                  "field": "synthetic",
                  "reason": "synthetic"
                }
              ],
              "month": 1,
              "searchVolume": 9007199254740992,
              "year": 1
            }
          ]
        }
      ],
      "languageFilter": "synthetic",
      "marketScope": "synthetic",
      "missing": [
        {
          "field": "synthetic",
          "reason": "synthetic"
        }
      ],
      "normalizedKeywords": [
        "synthetic"
      ],
      "returnedCount": 1,
      "sourceKind": "synthetic",
      "sourceProduct": "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

NombreTipoObligatorioDescripción
codeintegerobligatorio
0 indica un sobre de respuesta satisfactorio; comprueba data.status por separado.
Permitidos: 0, 42008, 42009
coststringobligatorio
Milisegundos transcurridos de procesamiento; no es el precio. -1 en un contexto no web.
dataobjectobligatorio
Valor de Data usado por esta operación de API.
data.callIdstring | nullopcional
Valor de Call id usado por esta operación de API.
data.completedAtstring | integer | nullopcional
Valor de Completed at usado por esta operación de API.
data.coverageobjectopcional
Valor de Coverage usado por esta operación de API.
data.coverage.missingarrayopcional
Valor de Missing usado por esta operación de API.
data.coverage.missing[]objectobligatorio
Elemento de data coverage missing.
data.coverage.missing[].fieldstringopcional
Valor de Field usado por esta operación de API.
data.coverage.missing[].reasonstringopcional
Valor de Reason usado por esta operación de API.
data.coverage.statusstringopcional
Valor de Status usado por esta operación de API.
data.requestedAtstring | integer | nullopcional
Valor de Requested at usado por esta operación de API.
data.resultobject | nullobligatorio
Valor de Result usado por esta operación de API.
data.result.inputKeywordsarrayobligatorio
Valor de Input keywords usado por esta operación de API.
Cantidad mínima de elementos: 1
Cantidad máxima de elementos: 20
data.result.inputKeywords[]stringobligatorio
Elemento de data result inputKeywords.
data.result.itemsarrayobligatorio
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[]objectobligatorio
Elemento de data result items.
data.result.items[].averageMonthlySearchesinteger | nullobligatorio
Valor de Average monthly searches usado por esta operación de API.
Mínimo: 0
data.result.items[].keywordstringobligatorio
Valor de Keyword usado por esta operación de API.
data.result.items[].missingarrayobligatorio
Valor de Missing usado por esta operación de API.
Cantidad mínima de elementos: 0
data.result.items[].missing[]objectobligatorio
Elemento de data result items[] missing.
data.result.items[].missing[].fieldstringobligatorio
Valor de Field usado por esta operación de API.
data.result.items[].missing[].reasonstringobligatorio
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[].monthsarrayobligatorio
Valor de Months usado por esta operación de API.
Cantidad mínima de elementos: 0
Cantidad máxima de elementos: 12
data.result.items[].months[]objectobligatorio
Elemento de data result items[] months.
data.result.items[].months[].missingarrayobligatorio
Valor de Missing usado por esta operación de API.
Cantidad mínima de elementos: 0
data.result.items[].months[].missing[]objectobligatorio
Elemento de data result items[] months[] missing.
data.result.items[].months[].missing[].fieldstringobligatorio
Valor de Field usado por esta operación de API.
data.result.items[].months[].missing[].reasonstringobligatorio
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[].months[].monthintegerobligatorio
Valor de Month usado por esta operación de API.
Mínimo: 1
Máximo: 12
data.result.items[].months[].searchVolumeinteger | nullobligatorio
Valor de Search volume usado por esta operación de API.
Mínimo: 0
data.result.items[].months[].yearintegerobligatorio
Valor de Year usado por esta operación de API.
Mínimo: 1
data.result.languageFilternullobligatorio
Valor de Language filter usado por esta operación de API.
data.result.marketScopestringobligatorio
Valor de Market scope usado por esta operación de API.
Constante: US
data.result.missingarrayobligatorio
Valor de Missing usado por esta operación de API.
Cantidad mínima de elementos: 0
data.result.missing[]objectobligatorio
Elemento de data result missing.
data.result.missing[].fieldstringobligatorio
Valor de Field usado por esta operación de API.
data.result.missing[].reasonstringobligatorio
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.normalizedKeywordsarrayobligatorio
Valor de Normalized keywords usado por esta operación de API.
Cantidad mínima de elementos: 1
Cantidad máxima de elementos: 20
data.result.normalizedKeywords[]stringobligatorio
Elemento de data result normalizedKeywords.
data.result.returnedCountintegerobligatorio
Valor de Returned count usado por esta operación de API.
Mínimo: 0
data.result.sourceKindstringobligatorio
Valor de Source kind usado por esta operación de API.
Constante: clickstream_estimate
data.result.sourceProductstringobligatorio
Valor de Source product usado por esta operación de API.
Constante: keywords_data
data.result.truncatedbooleanobligatorio
Valor de Truncated usado por esta operación de API.
data.schemaVersionstring | nullopcional
Valor de Schema version usado por esta operación de API.
data.sourcestring | nullopcional
Valor de Source usado por esta operación de API.
data.statusstringopcional
Valor de Status usado por esta operación de API.
Permitidos: SUCCESS, PARTIAL, EMPTY, PROCESSING, UNKNOWN, FAILED
data.usageobject | nullopcional
Valor de Usage usado por esta operación de API.
data.usage.billingStatusstring | nullopcional
Valor de Billing status usado por esta operación de API.
data.usage.chargedCreditsstring | integer | nullopcional
Valor de Charged credits usado por esta operación de API.
msgstring | nullobligatorio
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.
timestringobligatorio
yyyy-MM-dd HH:mm:ss
traceIdstring | nullobligatorio
Valor de Trace id usado por esta operación de API.
tsstringobligatorio
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.

NombreTipoObligatorioDescripción
codeintegerobligatorio
0 indica un sobre de respuesta satisfactorio; comprueba data.status por separado.
Constante: 0
coststringobligatorio
Milisegundos transcurridos de procesamiento; no es el precio. -1 en un contexto no web.
dataobjectobligatorio
Valor de Data usado por esta operación de API.
data.callIdstring | nullobligatorio
Valor de Call id usado por esta operación de API.
data.reasonstringobligatorio
Valor de Reason usado por esta operación de API.
Constante: IN_PROGRESS
data.retryablebooleanopcional
Valor de Retryable usado por esta operación de API.
data.statusstringobligatorio
Valor de Status usado por esta operación de API.
Constante: PROCESSING
data.taskIdstring | nullopcional
Valor de Task id usado por esta operación de API.
msgstring | nullobligatorio
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.
timestringobligatorio
yyyy-MM-dd HH:mm:ss
traceIdstring | nullobligatorio
Valor de Trace id usado por esta operación de API.
tsstringobligatorio
Milisegundos desde el inicio de la época; serializador global de enteros long.

Respuesta de error

NombreTipoObligatorioDescripción
codeintegerobligatorio
0 indica un sobre de respuesta satisfactorio; comprueba data.status por separado.
coststringobligatorio
Milisegundos transcurridos de procesamiento; no es el precio. -1 en un contexto no web.
dataobjectobligatorio
Valor de Data usado por esta operación de API.
data.callIdstring | nullobligatorio
Valor de Call id usado por esta operación de API.
data.reasonstring | nullobligatorio
Valor de Reason usado por esta operación de API.
data.retryablebooleanopcional
Valor de Retryable usado por esta operación de API.
data.statusstring | nullobligatorio
Valor de Status usado por esta operación de API.
data.taskIdstring | nullopcional
Valor de Task id usado por esta operación de API.
msgstring | nullobligatorio
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.
timestringobligatorio
yyyy-MM-dd HH:mm:ss
traceIdstring | nullobligatorio
Valor de Trace id usado por esta operación de API.
tsstringobligatorio
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/clickstreamSearchVolume/calls/{callId} \
  -H "Authorization: Bearer nk-xxxxxxxxxxxxxxxxx"

Respuestas

CódigoDescripción
200Respuesta 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.
429Límite de admisión de ejecuciones; respeta Retry-After cuando esté presente.
503La admisión de ejecuciones no está disponible temporalmente; respeta Retry-After cuando esté presente.
OpcionalX-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 una clave API ausente o no válida (code 11209, incluida una copia incompleta o dañada) o una sesión web caducada (code 12001), 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

Conecta agentes remotos a través del endpoint HTTP Streamable estándar MCP 2025-11-25. Usa el código de autorización OAuth 2.1 con PKCE, o una clave de API por compatibilidad.

POST https://api.nexscope.ai/mcp
MCP-Protocol-Version: 2025-11-25
Content-Type: application/json
Autenticación

Los clientes OAuth solicitan el ámbito mcp:tools. La respuesta 401 del endpoint anuncia metadatos de recurso protegido para descubrir la autorización.

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_clickstream_search_volume",
    "arguments": {
      "keywords": [
        "nexscope"
      ],
      "market": "US"
    }
  }
}

¿Qué puedes hacer con esta API?

Datos explicados y casos de uso prácticos

AI Guide

Question

What data can Clickstream Search Volume provide, and how might I use it?

AI answer

This API gives clickstream-based search-volume estimates for submitted keywords in the US market. It includes an average monthly estimate and, when available, up to 12 monthly observations per keyword.

Data categoryDocumented fieldsWhat the values mean
Keyworddata.result.items[].keywordThe keyword to which the estimates apply.
Average demanddata.result.items[].averageMonthlySearchesEstimated average monthly searches; null means the value is unavailable.
Monthly demanddata.result.items[].months[].year, month, searchVolumeThe year, month, and estimated search volume for each returned observation.
Geographic and language scopedata.result.marketScope, languageFilter, sourceKindThe documented market is US, the language filter is null, and the source is a clickstream estimate.
Missing valuesdata.result.items[].missing[].field, reason; months[].missing[].field, reasonIdentifies unavailable or invalid values at keyword or monthly-observation level.
Result scopedata.result.returnedCount, truncatedNumber of returned keyword items and whether the response was truncated.
  • Compare estimated demand for several candidate keyword phrases in the US market.
    • Prompt example: “I plan search marketing for an online store. Could you compare estimated demand for several candidate keyword phrases in the US market? Show the returned values behind the comparison, and mark missing data.”
  • Plot returned monthly estimates to spot seasonal patterns for a keyword.
    • Prompt example: “I plan search marketing for an online store. Could you plot returned monthly estimates to spot seasonal patterns for a keyword? Show the relevant returned evidence and tell me what input you need from me.”
  • Check whether a recent monthly change differs from the keyword's average monthly estimate.
    • Prompt example: “I plan search marketing for an online store. Could you check whether a recent monthly change differs from the keyword's average monthly estimate? Show the relevant returned evidence and tell me what input you need from me.”
  • Identify keywords or months with missing estimates before using them in a planning model.
    • Prompt example: “I plan search marketing for an online store. Could you identify keywords or months with missing estimates before using them in a planning model? Show matching records and source links where the API provides them; ask me for any required identifier or filter.”

These are estimates derived from clickstream data, not exact search counts. No language-specific coverage is evidenced because languageFilter is null. The supplied example shows PROCESSING, not completed volume data.

API relacionadas