Docs
Buscar documentación...⌘K

Impresiones

API + MCP
GET/v3/brand-radar/impressions-history

Las solicitudes a este endpoint consumen unidades de API en función del parámetro prompts: las solicitudes que devuelven solo datos de prompt personalizado son gratuitas, mientras que las solicitudes que incluyen datos de prompt de Ahrefs siguen el precio estándar de unidades de API.

Parámetros de consulta

wherestring

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

report_idstring

El ID del informe que se utilizará. Si se proporciona uno, los demás parámetros se toman del informe (país, filtros). Si se proporcionan país o filtros, prevalecen sobre los del informe. Puedes encontrarlo en la URL de tu informe de Brand Radar en Ahrefs: https://app.ahrefs.com/brand-radar/reports/#report_id#/...

brandstringObligatorio

La marca que se buscará.

data_sourcestringObligatorio

Una lista separada por comas de modelos de chatbot. Todos los modelos pueden combinarse entre sí. El módulo claude solo admite prompts personalizados.
Los modelos google_ai_overviews_keywords y google_ai_mode_keywords informan sobre la visibilidad de AI Overviews / modo IA derivada de consultas de búsqueda de Google (palabras clave) y no de prompts.

Valores permitidos:chatgptgoogle_ai_overviewsgoogle_ai_modegeminiperplexitycopilotclaudegrokgoogle_ai_overviews_keywordsgoogle_ai_mode_keywords
Example:chatgpt,perplexity
countrystring

Una lista separada por comas de códigos de país de dos letras (ISO 3166-1 alpha-2).

Valores permitidos:adaeafagaialamaoarasatauawazba…
promptsstring

El tipo de prompts que se utilizarán. Si no se especifica, se usarán ambos. Los prompts personalizados requieren que se proporcione un report_id.

Valores permitidos:ahrefscustom
date_fromstring (date)Obligatorio

La fecha de inicio del periodo histórico en formato AAAA-MM-DD.

date_tostring (date)

La fecha de finalización del periodo histórico en formato AAAA-MM-DD.

outputstring

El formato de salida.

Valores permitidos:jsoncsvxmlphp

Respuestas

metricsarray<object>
datestring (date)
impressionsinteger

Impresiones estimadas a partir de respuestas que mencionan la marca.