Search Google AI Mode, retrieve structured AI-generated answers and source references, and access Markdown or cleaned HTML output through one purpose-built API endpoint.
Use the same API key and credit balance across every ScrapeBadger API.
{
"query": "what is container orchestration",
"text_blocks": [
{
"type": "paragraph",
"snippet": "Container orchestration automates the deployment...",
"text": "Container orchestration automates the deployment and management of containerised applications."
}
],
"references": [
{
"title": "Example container orchestration guide",
"link": "https://example.com/container-orchestration",
"source": "example.com"
}
]
}Move from a search query to AI-generated text blocks, source references, Markdown, and optional HTML with structured JSON responses.
/v1/google/ai-mode/search7 creditsSearch Google AI Mode for a query and receive the AI-generated answer as structured text blocks, source references, Markdown, and optional cleaned HTML.
Control the country and language context with gl and hl. Use include_html=false when your workflow needs only the structured text blocks, references, and compact Markdown instead of the larger raw answer HTML.
q | required | Search query for the AI-generated response. |
curl --get \
'https://scrapebadger.com/v1/google/ai-mode/search' \
--data-urlencode 'q=what is container orchestration' \
--data-urlencode 'gl=us' \
--data-urlencode 'hl=en' \
--data-urlencode 'include_html=false' \
--header 'x-api-key: YOUR_API_KEY'{
"query": "what is container orchestration",
"text_blocks": [
{
"type": "paragraph",
"snippet": "Container orchestration automates the deployment...",
"text": "Container orchestration automates the deployment, scaling, networking, and management of containerised applications.",
"level": 0,
"header": [],
"rows": []
},
{
"type": "paragraph",
"snippet": "It is commonly used to coordinate...",
"text": "It is commonly used to coordinate containers across multiple machines and application environments.",
"level": 0,
"header": [],
"rows": []
}
],
"references": [
{
"title": "Example container orchestration guide",
"link": "https://example.com/container-orchestration",
"snippet": "An introduction to managing containers across application environments.",
"source": "example.com"
},
{
"title": "Example container platform documentation",
"link": "https://docs.example.org/container-platform",
"snippet": "Documentation covering automated deployment, scaling, and management.",
"source": "docs.example.org"
}
],
"language": "en",
"country": "us",
"markdown": "Container orchestration automates the deployment, scaling, networking, and management of containerised applications.",
"answer_html": null
}Search commercially or editorially relevant queries and capture the answers Google AI Mode generates. Track answer text, structured blocks, cited sources, country, and language across consistent searches to study how subjects are represented in AI-powered search.
Search brand names, products, executives, competitors, and industry topics to examine whether Google AI Mode mentions the organisation or references its website. Preserve the answer, reference title, link, snippet, and source so changes can be reviewed over time.
Compare how Google AI Mode describes competing products, companies, technologies, or services for the same queries. Analyse differences in answer structure, terminology, referenced sources, and country or language context without treating a single response as permanent.
Build structured datasets of AI-generated answers and references for search research, journalism, content analysis, source-diversity studies, or internal quality reviews. Store the original query, collection time, country, language, text blocks, references, and Markdown so every observation retains its context.
1,000 free credits · No credit card required
Use the same ScrapeBadger account, API key, and credit balance to connect AI-generated answers with traditional search results, current news, academic sources, and demand signals.
Retrieve traditional Google search results, organic listings, related questions, and other available SERP features. Use it alongside AI Mode to compare AI-generated answers with the standard search results shown for the same query.
Explore the Google SERP API →Search Google News for current articles, publishers, topics, and developing coverage. Use it when an AI Mode research workflow needs current reporting or additional context around a time-sensitive answer.
Explore the Google News API →Search Google Scholar for academic papers, authors, citations, and related research. Use it alongside AI Mode when a workflow needs to compare generated answers with scholarly sources.
Explore the Google Scholar API →Measure relative search interest over time, compare geographic demand, and discover top or rising related topics and queries. Use it to prioritise which queries or subjects should be monitored in Google AI Mode.
Explore the Google Trends API →Structured JSON responses remove browser automation, proxy orchestration, and HTML parsing from your roadmap. Make your first request in minutes and move from proof of concept to production without maintaining scrapers.
99.9% uptime SLA. Your data pipeline does not stop because Google changes a page, rotates an anti-bot challenge, or moves a result block. Monitoring, session management, browser infrastructure, and parsing are all us.
Search, Maps, News, Hotels, Trends, Jobs, Shopping, Patents, Scholar, Images, Videos, Finance, AI Mode, Lens, Local, Shorts, Flights, Products, and Autocomplete — every Google surface under one API key.
RESTful API, SDK support, MCP, CLI, and no-code options. Use ScrapeBadger in an existing system or a new application with consistent authentication, structured JSON, and unified billing.
Use ScrapeBadger through an official SDK, a standard API request, MCP, CLI, or the tools already in your workflow.
Build asynchronous data pipelines with typed responses, retry handling, and access to the complete Google API suite.
Add Google data to Node.js and TypeScript applications with type definitions and support for both ESM and CommonJS.
Connect from any backend or programming language using standard HTTP requests. Responses arrive as structured JSON that can be stored, transformed, or passed into another service.
Access Search, Maps, News, Trends, Shopping, Scholar, Flights, and every other supported Google product with one ScrapeBadger API key and one credit balance.
Give compatible AI agents access to Google Search, Maps, News, Trends, Shopping, Scholar, Images, Flights, and more through ScrapeBadger's MCP server.
Run Google searches, inspect trends, collect local business data, and export results as JSON, CSV, Markdown, or terminal-friendly tables without building an application.
See why developers choose ScrapeBadger for reliable, structured web data.
“We switched from the official Twitter API and cut our costs by 95%. The pagination is seamless, and we've never hit a rate limit. Best decision we made this year.”
“The follower and engagement endpoints are incredibly detailed. We use it for influencer research and competitor analysis. Response times are sub-100ms consistently.”
“Started with the Apify actor, then moved to the API for more control. The 1,000 free credits were enough to build our MVP. Now processing 2M+ tweets monthly.”
“Perfect for academic research. The community and trends endpoints give us data we couldn't get anywhere else. Documentation could use more examples, but support is responsive.”
“We monitor 50,000+ accounts for our clients. ScrapeBadger handles it without breaking a sweat. The bulk ID endpoints are a game-changer for large-scale monitoring.”
“The geo and trends endpoints power our location-based analytics. Setup took 10 minutes. Their Apify actors are also great for quick one-off scrapes.”
Start with pay-as-you-go credits (never expire) or save up to 64% with a monthly or annual subscription. Failed requests never consume credits, and every Google API endpoint is included on every plan.
Choose an endpoint and enter your expected request volume. Google APIs use flat per-request credits, making usage easy to forecast. Failed requests cost 0 credits.
Everything you need to know about the AI Mode API.
text_blocks array contains the structured parts of the AI-generated answer. Blocks can include text, snippets, heading levels, table headers, and table rows. The references array contains the source titles, links, snippets, and source names associated with the response.markdown field provides a compact Markdown representation of the complete answer. The answer_html field provides the cleaned raw answer-body HTML with scripts and styles removed. Because the HTML can contain hundreds of kilobytes, set include_html=false when your workflow needs only text blocks, references, and Markdown.Use 1,000 free credits to retrieve AI-generated answers, structured text blocks, source references, Markdown, and optional cleaned HTML through one structured JSON endpoint.
No credit card required · Failed requests cost 0 credits
Disclaimer: ScrapeBadger is not affiliated with, endorsed by, or in any way officially connected with Google LLC or any of its subsidiaries or affiliates. Google and related trademarks are the property of their respective owners.