Docs
Buscar documentación...⌘K

Respuestas de IA

API + MCP
GET/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.

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

cited_domain: El dominio de una página que se utilizó para generar la respuesta.
tipo: dominio

cited_domain_subdomains: El dominio de una página que se utilizó para generar la respuesta. También coincidirá cualquier subdominio del dominio indicado.
tipo: string

cited_url_exact: La URL de una página que se utilizó para generar la respuesta.
tipo: string

cited_url_prefix: La URL de una página que se utilizó para generar la respuesta. Coincidirá cualquier URL que empiece por este prefijo.
tipo: string

question: La pregunta realizada por el usuario.
tipo: string

response (10 unidades): La respuesta del modelo.
tipo: string

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

topic: El tema de la consulta.
tipo: string

selectstringObligatorio

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

limitinteger

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

Opción predeterminada:1000
datestring

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

countrystring

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

Valores permitidos:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw
order_bystring

Una columna por la que ordenar los resultados.

Valores permitidos:relevancevolume
Opción predeterminada: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.

Valores permitidos:ahrefscustom
data_sourcestringObligatorio

Una lista separada por comas de modelos de chatbot. Los modelos de Google (google_ai_overviews, google_ai_mode) no se pueden combinar entre sí ni con modelos que no sean de Google.

Valores permitidos:google_ai_overviewsgoogle_ai_modechatgptgeminiperplexitycopilotgrok
Example:chatgpt,perplexity
marketstring

Una lista separada por comas de los nichos de mercado de tus marcas.

competitorsstring

Una lista separada por comas de los competidores de tus marcas.

brandstring

Una lista separada por comas de marcas que se deben buscar. Al menos uno de brand, competitors, market o where no debe estar vacío.

outputstring

El formato de salida.

Valores permitidos:jsonphp

Respuestas

ai_responsesarray<object>
countrystring

El país de la pregunta.

data_sourcestring

El modelo de chatbot que generó la respuesta.

linksarray<object>

(10 unidades) Los enlaces utilizados para la respuesta.

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.