Prodotti

Riferimento

API

Conteggio delle risposte IA

API + MCP

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

Parametri della query

selectstringObbligatorio

Un elenco di campi da restituire separati da virgole.

datestring (date)

La data per cui generare il report, in formato YYYY-MM-DD.

modestring

L'ambito del target.

Valori consentiti:exactprefixdomainsubdomains

Predefinita:subdomains

targetstring (url)Obbligatorio

L’oggetto della ricerca: un dominio o un URL.

protocolstring

Il protocollo del tuo target.

Valori consentiti:bothhttphttps

Predefinita:both

countrystring

Un codice paese a due lettere (ISO 3166-1 alpha-2).

Valori consentiti:adaeafagaialamaoarasatauawazba…

outputstring

Il formato di output.

Valori consentiti:jsoncsvxmlphp

Risposte

ai_responses_countobject

all_platformsobject or null

(15 unità) Citazioni al tuo target su tutte le piattaforme IA considerate nel loro insieme (AI Overview, AI Mode, ChatGPT, Perplexity, Gemini, Copilot, Grok): il numero totale di link di citazione (citations) e il numero di pagine citate distinte (pages), deduplicati tra le piattaforme. null se non richiesto.

citationsinteger

pagesinteger

chatgptobject or null

(15 unità) Citazioni del tuo target nelle risposte generate da questa piattaforma di IA: il numero totale di link di citazione (citations) e il numero di pagine citate distinte (pages). null se la piattaforma non è stata richiesta.

citationsinteger

pagesinteger

copilotobject or null

(15 unità) Citazioni del tuo target nelle risposte generate da questa piattaforma di IA: il numero totale di link di citazione (citations) e il numero di pagine citate distinte (pages). null se la piattaforma non è stata richiesta.

citationsinteger

pagesinteger

geminiobject or null

(15 unità) Citazioni del tuo target nelle risposte generate da questa piattaforma di IA: il numero totale di link di citazione (citations) e il numero di pagine citate distinte (pages). null se la piattaforma non è stata richiesta.

citationsinteger

pagesinteger

google_ai_modeobject or null

(15 unità) Citazioni del tuo target nelle risposte generate da questa piattaforma di IA: il numero totale di link di citazione (citations) e il numero di pagine citate distinte (pages). null se la piattaforma non è stata richiesta.

citationsinteger

pagesinteger

google_ai_overviewsobject or null

(15 unità) Citazioni del tuo target nelle risposte generate da questa piattaforma di IA: il numero totale di link di citazione (citations) e il numero di pagine citate distinte (pages). null se la piattaforma non è stata richiesta.

citationsinteger

pagesinteger

google_ai_overviews_keywordsobject or null

(15 unità) Citazioni del tuo target nelle risposte generate da questa piattaforma di IA: il numero totale di link di citazione (citations) e il numero di pagine citate distinte (pages). null se la piattaforma non è stata richiesta.

citationsinteger

pagesinteger

grokobject or null

(15 unità) Citazioni del tuo target nelle risposte generate da questa piattaforma di IA: il numero totale di link di citazione (citations) e il numero di pagine citate distinte (pages). null se la piattaforma non è stata richiesta.

citationsinteger

pagesinteger

perplexityobject or null

(15 unità) Citazioni del tuo target nelle risposte generate da questa piattaforma di IA: il numero totale di link di citazione (citations) e il numero di pagine citate distinte (pages). null se la piattaforma non è stata richiesta.

citationsinteger

pagesinteger

Parametri

selectObbligatorio

date

mode

targetObbligatorio

protocol

country

output

Chiave APIObbligatorio

Richiesta

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

Risposta

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
    }
  }
}