Vous pouvez vérifier si votre produit apparaît dans Google AI Overview en envoyant une requête de recherche avec include_ai_overview défini sur true et en inspectant le champ ai_overview dans la réponse.
Prérequis
- Python 3.9+
- Clé API Scavio
- requests, sqlite3 (stdlib)
Parcours
Étape 1: Effectuer une recherche avec AI Overview activé
Ajoutez include_ai_overview:true à votre payload de recherche. La réponse inclut un objet ai_overview lorsque Google en affiche un pour cette requête.
Python
import requests
API_KEY = "your-scavio-api-key"
response = requests.post(
"https://api.scavio.dev/api/v1/search",
json={
"query": "best project management software",
"include_ai_overview": True,
"num_results": 10
},
headers={"x-api-key": API_KEY}
)
data = response.json()
print(data.get("ai_overview"))Étape 2: Vérifiez si votre domaine est cité
Les réponses AI Overview incluent une liste de liens sources. Parcourez-les pour trouver votre domaine.
Python
def is_cited_in_ai_overview(data: dict, your_domain: str) -> bool:
ai_overview = data.get("ai_overview")
if not ai_overview:
return False
sources = ai_overview.get("sources", [])
return any(your_domain in s.get("link", "") for s in sources)
cited = is_cited_in_ai_overview(data, "yourproduct.com")
print("Cited in AI Overview:", cited)Étape 3: Stockez les résultats dans SQLite pour un suivi quotidien
Exécutez ceci quotidiennement via cron pour constituer un historique des citations AI Overview.
Python
import sqlite3
from datetime import date
def init_db(path="ai_overview_tracker.db"):
conn = sqlite3.connect(path)
conn.execute("""
CREATE TABLE IF NOT EXISTS citations (
date TEXT,
keyword TEXT,
has_ai_overview INTEGER,
is_cited INTEGER,
PRIMARY KEY (date, keyword)
)
""")
conn.commit()
return conn
def track_keyword(conn, keyword: str, your_domain: str, api_key: str):
r = requests.post(
"https://api.scavio.dev/api/v1/search",
json={"query": keyword, "include_ai_overview": True, "num_results": 5},
headers={"x-api-key": api_key}
)
data = r.json()
ai_overview = data.get("ai_overview")
has_ai_overview = 1 if ai_overview else 0
is_cited = 1 if is_cited_in_ai_overview(data, your_domain) else 0
conn.execute(
"INSERT OR REPLACE INTO citations VALUES (?, ?, ?, ?)",
(str(date.today()), keyword, has_ai_overview, is_cited)
)
conn.commit()
return {"keyword": keyword, "has_ai_overview": bool(has_ai_overview), "is_cited": bool(is_cited)}
conn = init_db()
keywords = ["best project management software", "project management tools", "asana alternative"]
for kw in keywords:
result = track_keyword(conn, kw, "yourproduct.com", API_KEY)
print(result)Exemple Python
Python
import requests
import sqlite3
from datetime import date
API_KEY = "your-scavio-api-key"
YOUR_DOMAIN = "yourproduct.com"
def search_with_ai_overview(query: str) -> dict:
r = requests.post(
"https://api.scavio.dev/api/v1/search",
json={"query": query, "include_ai_overview": True, "num_results": 10},
headers={"x-api-key": API_KEY},
timeout=20
)
r.raise_for_status()
return r.json()
def check_citation(data: dict, domain: str) -> dict:
ao = data.get("ai_overview")
if not ao:
return {"has_ai_overview": False, "is_cited": False, "sources": []}
sources = ao.get("sources", [])
cited = any(domain in s.get("link", "") for s in sources)
return {"has_ai_overview": True, "is_cited": cited, "sources": [s["link"] for s in sources]}
def run_daily_tracker(keywords: list, domain: str):
today = str(date.today())
conn = sqlite3.connect("ai_overview_tracker.db")
conn.execute("""
CREATE TABLE IF NOT EXISTS citations (
date TEXT, keyword TEXT, has_ai_overview INTEGER, is_cited INTEGER,
PRIMARY KEY (date, keyword)
)
""")
conn.commit()
for kw in keywords:
data = search_with_ai_overview(kw)
result = check_citation(data, domain)
conn.execute(
"INSERT OR REPLACE INTO citations VALUES (?, ?, ?, ?)",
(today, kw, int(result["has_ai_overview"]), int(result["is_cited"]))
)
conn.commit()
status = "CITED" if result["is_cited"] else ("AIO present" if result["has_ai_overview"] else "no AIO")
print(f"{today} | {kw[:50]:<50} | {status}")
conn.close()
if __name__ == "__main__":
KEYWORDS = [
"best project management software",
"project management tools for teams",
"asana alternative 2026",
"free project tracker online"
]
run_daily_tracker(KEYWORDS, YOUR_DOMAIN)Exemple JavaScript
JavaScript
const API_KEY = 'your-scavio-api-key';
const YOUR_DOMAIN = 'yourproduct.com';
async function searchWithAiOverview(query) {
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, include_ai_overview: true, num_results: 10 })
});
if (!res.ok) throw new Error(`Search failed: ${res.status}`);
return res.json();
}
function checkCitation(data, domain) {
const ao = data.ai_overview;
if (!ao) return { hasAiOverview: false, isCited: false };
const sources = ao.sources ?? [];
const isCited = sources.some(s => s.link?.includes(domain));
return { hasAiOverview: true, isCited, sources: sources.map(s => s.link) };
}
const keywords = ['best project management software', 'asana alternative 2026'];
for (const kw of keywords) {
const data = await searchWithAiOverview(kw);
const result = checkCitation(data, YOUR_DOMAIN);
const status = result.isCited ? 'CITED' : (result.hasAiOverview ? 'AIO present' : 'no AIO');
console.log(`${kw} | ${status}`);
}Sortie attendue
JSON
2026-05-22 | best project management software | AIO present
2026-05-22 | project management tools for teams | CITED
2026-05-22 | asana alternative 2026 | no AIO
2026-05-22 | free project tracker online | AIO present