Produits

Référence

API

Nombre de réponses de l’IA

API + MCP

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

Paramètres de requête

selectstringObligatoire

Une liste de champs à renvoyer, séparés par des virgules.

datestring (date)

Date pour laquelle établir le rapport, au format AAAA-MM-JJ.

modestring

La portée de la cible.

Valeurs autorisées:exactprefixdomainsubdomains

Par défaut:subdomains

targetstring (url)Obligatoire

La cible de la recherche : un domaine ou une URL.

protocolstring

Le protocole de votre cible.

Valeurs autorisées:bothhttphttps

Par défaut:both

countrystring

Un code pays à deux lettres (ISO 3166-1 alpha-2).

Valeurs autorisées:adaeafagaialamaoarasatauawazba…

outputstring

Le format de sortie.

Valeurs autorisées:jsoncsvxmlphp

Réponses

ai_responses_countobject

chatgptobject or null

(15 unités) Citations pointant vers votre cible dans les réponses générées par cette plateforme d’IA : nombre total de liens de citation (citations) et nombre de pages distinctes citées (pages). null si la plateforme n’a pas été sollicitée.

citationsinteger

pagesinteger

copilotobject or null

(15 unités) Citations pointant vers votre cible dans les réponses générées par cette plateforme d’IA : nombre total de liens de citation (citations) et nombre de pages distinctes citées (pages). null si la plateforme n’a pas été sollicitée.

citationsinteger

pagesinteger

geminiobject or null

(15 unités) Citations pointant vers votre cible dans les réponses générées par cette plateforme d’IA : nombre total de liens de citation (citations) et nombre de pages distinctes citées (pages). null si la plateforme n’a pas été sollicitée.

citationsinteger

pagesinteger

google_ai_modeobject or null

(15 unités) Citations pointant vers votre cible dans les réponses générées par cette plateforme d’IA : nombre total de liens de citation (citations) et nombre de pages distinctes citées (pages). null si la plateforme n’a pas été sollicitée.

citationsinteger

pagesinteger

google_ai_overviewsobject or null

(15 unités) Citations pointant vers votre cible dans les réponses générées par cette plateforme d’IA : nombre total de liens de citation (citations) et nombre de pages distinctes citées (pages). null si la plateforme n’a pas été sollicitée.

citationsinteger

pagesinteger

google_ai_overviews_keywordsobject or null

(15 unités) Citations pointant vers votre cible dans les réponses générées par cette plateforme d’IA : nombre total de liens de citation (citations) et nombre de pages distinctes citées (pages). null si la plateforme n’a pas été sollicitée.

citationsinteger

pagesinteger

grokobject or null

(15 unités) Citations pointant vers votre cible dans les réponses générées par cette plateforme d’IA : nombre total de liens de citation (citations) et nombre de pages distinctes citées (pages). null si la plateforme n’a pas été sollicitée.

citationsinteger

pagesinteger

perplexityobject or null

(15 unités) Citations pointant vers votre cible dans les réponses générées par cette plateforme d’IA : nombre total de liens de citation (citations) et nombre de pages distinctes citées (pages). null si la plateforme n’a pas été sollicitée.

citationsinteger

pagesinteger

Paramètres

selectObligatoire

date

mode

targetObligatoire

protocol

country

output

Clé APIObligatoire

Requête

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

Réponse

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