seo/
keyword-suggestions

Amplíe una consulta semilla dentro de un mercado de búsqueda elegido en términos de cola larga, con las palabras clave coincidentes, las métricas de demanda disponibles, el historial mensual y las filas completas de la fuente.

Keyword Suggestions API

Coincidencia con la frase semilla
Términos de cola larga
Ventanas con desplazamiento
0.1 créditos por resultado
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 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á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. El Playground usa 2840 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. 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_limitOpcionalMáximo solicitado de 1 a 1,000 sugerencias. 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 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.

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

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

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.

Explorar otras plataformas

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

Keyword Suggestions API — FAQ

Keyword Suggestions API es una interfaz programática que encuentra términos de búsqueda de cola larga a partir de una consulta semilla, un código de mercado y un código de idioma. Devuelve las palabras clave coincidentes, los detalles disponibles de demanda y competencia, el historial mensual, el contexto de intención y las filas completas de la fuente.

Las sugerencias contienen las palabras semilla enviadas con añadidos antes, después o dentro de ellas, pero el orden de las palabras puede variar. Use el endpoint para una ampliación de texto completo y no para alternativas semánticas amplias.

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 el orden de la fuente puede cambiar con el tiempo.

Los campos estables de keyword y de intención disponible se normalizan, mientras que las mediciones de búsqueda directas y las propiedades de la palabra clave pueden permanecer en extra.keyword_info y extra.keyword_properties. Los clientes deben tratar cada valor opcional como un valor que puede ser nulo.

Cada sugerencia 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.