seo/
ranked-keywords

Encuentre las palabras clave por las que un dominio, un subdominio o una página se posiciona en un mercado de búsqueda, con URL, posiciones, métricas de búsqueda, intención y contexto de tráfico estimado.

Ranked Keywords API

Target de dominio o página
Mapeo de URL posicionadas
Contexto de posición
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

Ranked Keywords

Las palabras clave posicionadas son consultas de búsqueda vinculadas a un dominio, un subdominio o una página mediante la URL de un resultado coincidente, con posiciones de grupo, absolutas y de página de resultados, además de las señales disponibles de demanda, dificultad, intención y tráfico. Estas relaciones entre consultas y páginas sirven para inventariar la visibilidad, mapear páginas de destino, revisar oportunidades y comparar instantáneas de un mismo target.

Funcionalidades de la Ranked Keywords API

  • Alcance de dominio, subdominio o páginaResuelve un target web con el formato correcto y con la amplitud necesaria para un dominio completo, un subdominio o la URL completa de una página.
  • Relaciones entre palabra clave y URLAsocia cada palabra clave devuelta con la URL de destino coincidente que expone su elemento posicionado en los resultados de búsqueda.
  • Posiciones y mediciones de palabras claveDevuelve las posiciones de grupo, absolutas y de página de resultados disponibles, junto con el volumen de búsqueda, el CPC, la competencia, la dificultad, el historial mensual y la intención.
  • Elemento coincidente completoConserva keyword_data y ranked_serp_element en extra, de modo que el tipo de resultado, el tráfico modelado y los detalles de la fuente que no se incluyen en los campos normalizados sigan disponibles.

Parámetros de la Ranked Keywords API

ParámetrosObligatorioDescripción
targetObligatorioTarget obligatorio de dominio, subdominio o página. Omita https:// y www. en un dominio, omita el protocolo en un subdominio o use una URL completa para una sola página.
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 filas de palabras clave posicionadas. 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 Ranked Keywords API

Envíe un target con el alcance correcto, con controles de mercado y una ventana de resultados acotada, y luego lea cada palabra clave posicionada en la tarea asíncrona completada.

  1. Elija un target, 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/ranked-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/ranked-keywords" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"target":"microsoft.com","location_code":2840,"language_code":"en","results_limit":5}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Casos de uso de la Ranked Keywords API

  • Inventario de visibilidad orgánica: Use el texto de las palabras clave devueltas y las URL coincidentes para catalogar dónde aparece un dominio o subdominio en el mercado de búsqueda seleccionado.
  • Mapa de posicionamiento de páginas de destino: Combine cada palabra clave, la URL de destino y el objeto rank para identificar qué página se asocia a cada posición devuelta.
  • Revisión de oportunidades de palabras clave: Compare la posición con los campos disponibles de volumen, CPC, competencia, dificultad e intención para armar una cola de revisión.
  • Comparación de instantáneas de visibilidad: Almacene las entradas de target equivalentes, collected_at, las palabras clave, las URL y las posiciones de tareas repetidas para comparar instantáneas recopiladas por separado.

Consejos de expertos para la Ranked Keywords API

  • Quite https:// y www. de un target de dominio, y quite el protocolo de un target de subdominio, para que se interprete correctamente el alcance previsto.
  • Use la URL completa de la página cuando necesite resultados a nivel de página; una ruta de página sin protocolo puede interpretarse como un target de todo el dominio.
  • Aumente offset según la cantidad de filas de la fuente que desee omitir y mantenga fijos el target, el mercado, el idioma y el límite al obtener ventanas consecutivas.
  • Trate rank.page como el número de página de resultados de búsqueda; use offset para las ventanas de la fuente y next_cursor por separado para las páginas de resultados almacenados en SocQ.
  • Lea primero las posiciones y las métricas de palabras clave normalizadas y luego revise extra.ranked_serp_element para ver el etv modelado y otros campos de la fuente que no se incluyen en los campos normalizados.
  • Arme las comparaciones históricas con tareas repetidas y elimine los duplicados de las ventanas por palabra clave, URL coincidente, mercado e idioma, porque el orden de la fuente puede cambiar.

Además de la Ranked 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.
  • 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.
  • Relevant Pages API — Inventaría las páginas indexadas de un dominio, con distribuciones de posicionamiento orgánico y de pago, tráfico modelado y contexto de costo estimado.

Explorar otras plataformas

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

Ranked Keywords API — FAQ

Ranked Keywords API es una interfaz programática que encuentra los términos de búsqueda asociados a un dominio, un subdominio o una página en un mercado e idioma seleccionados. Devuelve URL coincidentes, posiciones, mediciones de palabras clave, historial mensual, intención y los elementos completos de la fuente.

Use un dominio simple sin https:// ni www., un subdominio sin el protocolo o una URL completa para una sola página. Si se envía una ruta de página sin protocolo, el alcance puede ampliarse a todo el dominio.

No. Las posiciones describen el índice de búsqueda y el mercado seleccionados y no un resultado en vivo idéntico para todos los usuarios, por lo que conviene usar collected_at al comparar instantáneas repetidas.

rank.page es el número de página de resultados de búsqueda, offset omite filas de palabras clave de la fuente y next_cursor recorre las páginas de resultados ya almacenados para la tarea de SocQ. Estos valores no son intercambiables.

No. etv es un valor modelado que se conserva en extra.ranked_serp_element, no son analíticas privadas de tráfico ni de conversiones del target.

Cada palabra clave posicionada 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.