Docs
Buscar documentación...⌘K

Vista general

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

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

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 del filtro. Se reconocen los siguientes identificadores de columna (esto difiere de los identificadores reconocidos por 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.

date_comparedstring (date)

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

datestring (date)Obligatorio

Fecha para la que se informarán las métricas, en formato AAAA-MM-DD.

devicestringObligatorio

Elige entre rankings de móvil y escritorio.

Valores permitidos:desktopmobile
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#

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

overviewsarray<object>
best_position_has_thumbnailboolean or null

La mejor posición (o la de la URL objetivo, si se ha configurado) tiene una miniatura.

best_position_has_thumbnail_previousboolean or null

La mejor posición (o la de la URL objetivo, si se ha configurado) tiene una miniatura en la fecha de comparación.

best_position_has_video_previewboolean or null

La mejor posición (o la de la URL objetivo, si se ha configurado) tiene una vista previa de vídeo.

best_position_has_video_preview_previousboolean or null

La mejor posición (o la de la URL objetivo, si se ha configurado) tiene una vista previa de vídeo en la fecha de comparación.

best_position_kindstring or null

El tipo de la mejor posición (o la de la URL objetivo, si se ha configurado): orgánica, de pago o una funcionalidad de la SERP.

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shopping
best_position_kind_previousstring or null

El tipo de mejor posición (o el de las URL objetivo, si se han configurado) en la fecha de comparación.

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shopping
clicksinteger or null

La métrica de clics indica el promedio mensual de clics en los resultados de búsqueda que se realizan al buscar la palabra clave objetivo. Algunas búsquedas generan clics en varios resultados, mientras que es posible que otras no terminen en ningún clic.

clicks_per_searchnumber (float) or null

Clics por búsqueda es la relación entre el número de clics y el volumen de búsqueda de la palabra clave. Muestra cuántos resultados de búsqueda diferentes reciben clics, de promedio, cuando las personas buscan la palabra clave de destino en un país determinado.

cost_per_clickinteger or null

El coste por clic muestra el precio promedio que los anunciantes pagan por cada clic en un resultado de búsqueda de pago para una palabra clave.

countrystring

El país en el que se realiza el seguimiento de una palabra clave determinada. Código de país de dos letras (ISO 3166-1 alfa-2).

Allowed values:ADAEAFAGAIALAMAOAQARASATAUAWAXAZBABBBDBEBFBGBHBIBJBLBMBNBOBQBRBSBTBVBWBYBZCACCCDCFCGCHCICKCLCMCNCOCRCUCVCWCXCYCZDEDJDKDMDODZECEEEGEHERESETFIFJFKFMFOFRGAGBGDGEGFGGGHGIGLGMGNGPGQGRGSGTGUGWGYHKHMHNHRHTHUIDIEILIMINIOIQIRISITJEJMJOJPKEKGKHKIKMKNKPKRKWKYKZLALBLCLILKLRLSLTLULVLYMAMCMDMEMFMGMHMKMLMMMNMOMPMQMRMSMTMUMVMWMXMYMZNANCNENFNGNINLNONPNRNUNZOMOTHERPAPEPFPGPHPKPLPMPNPRPSPTPWPYQARERORSRURWSASBSCSDSESGSHSISJSKSLSMSNSOSRSSSTSVSXSYSZTCTDTFTGTHTJTKTLTMTNTOTRTTTVTWTZUAUGUMUSUYUZVAVCVEVGVIVNVUWFWSYEYTZAZMZW
country_prevstring

El país en el que se realiza el seguimiento de una palabra clave determinada en la fecha de comparación. Código de país de dos letras (ISO 3166-1 alfa-2).

Allowed values:ADAEAFAGAIALAMAOAQARASATAUAWAXAZBABBBDBEBFBGBHBIBJBLBMBNBOBQBRBSBTBVBWBYBZCACCCDCFCGCHCICKCLCMCNCOCRCUCVCWCXCYCZDEDJDKDMDODZECEEEGEHERESETFIFJFKFMFOFRGAGBGDGEGFGGGHGIGLGMGNGPGQGRGSGTGUGWGYHKHMHNHRHTHUIDIEILIMINIOIQIRISITJEJMJOJPKEKGKHKIKMKNKPKRKWKYKZLALBLCLILKLRLSLTLULVLYMAMCMDMEMFMGMHMKMLMMMNMOMPMQMRMSMTMUMVMWMXMYMZNANCNENFNGNINLNONPNRNUNZOMOTHERPAPEPFPGPHPKPLPMPNPRPSPTPWPYQARERORSRURWSASBSCSDSESGSHSISJSKSLSMSNSOSRSSSTSVSXSYSZTCTDTFTGTHTJTKTLTMTNTOTRTTTVTWTZUAUGUMUSUYUZVAVCVEVGVIVNVUWFWSYEYTZAZMZW
created_atstring (date-time)

La fecha en la que una palabra clave se añadió al proyecto.

is_brandedboolean

Intención del usuario: de marca. El usuario está buscando una marca o nombre de empresa específicos.

is_commercialboolean

Intención del usuario: comercial. El usuario está comparando productos o servicios antes de tomar una decisión de compra.

is_informationalboolean

Intención del usuario: informativa. El usuario está buscando información o la respuesta a una pregunta específica.

is_localboolean

Intención del usuario: local. El usuario está buscando información relevante para una ubicación específica o servicios cercanos.

is_navigationalboolean

Intención del usuario: navegacional. El usuario está buscando un sitio web o una página web específica.

is_transactionalboolean

Intención del usuario: transaccional. El usuario está listo para completar una acción, a menudo una compra.

keywordstring

La palabra clave por la que tu objetivo está posicionado.

keyword_difficultyinteger or null

Una estimación de la dificultad de posicionarse en los 10 primeros resultados de búsqueda orgánica para una palabra clave determinada, en una escala de 100 puntos.

keyword_has_databoolean

Devolverá false si la palabra clave aún se está procesando y todavía no se ha obtenido ninguna SERP.

keyword_is_frozenboolean

Indica si una palabra clave ha superado el límite de palabras clave en seguimiento de tu plan. Estas palabras clave quedan "congeladas", lo que significa que no se actualizan sus posiciones.

keyword_prevstring

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

languagestring

El idioma de la SERP para el que se realiza el seguimiento de una palabra clave determinada.

language_prevstring

El idioma de la SERP en la fecha de comparación.

locationstring

La ubicación (país, estado/provincia o ciudad) en la que se realiza el seguimiento de una palabra clave determinada.

location_prevstring

La ubicación (país, estado/provincia o ciudad) en la que se realiza el seguimiento de una palabra clave determinada en la fecha de comparación.

parent_topicstring or null

El tema principal determina si puede posicionarse tu palabra clave objetivo mientras se dirige a un tema más general en tu página. Para identificar el tema principal, tomamos la página mejor posicionada para tu palabra clave y encontramos la palabra clave responsable de enviar la mayor parte del tráfico a esa página.

positioninteger or null

La mejor posición (o la de las URL objetivo, si se han configurado) en la búsqueda orgánica.

position_diffinteger or null

El cambio en la mejor posición (o la de las URL objetivo, si se han configurado) entre las fechas seleccionadas.

position_previnteger or null

La mejor posición (o la de las URL objetivo, si se han configurado) en la fecha de comparación.

search_type_imagenumber (float) or null

El tipo de búsqueda Imagen muestra el porcentaje de búsquedas de una palabra clave realizadas para imágenes, lo que destaca el interés en el contenido visual.

search_type_newsnumber (float) or null

El tipo de búsqueda Noticias muestra el porcentaje de búsquedas de una palabra clave realizadas para artículos de noticias.

search_type_videonumber (float) or null

El tipo de búsqueda Vídeo muestra el porcentaje de búsquedas de una palabra clave realizadas para vídeos, lo que refleja el interés en el contenido de vídeo.

search_type_webnumber (float) or null

El tipo de búsqueda Web muestra el porcentaje de búsquedas de una palabra clave realizadas para contenido web general, lo que indica interés en una amplia gama de información.

serp_featuresarray<string>

Las funcionalidades de SERP que aparecen en los resultados de búsqueda para una palabra clave.

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shoppingimage_thvideo_thai_overview_found
serp_features_prevarray<string>

Las funcionalidades SERP que aparecen en los resultados de búsqueda para una palabra clave en la fecha de comparación.

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shoppingimage_thvideo_thai_overview_found
serp_updatedstring (date-time) or null

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

serp_updated_prevstring (date-time) or null

La fecha en la que comprobamos los resultados de búsqueda hasta la fecha de comparación.

tagsarray<string>

Una lista de etiquetas asignadas a una palabra clave determinada.

tags_prevarray<string>

Una lista de etiquetas asignadas a una palabra clave en la fecha de comparación.

target_positions_countinteger

El número de URL objetivo que se posicionan para una palabra clave.

trafficinteger or null

Una estimación del número de visitas mensuales que recibe una página desde la búsqueda orgánica durante el último mes o durante los últimos 12 meses de datos disponibles, según el parámetro "volume_mode".

traffic_diffinteger or null

El cambio del tráfico entre las fechas seleccionadas.

traffic_previnteger or null

Una estimación del número de visitas mensuales que recibe una página desde la búsqueda orgánica durante el último mes o durante los últimos 12 meses de datos disponibles, según el parámetro "volume_mode".

urlstring (url) or null

La URL mejor posicionada (o la URL objetivo, si se ha configurado) en la búsqueda orgánica.

url_prevstring (url) or null

La URL mejor posicionada (o la URL objetivo, si se ha configurado) en la fecha de comparación.

volumeinteger or null

Una estimación del número medio mensual de búsquedas de una palabra clave durante el último mes o durante los últimos 12 meses de datos disponibles, según el parámetro "volume_mode".

volume_desktop_pctnumber (float) or null

El porcentaje del volumen de búsqueda total que proviene de dispositivos de escritorio.

volume_mobile_pctnumber (float) or null

El porcentaje del volumen de búsqueda total que proviene de dispositivos móviles.