Docs
Buscar documentación...⌘K

Páginas principales

API + MCP
GET/v3/site-explorer/top-pages

Parámetros de consulta

timeoutinteger

Una duración de tiempo de espera manual en segundos.

limitinteger

El número de resultados que se devolverán.

Opción predeterminada:1000
order_bystring

Una lista separada por comas de columnas para ordenar los resultados, con dirección opcional. Consulta el schema de respuesta para ver los identificadores de columna válidos.

Example:field_a,field_b:asc,field_c:desc
wherestring

La expresión de filtro. Se reconocen los siguientes identificadores de columna (esto difiere de los identificadores que reconoce el parámetro select).

selectstringObligatorio

Una lista de columnas separadas por comas que se deben devolver. Consulta el schema de respuesta para ver los identificadores de columna válidos.

protocolstring

El protocolo de tu objetivo.

Valores permitidos:bothhttphttps
Opción predeterminada:both
targetstring (url)Obligatorio

El objetivo de la búsqueda: un dominio o una URL.

modestring

El alcance de la búsqueda según el objetivo que hayas introducido.

Valores permitidos:exactprefixdomainsubdomains
Opción predeterminada:subdomains
countrystring

Un código de país de dos letras (ISO 3166-1 alpha-2).

Valores permitidos:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw
date_comparedstring (date)

Una fecha con la que comparar las métricas, en formato YYYY-MM-DD.

datestring (date)Obligatorio

Una fecha para informar sobre las métricas en formato AAAA-MM-DD.

volume_modestring

El modo de cálculo del Volumen de búsqueda: mensual o promedio. Afecta al volumen, al tráfico y al Valor del tráfico.

Valores permitidos:monthlyaverage
Opción predeterminada:monthly
outputstring

El formato de salida.

Valores permitidos:jsoncsvxmlphp

Respuestas

pagesarray<object>
keywordsinteger or null

El número total de palabras clave para las que tu objetivo se sitúa en los 100 primeros resultados de búsqueda orgánica.

keywords_diffinteger

El cambio de las palabras clave entre las fechas seleccionadas.

keywords_diff_percentinteger

El cambio en las palabras clave entre las fechas seleccionadas, en porcentaje.

keywords_mergedinteger

El número total de palabras clave, optimizado para la ordenación.

keywords_previnteger or null

La palabra clave por la que tu objetivo estaba posicionado en la fecha de comparación.

page_typestring or null

Lista separada por comas de rutas jerárquicas del tipo de página predichas por IA. Cada valor es una ruta con barra inicial (p. ej., /Article/How_to).

raw_urlstring

La URL de la página posicionada en formato codificado.

raw_url_prevstring or null

La URL de la página posicionada en la fecha de comparación, en formato codificado.

referring_domainsinteger or null

(5 unidades) El número de dominios únicos que enlazan a una página.

statusstring

El estado de una página: la página nueva que acaba de empezar a posicionarse ("left"), la página perdida que desapareció de los resultados de búsqueda ("right"), o sin cambios ("both").

Allowed values:leftrightboth
sum_trafficinteger or null

(10 unidades) Una estimación del tráfico mensual de búsqueda orgánica que recibe una página de todas las palabras clave para las que se posiciona.

sum_traffic_mergedinteger

(10 unidades) El campo de tráfico optimizado para ordenar.

sum_traffic_previnteger or null

(10 unidades) El tráfico en la fecha de comparación.

top_keywordstring or null

La palabra clave que aporta más tráfico orgánico a una página.

top_keyword_best_positioninteger or null

La posición que ocupa una página para su palabra clave principal.

top_keyword_best_position_diffinteger or null

El cambio en la mejor posición entre las fechas seleccionadas.

top_keyword_best_position_kindstring or null

El tipo de la mejor posición: orgánica, de pago o una funcionalidad SERP.

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shopping
top_keyword_best_position_kind_prevstring or null

El tipo de la posición más alta en la fecha de comparación.

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shopping
top_keyword_best_position_previnteger or null

La posición más alta en la fecha de comparación.

top_keyword_best_position_titlestring or null

El título que se muestra para la página en la SERP de su palabra clave principal.

top_keyword_best_position_title_prevstring or null

El título que se muestra para la página en la SERP de su palabra clave principal en la fecha de comparación.

top_keyword_countrystring or null

El país en el que una página se posiciona para su palabra clave principal.

Allowed values:ADAEAFAGAIALAMAOAQARASATAUAWAXAZBABBBDBEBFBGBHBIBJBLBMBNBOBQBRBSBTBVBWBYBZCACCCDCFCGCHCICKCLCMCNCOCRCUCVCWCXCYCZDEDJDKDMDODZECEEEGEHERESETFIFJFKFMFOFRGAGBGDGEGFGGGHGIGLGMGNGPGQGRGSGTGUGWGYHKHMHNHRHTHUIDIEILIMINIOIQIRISITJEJMJOJPKEKGKHKIKMKNKPKRKWKYKZLALBLCLILKLRLSLTLULVLYMAMCMDMEMFMGMHMKMLMMMNMOMPMQMRMSMTMUMVMWMXMYMZNANCNENFNGNINLNONPNRNUNZOMOTHERPAPEPFPGPHPKPLPMPNPRPSPTPWPYQARERORSRURWSASBSCSDSESGSHSISJSKSLSMSNSOSRSSSTSVSXSYSZTCTDTFTGTHTJTKTLTMTNTOTRTTTVTWTZUAUGUMUSUYUZVAVCVEVGVIVNVUWFWSYEYTZAZMZW
top_keyword_country_prevstring or null

El país en el que una página se posiciona por su palabra clave principal en la fecha de comparación.

Allowed values:ADAEAFAGAIALAMAOAQARASATAUAWAXAZBABBBDBEBFBGBHBIBJBLBMBNBOBQBRBSBTBVBWBYBZCACCCDCFCGCHCICKCLCMCNCOCRCUCVCWCXCYCZDEDJDKDMDODZECEEEGEHERESETFIFJFKFMFOFRGAGBGDGEGFGGGHGIGLGMGNGPGQGRGSGTGUGWGYHKHMHNHRHTHUIDIEILIMINIOIQIRISITJEJMJOJPKEKGKHKIKMKNKPKRKWKYKZLALBLCLILKLRLSLTLULVLYMAMCMDMEMFMGMHMKMLMMMNMOMPMQMRMSMTMUMVMWMXMYMZNANCNENFNGNINLNONPNRNUNZOMOTHERPAPEPFPGPHPKPLPMPNPRPSPTPWPYQARERORSRURWSASBSCSDSESGSHSISJSKSLSMSNSOSRSSSTSVSXSYSZTCTDTFTGTHTJTKTLTMTNTOTRTTTVTWTZUAUGUMUSUYUZVAVCVEVGVIVNVUWFWSYEYTZAZMZW
top_keyword_prevstring or null

La palabra clave que trae más tráfico orgánico a una página en la fecha de comparación.

top_keyword_volumeinteger or null

(10 units) Una estimación del número promedio mensual de búsquedas de la palabra clave principal durante el último mes o durante los últimos 12 meses de datos disponibles, según el parámetro "volume_mode".

top_keyword_volume_previnteger or null

(10 unidades) El volumen de búsqueda en la fecha de comparación.

traffic_diffinteger

El cambio del tráfico entre las fechas seleccionadas.

traffic_diff_percentinteger

El cambio del tráfico entre las fechas seleccionadas, en porcentaje.

urnumber (float) or null

La clasificación de la URL (UR) muestra la fuerza del perfil de backlinks de la página de destino en una escala logarítmica de 100 puntos.

urlstring (url) or null

La URL de la página que se posiciona.

url_prevstring (url) or null

La URL de la página que se posiciona en la fecha de comparación.

valueinteger or null

(10 unidades) El valor estimado del tráfico de búsqueda orgánica mensual de una página, en centavos de USD.

value_diffinteger

El cambio del valor del tráfico entre las fechas seleccionadas.

value_diff_percentinteger

El cambio del Valor del tráfico entre las fechas seleccionadas, en porcentaje.

value_mergedinteger or null

(10 units) El campo de Valor del tráfico optimizado para la ordenación.

value_previnteger or null

(10 units) El Valor del tráfico en la fecha de comparación.