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.
Corpo da solicitação
O intervalo de volume para filtrar.
Uma lista de campos para retornar.\n\n- country\n- data_source\n- last_updated\n- links (10 unidades)\n- question\n- response\n- search_queries\n- tags\n- volume (10 unidades)
A expressão de filtro. Os seguintes identificadores de coluna são reconhecidos (isso difere dos identificadores reconhecidos pelo parâmetro select).
Uma expressão de filtro para tags do prompt. Requer report_id. Usa a sintaxe de filtro com as seguintes restrições: o único nome de campo válido é "tag"; os únicos operadores válidos são: "eq", "neq", "substring", "isubstring", "phrase_match", "iphrase_match", "prefix", "suffix", "empty"; a profundidade máxima de aninhamento de and, or é 2. Exemplo: {"or": [{"field": "tag", "is": ["eq", "branded"]}, {"field": "tag", "is": ["eq", "competitor"]}]}.
O número de resultados a retornar.
A data a ser pesquisada no formato YYYY-MM-DD.
Uma lista de códigos de país de duas letras (ISO 3166-1 alfa-2).
Uma coluna pela qual ordenar os resultados.
O ID do relatório a ser usado. Se um for informado, os outros parâmetros são obtidos do relatório (marca, concorrentes, mercado, país, filtros). Se país ou filtros forem informados, eles substituirão os do relatório. Você pode encontrá-lo na URL do seu relatório do Brand Radar no 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 informado.
Uma lista de modelos de chatbot. Os modelos de palavras-chave do Google (google_ai_overviews_keywords, google_ai_mode_keywords) não podem ser combinados entre si nem com outros modelos.
Uma lista dos nichos de mercado das suas marcas. Obsoleto em 2026-05-18, este parâmetro não terá mais efeito logo após essa data.
Uma lista de nomes e sites de concorrentes para pesquisar.
names or url_groups is requiredOs nomes da marca/concorrente
O domínio do alvo
Escopo do alvo.
Uma lista de nomes e sites de marcas para pesquisar.
names or url_groups is requiredOs nomes da marca/concorrente
O domínio do alvo
Escopo do alvo.
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.
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.