Docs
Buscar documentación...⌘K

Respuestas de IA

API + MCP
POST/v3/brand-radar/ai-responses

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.

Cuerpo de la solicitud

volume_rangeobject

El intervalo de volumen por el que filtrar.

frominteger
tointeger
selectarray<string>Required

Una lista de campos para devolver.

Example:["field_a","field_b"]
whereobject

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

tags_filterobject

Una expresión de filtro para las etiquetas del prompt. Requiere report_id. Utiliza la sintaxis de filtro con las siguientes restricciones: el único nombre de campo válido es "tag"; los únicos operadores válidos son: "eq", "neq", "substring", "isubstring", "phrase_match", "iphrase_match", "prefix", "suffix", "empty"; la profundidad máxima de anidamiento de and y or es 2. Ejemplo: {"or": [{"field": "tag", "is": ["eq", "branded"]}, {"field": "tag", "is": ["eq", "competitor"]}]}.

limitinteger

El número de resultados que se devolverán.

Default:1000
datestring (date)

La fecha que se debe buscar en formato YYYY-MM-DD.

countryarray<string>

Una lista de códigos de país de dos letras (ISO 3166-1 alfa-2).

Allowed values:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw
Default:
order_bystring

Una columna por la que ordenar los resultados.

Allowed values:relevancevolume
Default:relevance
report_idstring

El ID del informe que se va a usar. Si se proporciona uno, otros parámetros se toman del informe (marca, competidores, mercado, país, filtros). Si se proporcionan país o filtros, anulan 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#/...

promptsstring

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

Allowed values:ahrefscustom
data_sourcearray<string>Required

Una lista de modelos de chatbot. Los modelos de palabras clave de Google (google_ai_overviews_keywords, google_ai_mode_keywords) no se pueden combinar entre sí ni con otros modelos.

Allowed values:chatgptgoogle_ai_overviewsgoogle_ai_modegeminiperplexitycopilotgrokgoogle_ai_overviews_keywordsgoogle_ai_mode_keywords
marketarray<string>

Una lista de los nichos de mercado de tus marcas. En desuso a partir del 2026-05-18, este parámetro dejará de tener efecto poco después de esa fecha.

competitorsarray<object>

Una lista de nombres de competidores y sitios web que se deben buscar.

At least one of names or url_groups is required
namesarray<string>

Los nombres de la marca o del competidor

Example:["ahrefs","ahrefs seo"]
url_groupsarray<object>
targetstring (domain)required

El dominio del objetivo

Example:ahrefs.com
scopestringrequired

El alcance del objetivo.

Allowed values:urlpathdomainsubdomains
brandsarray<object>

Una lista de nombres de marcas y sitios web que se deben buscar.

At least one of names or url_groups is required
namesarray<string>

Los nombres de la marca o del competidor

Example:["ahrefs","ahrefs seo"]
url_groupsarray<object>
targetstring (domain)required

El dominio del objetivo

Example:ahrefs.com
scopestringrequired

El alcance del objetivo.

Allowed values:urlpathdomainsubdomains
outputstring

El formato de salida.

Allowed values:jsonphp

Respuestas

ai_responsesarray<object>
countrystring

El país de la pregunta.

data_sourcestring

El modelo de chatbot que generó la respuesta.

last_updatedstring (date)

La fecha en la que los datos se actualizaron por última vez.

linksarray<object>

(10 unidades) Los enlaces utilizados para la respuesta.

urlstring
titlestring or null
questionstring

La pregunta formulada por el usuario.

responsestring

(10 unidades) La respuesta del modelo.

search_queriesarray<string>

La consulta de búsqueda utilizada por el chatbot para encontrar información para la respuesta. Nota: si data_source no incluye chatgpt o perplexity, este campo siempre estará vacío.

tagsarray<string>

Etiquetas asignadas a la consulta.

volumeinteger

(10 unidades) Volumen de búsqueda mensual estimado. Se basa en nuestras estimaciones para Google, combinando los volúmenes de búsqueda de palabras clave relacionadas en las que esta pregunta aparece en la sección People Also Ask.