Détecter si Google affiche un AI Overview pour un mot-clé nécessite un seul appel API avec include_ai_overview défini sur true. Si la réponse contient un champ ai_overview, l'AI Overview est présent pour cette requête.
Prérequis
- Python 3.9+ ou Node.js 18+
- Clé API Scavio
Parcours
Étape 1: Envoyer une requête de recherche avec include_ai_overview
Ajoutez include_ai_overview:true au corps de la requête. Ce champ n'est présent dans la réponse que lorsque Google affiche un AI Overview.
Python
import requests
API_KEY = "your-scavio-api-key"
def has_ai_overview(keyword: str) -> dict:
r = requests.post(
"https://api.scavio.dev/api/v1/search",
json={"query": keyword, "include_ai_overview": True, "num_results": 1},
headers={"x-api-key": API_KEY},
timeout=15
)
r.raise_for_status()
data = r.json()
ao = data.get("ai_overview")
return {
"keyword": keyword,
"has_ai_overview": ao is not None,
"text_preview": (ao.get("text", "")[:200] if ao else None)
}
result = has_ai_overview("best python web frameworks")
print(result)Étape 2: Vérifier par lot une liste de mots-clés
Vérifiez plusieurs mots-clés et renvoyez ceux qui déclenchent un AI Overview.
Python
def batch_check(keywords: list) -> list:
results = []
for kw in keywords:
result = has_ai_overview(kw)
status = "YES" if result["has_ai_overview"] else "NO"
print(f"{status:3} | {kw}")
results.append(result)
return results
KEYWORDS = [
"what is a vector database",
"best noise cancelling headphones",
"python list comprehension",
"buy running shoes online",
"how to cook pasta"
]
batch_check(KEYWORDS)Exemple Python
Python
import requests
from typing import Optional
API_KEY = "your-scavio-api-key"
def check_ai_overview(keyword: str) -> dict:
r = requests.post(
"https://api.scavio.dev/api/v1/search",
json={"query": keyword, "include_ai_overview": True, "num_results": 1},
headers={"x-api-key": API_KEY},
timeout=15
)
r.raise_for_status()
ao = r.json().get("ai_overview")
return {
"keyword": keyword,
"present": ao is not None,
"text": ao.get("text", "")[:200] if ao else None,
"source_count": len(ao.get("sources", [])) if ao else 0
}
def batch_check(keywords: list[str]) -> dict:
yes, no = [], []
for kw in keywords:
r = check_ai_overview(kw)
(yes if r["present"] else no).append(r)
print(f"{'YES' if r['present'] else 'NO ':3} | {kw}")
return {"with_aio": yes, "without_aio": no,
"aio_rate": f"{len(yes)/len(keywords)*100:.0f}%" if keywords else "0%"}
if __name__ == "__main__":
KEYWORDS = [
"what is a vector database",
"best noise cancelling headphones 2026",
"python list comprehension tutorial",
"how to cancel netflix subscription",
"buy running shoes online"
]
summary = batch_check(KEYWORDS)
print(f"\nAI Overview rate: {summary['aio_rate']} ({len(summary['with_aio'])}/{len(KEYWORDS)})")Exemple JavaScript
JavaScript
const API_KEY = 'your-scavio-api-key';
async function checkAiOverview(keyword) {
const res = await fetch('https://api.scavio.dev/api/v1/search', {
method: 'POST',
headers: { 'Content-Type': 'application/json', 'x-api-key': API_KEY },
body: JSON.stringify({ query: keyword, include_ai_overview: true, num_results: 1 })
});
const data = await res.json();
const ao = data.ai_overview;
return { keyword, present: !!ao, text: ao?.text?.slice(0, 200) ?? null };
}
const keywords = ['what is a vector database', 'best headphones 2026', 'buy shoes online'];
for (const kw of keywords) {
const r = await checkAiOverview(kw);
console.log(`${r.present ? 'YES' : 'NO '} | ${kw}`);
}Sortie attendue
JSON
YES | what is a vector database
YES | best noise cancelling headphones 2026
YES | python list comprehension tutorial
NO | how to cancel netflix subscription
NO | buy running shoes online
AI Overview rate: 60% (3/5)