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

cpc
type: integer nullable

cpc_prev: La métrica de CPC en la fecha de comparación.
type: integer nullable

has_thumbnail: La posición tiene una miniatura.
type: boolean

has_thumbnail_prev: La posición tiene una miniatura en la fecha de comparación.
type: boolean

has_video: La posición tiene un vídeo.
type: boolean

has_video_prev: La posición tiene un vídeo en la fecha de comparación.
type: boolean

keyword: La palabra clave por la que tu destino posiciona.
type: string

keyword_difficulty (10 units): Una estimación de lo difícil que es posicionar en el top 10 de los resultados de búsqueda orgánica para una palabra clave en una escala de 100 puntos.
type: integer nullable

keyword_difficulty_prev (10 units): La Dificultad de palabra clave en la fecha de comparación.
type: integer nullable

keyword_prev: La palabra clave por la que tu destino posicionaba en la fecha de comparación.
type: string

keywords: El número total de palabras clave por las que tu destino posiciona en el top 100 de resultados de búsqueda orgánica.
type: integer

keywords_diff: El cambio en palabras clave entre las fechas seleccionadas.
type: integer

keywords_diff_percent: El cambio en palabras clave entre las fechas seleccionadas, en porcentajes.
type: integer

keywords_merged: El total de palabras clave optimizado para ordenar.
type: integer

keywords_prev: La palabra clave por la que tu destino posicionaba en la fecha de comparación.
type: integer

page_type: Lista separada por comas de rutas jerárquicas de tipo de página predichas por IA. Cada valor es una ruta con prefijo de barra (p. ej., /Article/How_to).
type: string nullable

position: La posición por la que tu destino posiciona en los resultados de búsqueda orgánica para una palabra clave.
type: integer

position_kind: El tipo de una posición: orgánica, de pago o una funcionalidad SERP. Esto se aplica a todas las posiciones para una palabra clave y URL determinadas antes de elegir la mejor posición.
type: string
enum: \"paid_top\" \"paid_bottom\" \"paid_right\" \"paid_sitelink\" \"organic\" \"sitelink\" \"snippet\" \"image\" \"article\" \"knowledge_card\" \"knowledge_panel\" \"local_pack\" \"local_teaser\" \"news\" \"question\" \"review\" \"shopping\" \"tweet\" \"spelling\" \"video\" \"discussion\" \"ai_overview\" \"ai_overview_sitelink\" \"organic_shopping\"

position_kind_prev: El tipo de una posición en la fecha de comparación.
type: string
enum: \"paid_top\" \"paid_bottom\" \"paid_right\" \"paid_sitelink\" \"organic\" \"sitelink\" \"snippet\" \"image\" \"article\" \"knowledge_card\" \"knowledge_panel\" \"local_pack\" \"local_teaser\" \"news\" \"question\" \"review\" \"shopping\" \"tweet\" \"spelling\" \"video\" \"discussion\" \"ai_overview\" \"ai_overview_sitelink\" \"organic_shopping\"

position_prev: La posición de tu destino para una palabra clave determinada en la fecha de comparación.
type: integer

raw_url: La URL de la página que posiciona en formato codificado.
type: string

raw_url_prev: La URL de la página que posicionaba en la fecha de comparación en formato codificado.
type: string

referring_domains (5 units): El número de dominios únicos que enlazan a una página.
type: integer nullable

serp_features
type: array(string)
enum: \"paid_top\" \"paid_bottom\" \"paid_right\" \"paid_sitelink\" \"organic\" \"sitelink\" \"snippet\" \"image\" \"article\" \"knowledge_card\" \"knowledge_panel\" \"local_pack\" \"local_teaser\" \"news\" \"question\" \"review\" \"shopping\" \"tweet\" \"spelling\" \"video\" \"discussion\" \"ai_overview\" \"ai_overview_sitelink\" \"organic_shopping\" \"image_th\" \"video_th\" \"ai_overview_found\"

serp_features_prev: Las Funcionalidades SERP en la fecha de comparación.
type: array(string)
enum: \"paid_top\" \"paid_bottom\" \"paid_right\" \"paid_sitelink\" \"organic\" \"sitelink\" \"snippet\" \"image\" \"article\" \"knowledge_card\" \"knowledge_panel\" \"local_pack\" \"local_teaser\" \"news\" \"question\" \"review\" \"shopping\" \"tweet\" \"spelling\" \"video\" \"discussion\" \"ai_overview\" \"ai_overview_sitelink\" \"organic_shopping\" \"image_th\" \"video_th\" \"ai_overview_found\"

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

sum_traffic (10 units): Una estimación del Tráfico orgánico mensual de búsqueda que una página obtiene de todas las palabras clave por las que posiciona.
type: integer nullable

sum_traffic_merged (10 units): El campo de tráfico optimizado para ordenar.
type: integer

sum_traffic_prev (10 units): El tráfico en la fecha de comparación.
type: integer nullable

top_keyword: La palabra clave que aporta más Tráfico orgánico a una página.
type: string nullable

top_keyword_best_position: La posición de ranking que una página ocupa para su palabra clave principal.
type: integer nullable

top_keyword_best_position_diff: El cambio en la mejor posición entre las fechas seleccionadas.
type: integer nullable

top_keyword_best_position_kind: El tipo de la mejor posición: orgánica, de pago o una funcionalidad SERP.
type: string nullable
enum: \"paid_top\" \"paid_bottom\" \"paid_right\" \"paid_sitelink\" \"organic\" \"sitelink\" \"snippet\" \"image\" \"article\" \"knowledge_card\" \"knowledge_panel\" \"local_pack\" \"local_teaser\" \"news\" \"question\" \"review\" \"shopping\" \"tweet\" \"spelling\" \"video\" \"discussion\" \"ai_overview\" \"ai_overview_sitelink\" \"organic_shopping\"

top_keyword_best_position_kind_prev: El tipo de la mejor posición en la fecha de comparación.
type: string nullable
enum: \"paid_top\" \"paid_bottom\" \"paid_right\" \"paid_sitelink\" \"organic\" \"sitelink\" \"snippet\" \"image\" \"article\" \"knowledge_card\" \"knowledge_panel\" \"local_pack\" \"local_teaser\" \"news\" \"question\" \"review\" \"shopping\" \"tweet\" \"spelling\" \"video\" \"discussion\" \"ai_overview\" \"ai_overview_sitelink\" \"organic_shopping\"

top_keyword_best_position_prev: La mejor posición en la fecha de comparación.
type: integer nullable

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

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

top_keyword_country: El país en el que una página posiciona por su palabra clave principal.
type: string nullable
enum: \"AD\" \"AE\" \"AF\" \"AG\" \"AI\" \"AL\" \"AM\" \"AO\" \"AQ\" \"AR\" \"AS\" \"AT\" \"AU\" \"AW\" \"AX\" \"AZ\" \"BA\" \"BB\" \"BD\" \"BE\" \"BF\" \"BG\" \"BH\" \"BI\" \"BJ\" \"BL\" \"BM\" \"BN\" \"BO\" \"BQ\" \"BR\" \"BS\" \"BT\" \"BV\" \"BW\" \"BY\" \"BZ\" \"CA\" \"CC\" \"CD\" \"CF\" \"CG\" \"CH\" \"CI\" \"CK\" \"CL\" \"CM\" \"CN\" \"CO\" \"CR\" \"CU\" \"CV\" \"CW\" \"CX\" \"CY\" \"CZ\" \"DE\" \"DJ\" \"DK\" \"DM\" \"DO\" \"DZ\" \"EC\" \"EE\" \"EG\" \"EH\" \"ER\" \"ES\" \"ET\" \"FI\" \"FJ\" \"FK\" \"FM\" \"FO\" \"FR\" \"GA\" \"GB\" \"GD\" \"GE\" \"GF\" \"GG\" \"GH\" \"GI\" \"GL\" \"GM\" \"GN\" \"GP\" \"GQ\" \"GR\" \"GS\" \"GT\" \"GU\" \"GW\" \"GY\" \"HK\" \"HM\" \"HN\" \"HR\" \"HT\" \"HU\" \"ID\" \"IE\" \"IL\" \"IM\" \"IN\" \"IO\" \"IQ\" \"IR\" \"IS\" \"IT\" \"JE\" \"JM\" \"JO\" \"JP\" \"KE\" \"KG\" \"KH\" \"KI\" \"KM\" \"KN\" \"KP\" \"KR\" \"KW\" \"KY\" \"KZ\" \"LA\" \"LB\" \"LC\" \"LI\" \"LK\" \"LR\" \"LS\" \"LT\" \"LU\" \"LV\" \"LY\" \"MA\" \"MC\" \"MD\" \"ME\" \"MF\" \"MG\" \"MH\" \"MK\" \"ML\" \"MM\" \"MN\" \"MO\" \"MP\" \"MQ\" \"MR\" \"MS\" \"MT\" \"MU\" \"MV\" \"MW\" \"MX\" \"MY\" \"MZ\" \"NA\" \"NC\" \"NE\" \"NF\" \"NG\" \"NI\" \"NL\" \"NO\" \"NP\" \"NR\" \"NU\" \"NZ\" \"OM\" \"OTHER\" \"PA\" \"PE\" \"PF\" \"PG\" \"PH\" \"PK\" \"PL\" \"PM\" \"PN\" \"PR\" \"PS\" \"PT\" \"PW\" \"PY\" \"QA\" \"RE\" \"RO\" \"RS\" \"RU\" \"RW\" \"SA\" \"SB\" \"SC\" \"SD\" \"SE\" \"SG\" \"SH\" \"SI\" \"SJ\" \"SK\" \"SL\" \"SM\" \"SN\" \"SO\" \"SR\" \"SS\" \"ST\" \"SV\" \"SX\" \"SY\" \"SZ\" \"TC\" \"TD\" \"TF\" \"TG\" \"TH\" \"TJ\" \"TK\" \"TL\" \"TM\" \"TN\" \"TO\" \"TR\" \"TT\" \"TV\" \"TW\" \"TZ\" \"UA\" \"UG\" \"UM\" \"US\" \"UY\" \"UZ\" \"VA\" \"VC\" \"VE\" \"VG\" \"VI\" \"VN\" \"VU\" \"WF\" \"WS\" \"YE\" \"YT\" \"ZA\" \"ZM\" \"ZW\"

top_keyword_country_prev: El país en el que una página posicionaba por su palabra clave principal en la fecha de comparación.
type: string nullable
enum: \"AD\" \"AE\" \"AF\" \"AG\" \"AI\" \"AL\" \"AM\" \"AO\" \"AQ\" \"AR\" \"AS\" \"AT\" \"AU\" \"AW\" \"AX\" \"AZ\" \"BA\" \"BB\" \"BD\" \"BE\" \"BF\" \"BG\" \"BH\" \"BI\" \"BJ\" \"BL\" \"BM\" \"BN\" \"BO\" \"BQ\" \"BR\" \"BS\" \"BT\" \"BV\" \"BW\" \"BY\" \"BZ\" \"CA\" \"CC\" \"CD\" \"CF\" \"CG\" \"CH\" \"CI\" \"CK\" \"CL\" \"CM\" \"CN\" \"CO\" \"CR\" \"CU\" \"CV\" \"CW\" \"CX\" \"CY\" \"CZ\" \"DE\" \"DJ\" \"DK\" \"DM\" \"DO\" \"DZ\" \"EC\" \"EE\" \"EG\" \"EH\" \"ER\" \"ES\" \"ET\" \"FI\" \"FJ\" \"FK\" \"FM\" \"FO\" \"FR\" \"GA\" \"GB\" \"GD\" \"GE\" \"GF\" \"GG\" \"GH\" \"GI\" \"GL\" \"GM\" \"GN\" \"GP\" \"GQ\" \"GR\" \"GS\" \"GT\" \"GU\" \"GW\" \"GY\" \"HK\" \"HM\" \"HN\" \"HR\" \"HT\" \"HU\" \"ID\" \"IE\" \"IL\" \"IM\" \"IN\" \"IO\" \"IQ\" \"IR\" \"IS\" \"IT\" \"JE\" \"JM\" \"JO\" \"JP\" \"KE\" \"KG\" \"KH\" \"KI\" \"KM\" \"KN\" \"KP\" \"KR\" \"KW\" \"KY\" \"KZ\" \"LA\" \"LB\" \"LC\" \"LI\" \"LK\" \"LR\" \"LS\" \"LT\" \"LU\" \"LV\" \"LY\" \"MA\" \"MC\" \"MD\" \"ME\" \"MF\" \"MG\" \"MH\" \"MK\" \"ML\" \"MM\" \"MN\" \"MO\" \"MP\" \"MQ\" \"MR\" \"MS\" \"MT\" \"MU\" \"MV\" \"MW\" \"MX\" \"MY\" \"MZ\" \"NA\" \"NC\" \"NE\" \"NF\" \"NG\" \"NI\" \"NL\" \"NO\" \"NP\" \"NR\" \"NU\" \"NZ\" \"OM\" \"OTHER\" \"PA\" \"PE\" \"PF\" \"PG\" \"PH\" \"PK\" \"PL\" \"PM\" \"PN\" \"PR\" \"PS\" \"PT\" \"PW\" \"PY\" \"QA\" \"RE\" \"RO\" \"RS\" \"RU\" \"RW\" \"SA\" \"SB\" \"SC\" \"SD\" \"SE\" \"SG\" \"SH\" \"SI\" \"SJ\" \"SK\" \"SL\" \"SM\" \"SN\" \"SO\" \"SR\" \"SS\" \"ST\" \"SV\" \"SX\" \"SY\" \"SZ\" \"TC\" \"TD\" \"TF\" \"TG\" \"TH\" \"TJ\" \"TK\" \"TL\" \"TM\" \"TN\" \"TO\" \"TR\" \"TT\" \"TV\" \"TW\" \"TZ\" \"UA\" \"UG\" \"UM\" \"US\" \"UY\" \"UZ\" \"VA\" \"VC\" \"VE\" \"VG\" \"VI\" \"VN\" \"VU\" \"WF\" \"WS\" \"YE\" \"YT\" \"ZA\" \"ZM\" \"ZW\"

top_keyword_prev: La palabra clave que aportaba más Tráfico orgánico a una página en la fecha de comparación.
type: string nullable

top_keyword_volume (10 units): Una estimación del número medio mensual de búsquedas para la palabra clave principal durante el último mes o durante los últimos 12 meses de datos conocidos, dependiendo del parámetro "volume_mode".
type: integer nullable

top_keyword_volume_prev (10 units): El Volumen de búsqueda en la fecha de comparación.
type: integer nullable

traffic (10 units): Una estimación del número de visitantes mensuales que tu destino obtiene desde búsqueda orgánica para una palabra clave.
type: integer

traffic_diff: El cambio de tráfico entre las fechas seleccionadas.
type: integer

traffic_diff_percent: El cambio de tráfico entre las fechas seleccionadas, en porcentajes.
type: integer

traffic_prev (10 units): El tráfico de una palabra clave en la fecha de comparación.
type: integer

ur: URL Rating (UR) muestra la fuerza del perfil de Backlinks de tu página de destino en una escala logarítmica de 100 puntos.
type: float nullable

url: La URL de la página que posiciona.
type: url nullable

url_prev: La URL de la página que posicionaba en la fecha de comparación.
type: url nullable

value (10 units): El valor estimado del tráfico mensual de búsqueda orgánica de una página, en centavos de USD.
type: integer nullable

value_diff: El cambio en el Valor del tráfico entre las fechas seleccionadas.
type: integer

value_diff_percent: El cambio en el Valor del tráfico entre las fechas seleccionadas, en porcentajes.
type: integer

value_merged (10 units): El campo de Valor del tráfico optimizado para ordenar.
type: integer nullable

value_prev (10 units): El Valor del tráfico en la fecha de comparación.
type: integer nullable

volume (10 units): Una estimación del número de búsquedas de una palabra clave durante el último mes.
type: integer nullable

volume_prev (10 units): El Volumen de búsqueda en la fecha de comparación.
type: integer nullable

words: El número de palabras en una palabra clave.
type: integer

words_prev: El número de palabras en una palabra clave en la fecha de comparación.
type: integer

selectstringObligatorio

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

protocolstring

El protocolo de tu objetivo.

Valores permitidos:bothhttphttps

Opción predeterminada:both

targetstringObligatorio

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

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

datestringObligatorio

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.

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.

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 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 or null

La URL de la página que se posiciona.

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