Produtos

Referência

API

Contagem de respostas de IA

API + MCP

GET/v3/site-explorer/ai-responses-count

Parâmetros de consulta

selectstringObrigatório

Uma lista de campos, separados por vírgulas, a serem retornados.

datestring (date)

A data para a qual gerar o relatório, no formato YYYY-MM-DD.

modestring

O escopo do alvo.

Valores permitidos:exactprefixdomainsubdomains

Padrão:subdomains

targetstring (url)Obrigatório

O alvo da pesquisa: um domínio ou uma URL.

protocolstring

O protocolo do seu alvo.

Valores permitidos:bothhttphttps

Padrão:both

countrystring

Um código de país de duas letras (ISO 3166-1 alpha-2).

Valores permitidos:adaeafagaialamaoarasatauawazba…

outputstring

O formato de saída.

Valores permitidos:jsoncsvxmlphp

Respostas

ai_responses_countobject

all_platformsobject or null

(15 unidades) Citações ao seu alvo em todas as plataformas de IA combinadas (AI Overviews, AI Mode, ChatGPT, Perplexity, Gemini, Copilot, Grok): o número total de links de citação (citations) e o número de páginas citadas distintas (pages), desduplicados entre plataformas. null se não for solicitado.

citationsinteger

pagesinteger

chatgptobject or null

(15 unidades) Citações ao seu destino nas respostas geradas por esta plataforma de IA: o número total de links de citação (citations) e o número de páginas distintas citadas (pages). null caso a plataforma não tenha sido solicitada.

citationsinteger

pagesinteger

copilotobject or null

(15 unidades) Citações ao seu destino nas respostas geradas por esta plataforma de IA: o número total de links de citação (citations) e o número de páginas distintas citadas (pages). null caso a plataforma não tenha sido solicitada.

citationsinteger

pagesinteger

geminiobject or null

(15 unidades) Citações ao seu destino nas respostas geradas por esta plataforma de IA: o número total de links de citação (citations) e o número de páginas distintas citadas (pages). null caso a plataforma não tenha sido solicitada.

citationsinteger

pagesinteger

google_ai_modeobject or null

(15 unidades) Citações ao seu destino nas respostas geradas por esta plataforma de IA: o número total de links de citação (citations) e o número de páginas distintas citadas (pages). null caso a plataforma não tenha sido solicitada.

citationsinteger

pagesinteger

google_ai_overviewsobject or null

(15 unidades) Citações ao seu destino nas respostas geradas por esta plataforma de IA: o número total de links de citação (citations) e o número de páginas distintas citadas (pages). null caso a plataforma não tenha sido solicitada.

citationsinteger

pagesinteger

google_ai_overviews_keywordsobject or null

(15 unidades) Citações ao seu destino nas respostas geradas por esta plataforma de IA: o número total de links de citação (citations) e o número de páginas distintas citadas (pages). null caso a plataforma não tenha sido solicitada.

citationsinteger

pagesinteger

grokobject or null

(15 unidades) Citações ao seu destino nas respostas geradas por esta plataforma de IA: o número total de links de citação (citations) e o número de páginas distintas citadas (pages). null caso a plataforma não tenha sido solicitada.

citationsinteger

pagesinteger

perplexityobject or null

(15 unidades) Citações ao seu destino nas respostas geradas por esta plataforma de IA: o número total de links de citação (citations) e o número de páginas distintas citadas (pages). null caso a plataforma não tenha sido solicitada.

citationsinteger

pagesinteger

Parâmetros

selectObrigatório

date

mode

targetObrigatório

protocol

country

output

Chave de APIObrigatório

Solicitação

curl "https://api.ahrefs.com/v3/site-explorer/ai-responses-count" \
  -H "Authorization: Bearer $AHREFS_API_KEY" \
  -H "Accept: application/json"

import requests

url = "https://api.ahrefs.com/v3/site-explorer/ai-responses-count"
headers = {
    "Authorization": "Bearer $AHREFS_API_KEY",
    "Accept": "application/json"
}

response = requests.get(url, headers=headers)
print(response.json())

const response = await fetch("https://api.ahrefs.com/v3/site-explorer/ai-responses-count", {
  method: "GET",
  headers: {
    "Authorization": "Bearer $AHREFS_API_KEY",
    "Accept": "application/json"
  }
});

const data = await response.json();
console.log(data);

req, _ := http.NewRequest("GET", "https://api.ahrefs.com/v3/site-explorer/ai-responses-count", nil)
req.Header.Set("Authorization", "Bearer $AHREFS_API_KEY")
req.Header.Set("Accept", "application/json")

resp, _ := http.DefaultClient.Do(req)
defer resp.Body.Close()

data, _ := io.ReadAll(resp.Body)
fmt.Println(string(data))

Resposta

200 OK

{
  "ai_responses_count": {
    "all_platforms": {
      "citations": 0,
      "pages": 0
    },
    "chatgpt": {
      "citations": 0,
      "pages": 0
    },
    "copilot": {
      "citations": 0,
      "pages": 0
    },
    "gemini": {
      "citations": 0,
      "pages": 0
    },
    "google_ai_mode": {
      "citations": 0,
      "pages": 0
    },
    "google_ai_overviews": {
      "citations": 0,
      "pages": 0
    },
    "google_ai_overviews_keywords": {
      "citations": 0,
      "pages": 0
    },
    "grok": {
      "citations": 0,
      "pages": 0
    },
    "perplexity": {
      "citations": 0,
      "pages": 0
    }
  }
}