Respostas de IA
API + MCPAs solicitações para este endpoint consomem unidades de API com base no parâmetro
prompts: solicitações que retornam apenas dados de prompt personalizado são gratuitas, enquanto solicitações que incluem dados de prompt da Ahrefs seguem o preço padrão de unidades de API.
Parâmetros de consulta
Uma data para comparar com date, no formato YYYY-MM-DD. Deve ser estritamente anterior a date. Quando definida, o relatório abrange todos os prompts respondidos em qualquer uma das duas datas, e o campo status informa como cada um mudou entre elas. Um prompt respondido apenas em date_compared é informado como lost, e o restante de seus campos descreve a resposta de date_compared, já que não existe resposta em date.
Uma lista separada por vírgulas dos campos a retornar.
A expressão de filtro. Os seguintes identificadores de coluna são reconhecidos (isso difere dos identificadores reconhecidos pelo parâmetro select).
O número de resultados a retornar.
A data a pesquisar, no formato YYYY-MM-DD.
Os relatórios de visibilidade de IA estão migrando para o volume ajustado para IA. Ele estima melhor a demanda por respostas de IA em chatbots e superfícies de pesquisa com IA. Ele é calculado ajustando o volume de pesquisa do Google pelo uso estimado de cada plataforma de IA em comparação com o Google. Este parâmetro será descontinuado em 30 de setembro de 2026; todas as solicitações usarão o novo volume ajustado para IA.
Uma lista separada por vírgulas de códigos de país de duas letras (ISO 3166-1 alpha-2).
Uma coluna pela qual ordenar os resultados.
O ID do relatório a ser usado. Se um for fornecido, outros parâmetros são obtidos do relatório (marca, concorrentes, mercado, país, filtros). Se país ou filtros forem fornecidos, eles substituirão os do relatório. Você pode encontrá-lo na URL do seu relatório do Brand Radar na Ahrefs: https://app.ahrefs.com/brand-radar/reports/#report_id#/...
O tipo de prompts a usar. Se não for especificado, ambos serão usados. Prompts personalizados exigem que um report_id seja fornecido.
Uma lista separada por vírgulas de modelos de chatbot. Todos os modelos podem ser combinados entre si. O módulo claude oferece suporte apenas a prompts personalizados.
Os modelos google_ai_overviews_keywords e google_ai_mode_keywords informam a visibilidade de AI Overviews / AI Mode derivada de consultas de pesquisa do Google (palavras-chave), e não de prompts.
Uma lista separada por vírgulas dos nichos de mercado das suas marcas. Descontinuado em 2026-05-18, este parâmetro deixará de ter efeito pouco depois dessa data.
Uma lista separada por vírgulas dos concorrentes das suas marcas.
Uma lista separada por vírgulas de marcas a pesquisar. Pelo menos um entre brand, competitors, market ou where não deve estar vazio.
O formato de saída.
Respostas
O país da pergunta.
O modelo de chatbot que gerou a resposta.
A data em que os dados foram atualizados pela última vez.
(10 unidades) Os links usados para a resposta.
A pergunta feita pelo usuário.
(10 unidades) A resposta do modelo.
A consulta de pesquisa usada pelo chatbot para encontrar informações para a resposta. Observação: se data_source não incluir chatgpt ou perplexity, este campo estará sempre vazio.
Como o prompt mudou entre date_compared e date. Nulo, a menos que date_compared esteja definido. new — respondido em date, mas não em date_compared. lost — respondido em date_compared, mas não em date; o restante desta linha descreve a resposta de date_compared, já que não existe resposta em date. no_change — respondido nas duas datas, o que não diz nada sobre se a resposta em si, suas menções ou suas citações mudaram.
Tags atribuídas à consulta.
(10 unidades) Pesquisas mensais estimadas. Isso se baseia em nossas estimativas para o Google, combinando o volume de pesquisa de palavras-chave relacionadas em que esta pergunta aparece na seção People Also Ask.