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

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

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

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

best_position_has_video_preview_previous: 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.
type: boolean nullable

best_position_kind: 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.
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"

best_position_kind_previous: El tipo de la mejor posición (o la de la URL objetivo, si se ha configurado) 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"

clicks: La métrica Clics se refiere al número medio mensual de clics en los resultados de búsqueda que la gente realiza al buscar la palabra clave objetivo. Algunas búsquedas generan clics en varios resultados, mientras que otras pueden no terminar en ningún clic.
type: integer nullable

clicks_per_search: Clics por búsqueda es la relación entre Clics y el Volumen de búsqueda de la palabra clave. Muestra cuántos resultados de búsqueda diferentes reciben clic, de media, cuando la gente busca la palabra clave objetivo en un país determinado.
type: float nullable

cost_per_click: Coste por clic muestra el precio medio que pagan los anunciantes por cada clic en anuncios de los resultados de búsqueda de pago para una palabra clave.
type: integer nullable

country: El país en el que se está rastreando una palabra clave. Un código de país de dos letras (ISO 3166-1 alfa-2).
type: string
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"

country_prev: El país en el que se estaba rastreando una palabra clave en la fecha de comparación. Un código de país de dos letras (ISO 3166-1 alfa-2).
type: string
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"

created_at: La fecha en que se añadió una palabra clave al Proyecto.
type: datetime

is_branded: Intención del usuario: de marca. El usuario busca una marca específica o el nombre de una empresa.
type: boolean

is_commercial: Intención del usuario: comercial. El usuario compara productos o servicios antes de tomar una decisión de compra.
type: boolean

is_informational: Intención del usuario: informativa. El usuario busca información o la respuesta a una pregunta concreta.
type: boolean

is_local: Intención del usuario: local. El usuario busca información relevante para una ubicación concreta o servicios cercanos.
type: boolean

is_main_position: Excluye posiciones en AI Overview, Sitelinks, Top stories, Image packs, Videos, Discussions and forums, y publicaciones en X (Twitter).
type: boolean

is_main_position_prev: Excluye posiciones en AI Overview, Sitelinks, Top stories, Image packs, Videos, Discussions and forums, y publicaciones en X (Twitter) en la fecha de comparación.
type: boolean

is_navigational: Intención del usuario: de navegación. El usuario busca un sitio web o una página web concretos.
type: boolean

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

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

keyword_difficulty: Una estimación de lo difícil que es posicionarse en los 10 primeros resultados orgánicos de búsqueda para una palabra clave en una escala de 100 puntos.
type: integer nullable

keyword_has_data: Devuelve false si la palabra clave aún se está procesando y todavía no se ha obtenido ninguna SERP.
type: boolean

keyword_is_frozen: Indica si una palabra clave ha superado el límite de palabras clave rastreadas de tu plan. Esas palabras clave quedan "congeladas", lo que significa que no se actualizan sus posiciones.
type: boolean

keyword_prev: La palabra clave por la que se posiciona tu objetivo en la fecha de comparación.
type: string

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

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

language: El idioma de la SERP para el que se está rastreando una palabra clave.
type: string

language_prev: El idioma de la SERP en la fecha de comparación.
type: string

location: La ubicación (país, estado/provincia o ciudad) en la que se está rastreando una palabra clave.
type: string

location_prev: La ubicación (país, estado/provincia o ciudad) en la que se estaba rastreando una palabra clave en la fecha de comparación.
type: string

parent_topic: Tema principal determina si puedes posicionarte para tu palabra clave objetivo mientras apuntas a un tema más general en tu página. Para identificar el Tema principal, tomamos la página #1 posicionada para tu palabra clave y encontramos la palabra clave responsable de enviar la mayor cantidad de tráfico a esa página.
type: string nullable

position: La mejor posición (o la de la URL objetivo, si se ha configurado) en la búsqueda orgánica.
type: integer nullable

position_diff: El cambio en la mejor posición (o la de la URL objetivo, si se ha configurado) entre las fechas seleccionadas.
type: integer nullable

position_prev: La mejor posición (o la de la URL objetivo, si se ha configurado) en la fecha de comparación.
type: integer nullable

search_type_image: El tipo de búsqueda Imagen muestra el porcentaje de búsquedas de una palabra clave que se realizan en imágenes, lo que refleja el interés por contenido visual.
type: float nullable

search_type_news: El tipo de búsqueda Noticias muestra el porcentaje de búsquedas de una palabra clave que se realizan en artículos de noticias.
type: float nullable

search_type_video: El tipo de búsqueda Vídeo muestra el porcentaje de búsquedas de una palabra clave que se realizan en vídeo, lo que refleja el interés por contenido en vídeo.
type: float nullable

search_type_web: El tipo de búsqueda Web muestra el porcentaje de búsquedas de una palabra clave que se realizan en contenido web general, lo que indica interés por una amplia variedad de información.
type: float nullable

serp_features: Las Funcionalidades SERP que aparecen en los resultados de búsqueda de una palabra clave.
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 que aparecen en los resultados de búsqueda de una palabra clave 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"

serp_updated: La fecha en la que comprobamos por última vez los resultados del motor de búsqueda para una palabra clave.
type: datetime nullable

serp_updated_prev: La fecha en la que comprobamos los resultados del motor de búsqueda hasta la fecha de comparación.
type: datetime nullable

tags: Una lista de etiquetas asignadas a una palabra clave.
type: array(string)

tags_prev: Una lista de etiquetas asignadas a una palabra clave en la fecha de comparación.
type: array(string)

target_positions_count: El número de URL objetivo que se posicionan para una palabra clave.
type: integer

traffic: 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 conocidos de datos, según el parámetro "volume_mode".
type: integer nullable

traffic_diff: El cambio en el tráfico entre las fechas seleccionadas.
type: integer nullable

traffic_prev: 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 conocidos de datos, según el parámetro "volume_mode".
type: integer nullable

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

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

volume: 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 conocidos de datos, según el parámetro "volume_mode".
type: integer nullable

volume_desktop_pct: El porcentaje del Volumen de búsqueda total que procede de dispositivos de escritorio.
type: float nullable

volume_mobile_pct: El porcentaje del Volumen de búsqueda total que procede de dispositivos móviles.
type: float nullable

selectstringObligatorio

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

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.

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.

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

created_atstring

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

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.

serp_updatedstring or null

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

serp_updated_prevstring 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

urlstring or null

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

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

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

volume_mobile_pctnumber or null

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