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ámetros | Obligatorio | Descripción |
|---|---|---|
target | Obligatorio | Target 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_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 filas de palabras clave posicionadas. 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 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.
- Elija un target, 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/ranked-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/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 trueCasos 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.
APIs relacionadas
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.
- Keyword Suggestions API
- Related Keywords 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