Docs
Buscar documentación...⌘K

Vista general de SERP

API + MCP
GET/v3/rank-tracker/serp-overview

Las solicitudes a este endpoint son gratuitas y no consumen ninguna unidad de API.

Parámetros de consulta

top_positionsinteger

El número de posiciones orgánicas principales de la SERP que se devolverán. Si no se especifica, se devolverán todas las posiciones disponibles.

devicestringObligatorio

Elige entre rankings de móvil y escritorio.

Valores permitidos:desktopmobile
datestring

Una marca de tiempo para devolver la última Vista general de SERP disponible, en formato YYYY-MM-DDThh:mm:ss. Si no se especifica, se devuelve la Vista general de SERP más reciente.

location_idinteger

El ID de ubicación de una palabra clave rastreada. Puedes usar el endpoint management/project-keywords para obtener los códigos de país, códigos de idioma e IDs de ubicación de tus palabras clave rastreadas.

countrystringObligatorio

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

Valores permitidos:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw
language_codestring

El código de idioma de una palabra clave rastreada. Puedes usar el endpoint management/project-keywords para obtener los códigos de país, códigos de idioma e IDs de ubicación de tus palabras clave rastreadas.

keywordstringObligatorio

La palabra clave para la que se debe devolver la Vista general de SERP.

project_idintegerObligatorio

El identificador único del proyecto. Puedes encontrarlo en la URL de tu proyecto de Rank Tracker en Ahrefs: https://app.ahrefs.com/rank-tracker/overview/#project_id#

outputstring

El formato de salida.

Valores permitidos:jsoncsvxmlphp

Respuestas

positionsarray<object>
ahrefs_rankinteger or null

La solidez del perfil de backlinks de un dominio en comparación con los demás sitios web de nuestra base de datos, siendo el rango n.º 1 el más fuerte.

backlinksinteger or null

El número total de enlaces de otros sitios web que apuntan a un resultado de búsqueda.

domain_ratingnumber or null

La solidez del perfil de backlinks de un dominio en comparación con los demás sitios web de nuestra base de datos, en una escala de 100 puntos.

keywordsinteger or null

El número total de palabras clave por las que posiciona un resultado de búsqueda en las primeras 100 posiciones orgánicas.

nr_wordsinteger or null

El número total de palabras que aparecen en el HTML de una página web.

page_typestring or null

Lista separada por comas de rutas jerárquicas de tipos de página predichas por IA para la página que se posiciona. Cada valor es una ruta con prefijo de barra (p. ej., /Article/How_to).

positioninteger

La posición del resultado de búsqueda en la SERP.

refdomainsinteger or null

El número total de dominios únicos que enlazan a un resultado de búsqueda.

titlestring or null

El título de una página posicionada.

top_keywordstring or null

La palabra clave que trae más tráfico orgánico a un resultado de búsqueda.

top_keyword_volumeinteger or null

Una estimación del número medio mensual de búsquedas de la palabra clave principal durante los últimos 12 meses de datos disponibles.

trafficinteger or null

Una estimación del tráfico mensual de búsqueda orgánica que un resultado obtiene de todas las palabras clave por las que se posiciona.

typearray<string>

El tipo de posición: orgánica, de pago o de las Funcionalidades SERP. Valores permitidos: ai_overview, ai_overview_sitelink, discussion, image, image_th, knowledge_card, knowledge_panel, local_pack, organic, organic_shopping, paid_top, paid_bottom, paid_right, question, sitelink, snippet, top_story, tweet, video, video_th.

update_datestring

La fecha en la que comprobamos los resultados de búsqueda para una palabra clave.

urlstring or null

La URL de una página posicionada.

url_ratingnumber or null

La fuerza del perfil de backlinks de una página en una escala logarítmica de 100 puntos.

valueinteger or null

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