seo/
relevant-pages

Inventaríe las páginas indexadas de un dominio, con URL de páginas, distribuciones de posicionamiento, tráfico de búsqueda modelado y contexto de costo de la búsqueda de pago en registros normalizados.

Relevant Pages API

Visibilidad de páginas
Distribución de posicionamiento
Estimaciones de tráfico
0.15 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

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ámetrosObligatorioDescripción
targetObligatorioDominio obligatorio sin https:// ni www., como example.com.
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 registros de páginas indexadas. 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 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.

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

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

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.

Explorar otras plataformas

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

Relevant Pages API — FAQ

Relevant Pages API es una interfaz programática que encuentra las páginas indexadas con relevancia de búsqueda medible de un dominio, sin protocolo ni prefijo www. Devuelve URL de páginas, distribuciones de posicionamiento orgánico y de pago, tráfico modelado, estimaciones de costo, cantidades de movimiento y filas completas de la fuente.

Envíe un dominio como example.com sin https:// y sin www. No envíe la URL completa de una página para este inventario de dominio a nivel de página.

No. Devuelve las páginas que el índice de búsqueda conoce y que tienen relevancia orgánica o de pago medible, por lo que las páginas no indexadas y las que no tienen visibilidad medible pueden no aparecer.

La fila de la fuente puede incluir las cantidades de palabras clave orgánicas y de pago, los rangos de posiciones, el tráfico modelado, el costo estimado del tráfico de pago y las cantidades de movimiento del posicionamiento. Estos valores anidados permanecen en extra.metrics y no en el objeto metrics normalizado de nivel superior.

No. etv y los valores de costo del tráfico son estimaciones de búsqueda modeladas, no analíticas privadas, visitas observadas ni mediciones de ingresos.

Cada página devuelta cuesta 0.15 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.