seo/
keyword-overview

Enriquezca hasta 1,000 palabras clave conocidas en un mercado con el volumen de búsqueda, el CPC, la competencia de pago, la dificultad, las tendencias mensuales y la intención disponibles, en registros normalizados.

Keyword Overview API

Métricas de palabras clave combinadas
Hasta 1,000 palabras clave
Señales de demanda y competencia
0.15 créditos por palabra clave
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 Overview

Los registros de resumen de palabras clave combinan la demanda de búsqueda, la competencia de pago, la dificultad orgánica, las observaciones mensuales y la intención clasificada de términos de búsqueda conocidos. Estas señales complementarias sirven para enriquecer listas de términos, comparar oportunidades, segmentar la investigación y analizar la demanda a lo largo del tiempo.

Funcionalidades de la Keyword Overview API

  • Entrada por lote de palabras clave conocidasEvalúa de 1 a 1,000 palabras clave preparadas bajo un mismo mercado e idioma de búsqueda seleccionados.
  • Campos de demanda y búsqueda de pagoConserva el volumen de búsqueda, el CPC, la competencia, el nivel de competencia, el índice de competencia y las observaciones mensuales disponibles, para comparar la demanda y el mercado de pago.
  • Dificultad orgánica e intenciónIncluye la dificultad de la palabra clave y la información de intención de búsqueda disponibles junto con los campos de demanda, de modo que cada señal distinta quede vinculada al mismo término.
  • Fila de resumen completaRetiene en extra keyword_info, keyword_properties, los metadatos de resultados de búsqueda y otros objetos devueltos cuando están presentes.

Parámetros de la Keyword Overview 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. El Playground usa 2840 (Estados Unidos) de forma predeterminada.
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, de 2 a 10 caracteres, aplicado a todo el lote. El Playground usa en de forma predeterminada.
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 Overview API

Envíe una lista acotada de palabras clave conocidas con la configuración de mercado basada en códigos y luego lea los campos normalizados y los objetos de resumen completos 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 por POST keywords junto con location_code y language_code a /v1/seo/keyword-overview 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 revise extra.keyword_info o extra.keyword_properties para ver los campos de la fuente que no se incluyen en los campos normalizados; siga next_cursor mientras has_more sea true.
curl -X POST "https://api.socq.ai/v1/seo/keyword-overview" \
  -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 Overview API

  • Enriquecimiento de listas de palabras clave: Relacione los campos keyword_info y keyword_properties devueltos a una lista de términos ya preparada para obtener un registro de investigación común.
  • Comparación de demanda y competencia: Compare el volumen de búsqueda, el CPC, la competencia de pago y la dificultad de la palabra clave sin tratar las señales de pago y las orgánicas como intercambiables.
  • Segmentación por intención y tendencia: Use la información de intención de búsqueda junto con las observaciones mensuales de búsqueda para organizar los términos conocidos según su probable propósito y su patrón de demanda.

Consejos de expertos para la Keyword Overview API

  • Elimine las palabras clave duplicadas antes del envío, porque los cargos se calculan según la cantidad de entradas.
  • Mantenga fijos location_code y language_code al comparar términos para que el contexto de búsqueda seleccionado se mantenga uniforme.
  • Omita results_limit, porque la lista keywords controla este lote y la operación de resumen no tiene un control documentado de límite de resultados.
  • Lea extra.keyword_info y extra.keyword_properties para obtener el resumen completo, porque no todos los valores directos de la fuente se incluyen en un campo normalizado de nivel superior.
  • Trate los campos ausentes como datos no disponibles y no como un cero numérico, y relacione los registros devueltos por palabra clave y no por posición en la lista.
  • Interprete el CPC y la competencia como señales de búsqueda de pago, mientras que keyword_difficulty representa la competencia orgánica estimada.

Además de la Keyword Overview 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 Search Volume API — Mide palabras clave conocidas con el volumen de búsqueda, el CPC, la competencia de pago y el historial mensual de búsquedas disponibles.
  • 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.
  • Related Keywords API — Sigue rutas de búsquedas relacionadas a partir de una consulta semilla con controles de profundidad, mediciones de palabras clave disponibles, contexto de intención y filas de origen completas.
  • Search Intent API — Clasifica la intención de búsqueda principal y secundaria de un lote de palabras clave enviado, conservando las probabilidades de origen y los registros completos.

Explorar otras plataformas

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

Keyword Overview API — FAQ

Keyword Overview API es una interfaz programática que enriquece de 1 a 1,000 palabras clave conocidas en un mercado de búsqueda. Devuelve los campos disponibles de demanda, competencia de pago, dificultad orgánica, búsquedas mensuales, intención y fila completa de la fuente para cada palabra clave con datos.

La lista obligatoria keywords define el lote, con 1 a 1,000 cadenas no vacías de hasta 80 caracteres cada una. location_code y language_code seleccionan el contexto de búsqueda que usa el Playground.

Lea primero metrics, monthly_searches y search_intent normalizados, y luego revise extra.keyword_info y extra.keyword_properties para ver los campos de la fuente que no se incluyeron. Las claves dentro de extra siguen siendo opcionales y flexibles.

No. El CPC y la competencia describen señales de búsqueda de pago, mientras que keyword_difficulty estima la competencia de posicionamiento orgánico; use cada campo para su propia comparación.

Cada palabra clave enviada cuesta 0.15 créditos de SocQ, incluidas las entradas que no producen una fila devuelta. Por lo tanto, el valor predeterminado del Playground con dos palabras clave se estima en 0.3 créditos.