Related Keywords
Las palabras clave relacionadas son consultas vinculadas a través del grafo de búsquedas relacionadas, con señales de profundidad, demanda, CPC, competencia, dificultad e intención. Estas relaciones y mediciones sirven para descubrir temas adyacentes, ampliar mapas de temas y comparar candidatas.
Funcionalidades de la Related Keywords API
- Ampliación del grafo de búsquedas relacionadasSigue las relaciones directas o recursivas entre consultas a partir de una semilla, con valores de profundidad de 0 a 4, sin exigir que contengan la frase.
- Objetos de medición de palabras claveDevuelve el volumen de búsqueda, el CPC, la competencia de pago, el historial mensual, la dificultad y la información de intención disponibles para cada consulta conectada.
- Contexto de relación conservadoMantiene en extra la profundidad de la fuente, las rutas de palabras clave relacionadas, keyword_data completo y otros campos variables para interpretar el grafo en detalle.
Parámetros de la Related Keywords 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, opcional. |
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, opcional, de 2 a 10 caracteres. |
language | Opcional | Nombre del idioma de búsqueda, opcional, como alternativa a language_code. Si se completa, tiene prioridad sobre language_code. |
depth | Opcional | Profundidad de la relación, de 0 a 4. El valor predeterminado, 1, devuelve las consultas conectadas de forma directa. |
results_limit | Opcional | Máximo solicitado de 1 a 1,000 palabras clave relacionadas. 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 Related Keywords API
Envíe una consulta semilla con una profundidad de relación, controles de mercado y una ventana de resultados acotada, y luego lea los registros relacionados en la tarea asíncrona completada.
- Elija una consulta no vacía, un location_code, un language_code, una depth de 0 a 4, un results_limit de 1 a 1,000 y un offset de 0 o mayor.
- Envíe el contenido por POST a /v1/seo/related-keywords 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/related-keywords" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"keyword research","depth":1,"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 Related Keywords API
- Descubrimiento de temas adyacentes: Use el texto de las consultas devueltas y el contexto de relación para encontrar temas conectados que no necesitan contener la frase semilla.
- Ampliación de mapas de temas: Compare la profundidad y las rutas de palabras clave relacionadas para extender una semilla desde sus vecinos directos hasta un grafo de consultas más amplio.
- Evaluación de palabras clave candidatas: Combine los términos relacionados con la demanda, el costo, la competencia, la dificultad, el historial mensual y la intención disponibles para preparar un conjunto de candidatas revisable.
Consejos de expertos para la Related Keywords API
- Comience con una depth de 1 para las relaciones directas; aumente la profundidad solo cuando un grafo más amplio justifique un grupo de candidatas mayor y posiblemente menos directo.
- Use Keyword Suggestions en su lugar cuando todos los términos devueltos deban conservar las palabras semilla, porque las consultas relacionadas pueden usar otra redacción.
- Mantenga fijos query, location_code, language_code y depth al comparar ventanas de resultados, para que el contexto de relación y de mercado siga siendo comparable.
- Trate offset como una cantidad de filas y no como un número de página, y auméntelo según la cantidad de filas de la fuente que desee omitir.
- Lea primero keyword, metrics, monthly_searches y search_intent en los campos normalizados y luego revise extra para ver la profundidad de la fuente y las rutas de relación.
- No suponga una intención idéntica por la proximidad en el grafo, y admita que las mediciones opcionales y los campos variables de extra puedan faltar.
APIs relacionadas
Además de la Related Keywords 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.
- 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.
- 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.
- Keywords for Site 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