seo/
related-keywords

Descubra las consultas conectadas con una semilla a través de rutas de búsquedas relacionadas, con métricas de palabras clave, demanda mensual, intención y profundidad de la relación en registros normalizados.

Related Keywords API

Grafo de búsquedas relacionadas
Control de profundidad
Mediciones de palabras clave
0.1 créditos por resultado
Listo
README

Por SocQ · Actualizado el

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ámetrosObligatorioDescripción
queryObligatorioPalabra clave o frase semilla obligatoria y no vacía. Cada tarea acepta una sola consulta.
location_codeOpcionalCódigo numérico positivo del mercado de búsqueda, opcional.
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.
languageOpcionalNombre del idioma de búsqueda, opcional, como alternativa a language_code. Si se completa, tiene prioridad sobre language_code.
depthOpcionalProfundidad de la relación, de 0 a 4. El valor predeterminado, 1, devuelve las consultas conectadas de forma directa.
results_limitOpcionalMáximo solicitado de 1 a 1,000 palabras clave relacionadas. Es posible que se devuelvan menos filas.
offsetOpcionalCantidad 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.

  1. 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.
  2. Envíe el contenido por POST a /v1/seo/related-keywords 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 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 true

Casos 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.

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.

Explorar otras plataformas

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

Related Keywords API — FAQ

Related Keywords API es una interfaz programática que encuentra las consultas conectadas con una semilla a través del grafo de búsquedas relacionadas de un mercado de búsqueda seleccionado. Devuelve el texto de la palabra clave, las mediciones disponibles, el historial mensual, la información de intención, la profundidad de la relación y las filas completas de la fuente.

depth acepta de 0 a 4: 0 representa la semilla enviada, 1 abarca las relaciones directas y los valores mayores amplían de forma recursiva. Las profundidades mayores pueden producir un grupo de candidatas más amplio y con una relación menos directa.

No. Las conexiones de búsquedas relacionadas pueden devolver otra redacción, así que use Keyword Suggestions cuando el requisito sean variantes de cola larga que contengan la frase.

Los registros normalizados pueden incluir el texto de la palabra clave, el volumen de búsqueda, el CPC, la competencia de pago, la dificultad de la palabra clave, las búsquedas mensuales y la información de intención. La profundidad de la relación de la fuente, las rutas relacionadas y el objeto keyword_data completo permanecen en extra.

results_limit es un tope de 1 a 1,000, mientras que offset es la cantidad de filas anteriores de la fuente que se omiten. offset no es un número de página y la fuente puede devolver menos filas de las solicitadas.

Cada palabra clave relacionada devuelta cuesta 0.1 créditos de SocQ. Un conjunto de resultados vacío no genera cargo por resultados, y results_limit aporta la estimación previa a la solicitud, no una cantidad final garantizada.