Keyword Suggestions
Las sugerencias de palabras clave son términos de búsqueda de cola larga que contienen una palabra o frase semilla con añadidos antes, después o dentro de ella, y sus registros pueden incluir señales de demanda, costo, competencia, historial mensual e intención. Estos términos coincidentes y sus mediciones sirven para ampliar consultas, investigar para briefs de contenido, analizar la búsqueda de pago y comparar de forma controlada variantes de redacción.
Funcionalidades de la Keyword Suggestions API
- Ampliación de texto completo desde una semillaDevuelve términos de búsqueda que conservan las palabras semilla enviadas y admiten añadidos antes, después o dentro de la frase, así como diferencias en el orden de las palabras.
- Objetos de medición de palabras claveConserva el volumen de búsqueda, el CPC, la competencia de pago, el historial mensual y los detalles de dificultad disponibles dentro de los datos de la fuente de cada registro.
- Contexto de intención de búsquedaExpone la información de intención principal y secundaria disponible para cada palabra clave coincidente, sin tratarla como una recomendación de posicionamiento.
- Ventanas de resultados controladasAcepta un tope de resultados de 1 a 1,000 y un desplazamiento de filas que empieza en cero para obtener una ventana posterior de la fuente.
Parámetros de la Keyword Suggestions API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
query | Obligatorio | Palabra clave o frase semilla obligatoria y no vacía. Cada tarea acepta una sola consulta. |
location_code | Opcional | Código numérico positivo del mercado de búsqueda. El Playground usa 2840 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. 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 | Máximo solicitado de 1 a 1,000 sugerencias. Es posible que se devuelvan menos filas. |
offset | Opcional | Cantidad de filas de la fuente, a partir de cero, que se omiten antes de recopilar la ventana de resultados solicitada. |
Cómo usar la Keyword Suggestions API
Envíe una consulta semilla con controles de mercado y una ventana de resultados acotada, y luego lea cada sugerencia en la tarea asíncrona completada.
- Elija una consulta no vacía, un location_code, un language_code, un results_limit de 1 a 1,000 y un offset de 0 o mayor.
- Envíe el contenido por POST a /v1/seo/keyword-suggestions 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 luego solicite el next_cursor devuelto mientras has_more siga en true.
curl -X POST "https://api.socq.ai/v1/seo/keyword-suggestions" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"keyword research","location_code":2840,"language_code":"en","results_limit":100}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueCasos de uso de la Keyword Suggestions API
- Ampliación de consultas de cola larga: Use una frase semilla y el texto de las palabras clave devueltas para recopilar variantes de consulta más largas que conservan las palabras originales.
- Investigación de candidatas para briefs de contenido: Combine los términos coincidentes con los campos disponibles de volumen, historial mensual, dificultad e intención para armar un conjunto de palabras clave revisable.
- Comparación de palabras clave de búsqueda de pago: Compare las mediciones disponibles de CPC y de competencia de pago entre variantes de redacción antes de entregar los candidatos a un flujo de planificación.
Consejos de expertos para la Keyword Suggestions API
- Use una frase semilla específica cuando necesite variantes de cola larga muy ajustadas; elija un endpoint semántico de palabras clave cuando los términos no necesiten contener las palabras semilla.
- Trate offset como una cantidad de filas y no como un número de página, y auméntelo según el tamaño de la ventana de la fuente que desee omitir.
- Registre juntos query, location_code, language_code, results_limit y offset, porque el orden posterior de la fuente puede cambiar entre solicitudes que de otro modo serían equivalentes.
- Lea primero keyword y search_intent en los campos normalizados y luego revise extra.keyword_info y extra.keyword_properties para ver los objetos de medición directos que no se incluyen en los campos normalizados.
- Elimine los duplicados de ventanas repetidas por palabra clave más mercado e idioma, y admita que cualquier métrica opcional u objeto anidado pueda faltar.
APIs relacionadas
Además de la Keyword Suggestions 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.
- 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.
- Ranked Keywords API
- Relevant Pages API
- Search Intent 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