seo/
keyword-search-volume

Mida hasta 1,000 palabras clave conocidas con el volumen de búsqueda, el CPC, la competencia de pago y el historial mensual disponibles, en registros normalizados para un mercado o para el alcance mundial.

Keyword Search Volume API

Mediciones de palabras clave conocidas
Hasta 1,000 palabras clave
Historial mensual de demanda
24 créditos por solicitud
Listo
Listo

Ingrese los parámetros y envíe una solicitud. El estado de la tarea y los resultados normalizados aparecerán aquí.

README

Por SocQ · Actualizado el

Keyword Search Volume

Los registros de volumen de búsqueda de palabras clave asocian términos de búsqueda conocidos con la demanda estimada, el CPC, la competencia de pago y las observaciones mensuales de un contexto de búsqueda seleccionado o mundial. Estas mediciones sirven para comparar la demanda, revisar la estacionalidad, investigar el mercado de pago y enriquecer listas de términos.

Funcionalidades de la Keyword Search Volume API

  • Medición por lote de palabras clave conocidasMide de 1 a 1,000 palabras clave preparadas en una sola solicitud, con cada entrada limitada a 80 caracteres.
  • Campos de demanda de búsquedaDevuelve los valores de search_volume y las observaciones de monthly_searches disponibles para cada palabra clave que tenga datos de medición.
  • Contexto del mercado de pagoMantiene vinculados al término medido el CPC, la competencia, el nivel de competencia, el índice de competencia y los campos opcionales de puja disponibles.
  • Registros normalizados con contexto de la fuenteIncluye los campos de demanda estables en metrics y conserva en extra la fila completa devuelta, con los metadatos opcionales de mercado y puja.

Parámetros de la Keyword Search Volume API

ParámetrosObligatorioDescripción
keywordsObligatorioLista obligatoria de 1 a 1,000 palabras clave conocidas y no vacías, con un máximo de 80 caracteres por elemento.
location_codeOpcionalCódigo numérico positivo del mercado de búsqueda, opcional. El Playground envía 2840 (Estados Unidos) de forma explícita; deje este campo vacío junto con language_code para usar el alcance mundial del backend.
location_nameOpcionalNombre del mercado de búsqueda, opcional, como alternativa a location_code. Si se completa, tiene prioridad sobre location_code.
language_codeOpcionalCódigo del idioma de búsqueda, opcional, de 2 a 10 caracteres. El Playground envía en de forma explícita; deje este campo vacío junto con location_code para usar el alcance mundial del backend.
languageOpcionalNombre del idioma de búsqueda, opcional, como alternativa a language_code. Si se completa, tiene prioridad sobre language_code.
results_limitOpcionalLímite de resultados opcional, de 1 a 2,000.

Cómo usar la Keyword Search Volume API

Envíe una lista acotada de palabras clave conocidas con la configuración opcional de mercado e idioma y luego lea los campos de demanda normalizados en los registros de resultados asíncronos.

  1. Prepare de 1 a 1,000 palabras clave conocidas y no vacías, cada una de un máximo de 80 caracteres.
  2. Envíe keywords por POST a /v1/seo/keyword-search-volume; incluya location_code y language_code para una solicitud reproducible específica de un mercado y guarde el task_id devuelto.
  3. Consulte /v1/tasks/{task_id} hasta que la tarea tenga éxito o devuelva un error.
  4. Lea data.results.items y siga next_cursor mientras has_more sea true; revise extra para ver los campos de la fuente que no se incluyen en los campos normalizados.
curl -X POST "https://api.socq.ai/v1/seo/keyword-search-volume" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keywords":["keyword research","seo tools"],"location_code":2840,"language_code":"en"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Casos de uso de la Keyword Search Volume API

  • Comparación de demanda en una lista preparada: Relacione los valores de search_volume a una lista de términos conocida y compare la demanda estimada dentro de un contexto de búsqueda uniforme.
  • Revisión de estacionalidad mensual: Use las observaciones de year, month y search_volume para examinar los cambios de la demanda medida a lo largo del tiempo.
  • Investigación del panorama de búsqueda de pago: Compare el CPC, la competencia, el índice de competencia y el contexto opcional de puja entre las palabras clave medidas.

Consejos de expertos para la Keyword Search Volume API

  • Agrupe los términos preparados en un lote acotado cuando corresponda, porque el cargo fijo de 24 créditos se aplica a la solicitud y no a cada fila devuelta.
  • Mantenga location_code y language_code explícitos y sin cambios al comparar lotes; omita ambos solo cuando se busque el alcance mundial.
  • No envíe results_limit, porque la lista keywords controla el lote de esta operación y la operación no tiene un control de límite documentado.
  • Relacione las filas devueltas por palabra clave y trate los registros ausentes o los campos nulos como datos no disponibles y no como una demanda cero confirmada.
  • Interprete el CPC y la competencia como señales de búsqueda de pago y no como dificultad de posicionamiento orgánico, y tenga en cuenta que las variantes cercanas pueden compartir un volumen agregado.

Además de la Keyword Search Volume API, use estas APIs cuando necesite otro tipo de datos públicos de SEO.

  • Google Organic SERP API — Obtiene una página de resultados de Google en vivo por consulta y mercado, con destinos normalizados, posiciones, tipos de elemento y detalles completos de los resultados.
  • Keyword Difficulty API — Compara la dificultad de posicionamiento orgánico de un lote de palabras clave enviado, y devuelve cada palabra clave disponible con su puntuación normalizada.
  • Keyword Overview API — Enriquece un lote de palabras clave enviado con el contexto disponible de demanda, competencia de pago, dificultad, búsquedas mensuales e intención.
  • Keywords for Site API — Genera palabras clave relevantes para un sitio web, con las mediciones de demanda disponibles, historial mensual, contexto de mercado y filas de origen completas.
  • Keyword Suggestions API — Amplía una consulta semilla en términos de cola larga coincidentes, con las mediciones de demanda disponibles, historial mensual, contexto de intención y filas de origen completas.
  • Ranked Keywords API — Encuentra las palabras clave para las que se posiciona un dominio, subdominio o página, con las URLs correspondientes, posiciones, mediciones de búsqueda, intención y elementos de origen completos.

Explorar otras plataformas

Combine los datos de SEO con datos públicos de otras plataformas sociales compatibles.

Keyword Search Volume API — FAQ

Keyword Search Volume API es una interfaz programática que mide de 1 a 1,000 palabras clave conocidas en un mercado seleccionado o con alcance mundial. Devuelve el volumen de búsqueda, el CPC, la competencia de pago, el historial mensual y los campos de la fila completa de la fuente para cada palabra clave con datos.

La lista obligatoria keywords acepta de 1 a 1,000 cadenas no vacías de hasta 80 caracteres cada una. location_code y language_code son opcionales; el backend usa el alcance mundial cuando se omiten el mercado y el idioma.

Una fila ausente o un campo nulo significa que los datos de medición no estaban disponibles, no necesariamente que la demanda sea cero. Las variantes cercanas de una palabra clave también pueden compartir un valor agregado de volumen de búsqueda.

No. El CPC, competition, competition_level, competition_index y los campos de puja describen el contexto de búsqueda de pago; este endpoint no calcula la dificultad orgánica de la palabra clave.

Cada solicitud enviada cuesta una cantidad fija de 24 créditos de SocQ, sin importar la cantidad de palabras clave ni de filas devueltas dentro del lote aceptado.