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

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": {
    "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
    }
  }
}