Relevant Pages
Las páginas relevantes son URL indexadas con visibilidad de búsqueda orgánica o de pago medible, que incluyen cantidades de palabras clave, rangos de posiciones, tráfico modelado, estimaciones de costo y señales de movimiento. Estas mediciones a nivel de página sirven para inventariar la visibilidad, comparar huellas, revisar el valor del tráfico y analizar instantáneas repetidas.
Funcionalidades de la Relevant Pages API
- Inventario de páginas a nivel de dominioDevuelve las URL absolutas de las páginas de un dominio que tienen relevancia orgánica o de pago medible en el índice de búsqueda seleccionado.
- Distribución del posicionamiento orgánicoConserva las cantidades de palabras clave orgánicas por rango de posiciones, junto con las cantidades de posiciones nuevas, en ascenso, en descenso y perdidas cuando están disponibles.
- Huella de búsqueda de pagoExpone, para cada página, las cantidades de palabras clave de pago disponibles, los rangos de posiciones, el tráfico modelado y el costo estimado del tráfico de pago.
- Objetos de métricas de página completosMantiene en extra las mediciones anidadas orgánicas, de pago y otras mediciones variables a nivel de página, y normaliza la URL de la página para una identificación estable.
Parámetros de la Relevant Pages API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
target | Obligatorio | Dominio obligatorio sin https:// ni www., como example.com. |
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 registros de páginas indexadas. 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 Relevant Pages API
Envíe un dominio con el formato correcto, con controles de mercado y una ventana de la fuente acotada, y luego lea cada página relevante en la tarea asíncrona completada.
- Elija un dominio sin https:// ni www., 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/relevant-pages 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/relevant-pages" \
-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 Relevant Pages API
- Inventario de páginas visibles en la búsqueda: Use las URL de páginas devueltas para armar un inventario del dominio limitado a las páginas con relevancia de búsqueda indexada medible.
- Comparación de la huella orgánica: Compare las cantidades de palabras clave orgánicas, los rangos de posicionamiento y los campos de movimiento para identificar cómo se distribuye la visibilidad entre las páginas.
- Revisión de páginas en la búsqueda de pago: Use las cantidades de palabras clave de pago, los rangos de posiciones, el tráfico modelado y el costo estimado para comparar la huella de pago de las páginas devueltas.
- Instantáneas de visibilidad de páginas: Almacene los registros repetidos por page_address y mercado para comparar las distribuciones de posicionamiento y el tráfico modelado entre distintos momentos de recopilación.
Consejos de expertos para la Relevant Pages API
- Quite https:// y www. de target antes del envío, porque este endpoint espera un dominio y no la URL completa de una página.
- Use la url devuelta como identificador de la página; text es la misma URL como alternativa y no contiene el contenido del cuerpo de la página.
- Mantenga fijos target, location_code, language_code, results_limit y offset al comparar ventanas de resultados repetidas.
- Trate offset como una cantidad de filas de la fuente y no como un número de página, y almacénelo por separado del next_cursor de los resultados de la tarea.
- Lea las mediciones orgánicas y de pago en extra.metrics, y admita que los grupos de métricas anidados o los campos individuales puedan faltar.
- Interprete etv y estimated_paid_traffic_cost como estimaciones de búsqueda modeladas y no como analíticas privadas ni ingresos observados.
APIs relacionadas
Además de la Relevant Pages 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.
- Ranked Keywords API — Encuentra las palabras clave para las que se posiciona un dominio, subdominio o página, con las URLs correspondientes, posiciones, mediciones de búsqueda, intención y elementos de origen completos.
- 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