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ámetros | Obligatorio | Descripción |
|---|---|---|
keywords | Obligatorio | Lista obligatoria de 1 a 1,000 palabras clave conocidas y no vacías, con un máximo de 80 caracteres por elemento. |
location_code | Opcional | Código numérico positivo del mercado de búsqueda. El Playground usa 2840 (Estados Unidos) de forma predeterminada. |
location_name | Opcional | Nombre del mercado de búsqueda, opcional, como alternativa a location_code. Si se completa, tiene prioridad sobre location_code. |
language_code | Opcional | Código del idioma de búsqueda, de 2 a 10 caracteres, aplicado a todo el lote. El Playground usa en de forma predeterminada. |
language | Opcional | Nombre del idioma de búsqueda, opcional, como alternativa a language_code. Si se completa, tiene prioridad sobre language_code. |
results_limit | Opcional | Lí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.
- Prepare de 1 a 1,000 palabras clave conocidas y no vacías, cada una de un máximo de 80 caracteres.
- Envíe por POST keywords junto con location_code y language_code a /v1/seo/keyword-overview y guarde el task_id devuelto.
- Consulte /v1/tasks/{task_id} hasta que la tarea tenga éxito o devuelva un error.
- 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 trueCasos 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.
APIs relacionadas
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.
- Keyword Suggestions API
- Ranked Keywords API
- Relevant Pages API
- Backlinks Summary API
- Backlinks API
- Referring Domains API
- Backlink Competitors API
- Domain Overview API
- Competitor Domains API
- Traffic Estimate API
- Domain Technologies API
- Whois Lookup API
- Google News API
- Google Images API
- Bing Search API
- YouTube Rank Tracker API
- Google Autocomplete API