AEO API
Send the prompt your buyers type and get back what ChatGPT, Google AI Mode and Google AI Overviews tell them: the answer, every source cited and the products recommended. The data behind share of answer, as JSON.
50 free credits on signup, enough for 12 full checks. No card required.
{ "data": { "platform": "chatgpt", "prompt": "What are the best running shoes for beginners?", "model": "gpt-6", "answer": { "markdown": "The best running shoes for beginners are usually **comfortable, well-fitting daily trainers** that feel good from your very first run...\n\n## 1\\. Brooks Ghost 18\n\n(Best overall for beginners)..." }, "sources": [ { "url": "https://www.rtings.com/running-shoes/reviews/best/beginners", "title": "The 6 Best Running Shoes for Beginners of 2026", "snippet": null, "source": "RTINGS.com", "published_at": "2026-09-18T00:00:00.000Z" }, { "url": "https://www.runnersworld.com/gear/a69991542/editors-beginner-shoe-recommendations/", "title": "Runner’s World Editor Shoe Recommendations for Beginners", "snippet": null, "source": "Runner's World", "published_at": "2026-01-21T00:00:00.000Z" } ], "search_queries": [ "best running shoes for beginners 2026 review Brooks Ghost ASICS Nimbus Saucony Ride Nike Pegasus" ], "shopping": [ { "title": "Brooks Ghost 18", "url": null, "price": null, "image_url": null, "merchant": null }, { "title": "ASICS Novablast 6", "url": null, "price": null, "image_url": null, "merchant": null }, { "title": "HOKA Clifton 11", "url": null, "price": null, "image_url": null, "merchant": null } ] }, "response_time": 28081, "credits_used": 2, "credits_remaining": 4998}Real captured responses from each endpoint, trimmed. Gemini is in beta.
What is the Scavio AEO API?
The Scavio AEO API returns the answers AI search engines give as structured JSON: ChatGPT's answer with its cited sources, searches and recommended products, Google AI Mode's answer with its references, and the Google AI Overview with its references. One API key covers all three, at 4 credits for a full check, so you can track whether your brand is named and cited.
- 3
- answer engines: ChatGPT, Google AI Mode, AI Overviews
- 4
- credits to check one prompt in all three
- 0
- credits for a failed call
Every answer your buyers see
What each engine says, who it cites, and what it recommends.
ChatGPT
POST /api/v1/chatgpt/promptSend the prompt your buyer types. Get back the answer ChatGPT gives, every page it cites with publisher and date, the searches it ran and the products it put in front of the reader.
Google AI Mode
POST /api/v2/google/ai-modeGoogle's generated answer for a query, split into typed text blocks, with the list of sources it cited.
Google AI Overview
POST /api/v2/googleThe overview at the top of the results page, with its references, returned inside the full SERP so you see the AI answer and the organic ranking in one call.
The AEO endpoints
Three POST endpoints that return JSON and share one API key. A full check of one prompt across all three is 4 credits.
| Endpoint | Returns | Credits |
|---|---|---|
ChatGPT/api/v1/chatgpt/prompt | ChatGPT's answer as Markdown, the pages it cites, the searches it ran and the products it recommended | 2 |
Google AI Mode/api/v2/google/ai-mode | Google's generated answer as text_blocks, plus the references it cited | 1 |
Google AI Overview/api/v2/google | The full SERP with ai_overview: the overview text and the references it cited, next to the organic results | 1 |
Checked daily, one prompt is 120 credits a month: about $0.51 on Project, $0.24 on Growth yearly. See plans
Is your brand in the answer?
Send one prompt to all three engines and check each answer for your brand. The response on the right is a real ChatGPT capture, trimmed.
import json
from scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key")
prompt = "best crm for a small business"
brand = "hubspot"
chatgpt = client.chatgpt.prompt(prompt)["data"]
ai_mode = client.google.ai_mode(query=prompt)
serp = client.google.search(query=prompt)
overview = serp.get("ai_overview") or {}
# Is the brand in each answer?
print("ChatGPT:", brand in chatgpt["answer"]["markdown"].lower())
print("AI Mode:", brand in json.dumps(ai_mode["text_blocks"]).lower())
print("AI Overview:", brand in json.dumps(overview).lower())
# Which pages decide the answer?
print([s["url"] for s in chatgpt["sources"]])
print([r["link"] for r in ai_mode["references"]]){
"data": {
"platform": "chatgpt",
"prompt": "What are the best running shoes for beginners?",
"model": "gpt-6",
"answer": {
"markdown": "The best running shoes for beginners are usually **comfortable, well-fitting daily trainers** that feel good from your very first run...\n\n## 1\\. Brooks Ghost 18\n\n(Best overall for beginners)..."
},
"sources": [
{
"url": "https://www.rtings.com/running-shoes/reviews/best/beginners",
"title": "The 6 Best Running Shoes for Beginners of 2026",
"snippet": null,
"source": "RTINGS.com",
"published_at": "2026-09-18T00:00:00.000Z"
},
{
"url": "https://www.runnersworld.com/gear/a69991542/editors-beginner-shoe-recommendations/",
"title": "Runner’s World Editor Shoe Recommendations for Beginners",
"snippet": null,
"source": "Runner's World",
"published_at": "2026-01-21T00:00:00.000Z"
}
],
"search_queries": [
"best running shoes for beginners 2026 review Brooks Ghost ASICS Nimbus Saucony Ride Nike Pegasus"
],
"shopping": [
{ "title": "Brooks Ghost 18", "url": null, "price": null, "image_url": null, "merchant": null },
{ "title": "ASICS Novablast 6", "url": null, "price": null, "image_url": null, "merchant": null },
{ "title": "HOKA Clifton 11", "url": null, "price": null, "image_url": null, "merchant": null }
]
},
"response_time": 28081,
"credits_used": 2,
"credits_remaining": 4998
}Why not the model APIs?
A model API answers your request. AEO is about the answer the product gives everyone else.
OpenAI / Gemini model APIs
- Return a completion from the model and tools you configure, not the answer your buyers get
- Sources only when you wire up search tools yourself, and they are your choices, not the engine's
- No Google AI Mode or AI Overview at all
- Billed per token, so a long answer costs more than a short one
Scavio AEO API
- The answers ChatGPT, Google AI Mode and AI Overviews actually show
- The sources each engine cited, and ChatGPT's searches and product picks
- Flat credits per call: 4 for all three engines, failed calls free
- One key and one bill, with Google, Reddit and YouTube data on the same key
What AEO teams build with it
Share of answer
Run the prompts your buyers type on a schedule and record whether your brand is named in each engine's answer. Across a prompt set that is your share of answer, per engine, next to your competitors'.
chatgpt + ai-mode + searchCitation analysis
ChatGPT sources, AI Mode references and AI Overview references are all lists of URLs. Find the review sites, listicles and threads that decide your category in every engine, then earn a place on them.
chatgpt + ai-mode + searchAI answer vs organic rank
The Google call returns the AI Overview and the organic results together. See where the overview's sources rank, and whether ranking first still gets you cited.
searchProduct recommendation monitoring
For commercial prompts ChatGPT lists the products it recommends in shopping[]. Track whether yours is in the list and which competitors sit above it.
chatgptAEO tools and client reporting
Building an AI visibility tool or reporting AEO for clients? Use these endpoints as the data layer: one key, one billing, and JSON your pipeline parses the same way every day.
MCP + RESTNo code today? Use the free tools
Same endpoints behind them. 5 free runs a day, no account.
How to track your brand in AI answers
- 1
Get an API key
Sign up for a Scavio account and copy your key from the dashboard. You get 50 credits free on signup, enough for 12 full checks across all three engines, with no card required.
- 2
Send the same prompt to each engine
POST {"prompt": "..."} to /api/v1/chatgpt/prompt, and {"query": "..."} to /api/v2/google/ai-mode and /api/v2/google, each with an Authorization: Bearer header.
- 3
Record mentions and citations
Check data.answer.markdown and data.sources from ChatGPT, text_blocks and references from AI Mode, and ai_overview from the Google results. Store them per prompt and per day to see your share of answer move.
AEO API FAQ
What is an AEO API?
+
AEO (answer engine optimization) is about being named and cited in the answers AI assistants give. An AEO API returns those answers as data: the text, the sources each engine cited and the products it recommended, so you can measure your brand's presence instead of checking by hand. Scavio returns this for ChatGPT, Google AI Mode and Google AI Overviews with one API key.
Which AI answer engines does it cover?
+
ChatGPT, Google AI Mode and Google AI Overviews, each as a live endpoint. A Gemini endpoint exists too and returns the same shape as ChatGPT, but it is in beta while we improve its reliability, so it is not part of the checks on this page. Perplexity and Copilot are not covered. Gemini API (beta)
How much does it cost to track a prompt?
+
One check across all three engines is 4 credits: 2 for ChatGPT, 1 for AI Mode and 1 for the Google results with the AI Overview. Checked once a day, a prompt uses 120 credits a month, which is about $0.51 on the Project plan, about $0.24 on Growth yearly and $1.20 pay-as-you-go. Failed calls are not charged. Pricing
Why not call the OpenAI or Gemini model APIs?
+
A model API answers your request with the model and tools you configured. It is not the answer the consumer product gives your buyers, with the sources it chose and the products it showed. AEO is about what your buyers see, and that is what these endpoints return.
How do I measure share of answer?
+
Build a list of the prompts your buyers ask, send each to every engine on a schedule, and record whether your brand appears in the answer and in the cited sources. The share of prompts where you appear, per engine, is your share of answer. Run the same prompts for competitors to compare.
Are answers the same every time?
+
No. AI answers vary between runs and through the day, so treat visibility as a rate measured across several runs, not a single check. ChatGPT answers are never cached. Google AI Mode results can be served from a cache of up to an hour, and Google results with the AI Overview from a cache of up to 24 hours; AI Mode accepts no_cache: true for a fresh answer.
How long does a check take?
+
Google AI Mode and Google results usually answer in a few seconds. ChatGPT takes 10 to 40 seconds because it writes the answer and often searches the web first, so set your HTTP client timeout to at least 90 seconds for that call.
Can I localize answers by country?
+
Yes. The ChatGPT endpoint takes a 2-letter country code. The Google endpoints take gl (country) and hl (language), plus location for city-level results.
What do the responses look like?
+
ChatGPT returns data.answer.markdown, data.sources (url, title, source, published_at), data.search_queries and data.shopping. AI Mode returns text_blocks and references. The Google results include ai_overview with its text_blocks and references, alongside organic_results.
Can I build an AEO tool on it?
+
Yes. Teams use these endpoints as the data layer behind AI visibility dashboards and client reports. The only thing our terms rule out is reselling the raw results as a competing API. Terms
Is there a free way to try it?
+
Yes. New accounts get 50 free credits, enough for 12 full checks, with no card. The free AI visibility checker and cited sources finder run on the same endpoints without an account.
Which languages and tools are supported?
+
Official Python (pip install scavio) and JavaScript/TypeScript (npm i scavio) SDKs, a remote MCP server at mcp.scavio.dev for AI agents, and an n8n community node. Any language can call the REST endpoints with an HTTP client.
Explore more of Scavio
ChatGPT API
The answer, citations, searches and products for one prompt.
Google AI Mode API
Google's generated answer and the sources it cited.
Google Search API
The full SERP, including the AI Overview.
Best ChatGPT brand mention APIs
Six options priced and tested, October 2026.
Track ChatGPT brand mentions
Prompts, mention counts, citations and searches, step by step.
AI Overview citation tracking
30 identical requests: how stable AI Overview citations really are.
ChatGPT API docs
Parameters, response fields and errors.
AI Mode docs
Parameters, response fields and errors.
Pricing
Credit packs and plans, no per-platform surcharge.
Try the AEO API free
50 free credits on signup, no card. Check your first prompt in ChatGPT, Google AI Mode and AI Overviews in one go.