Google AI Mode
Google AI Mode is the conversational tab in Google Search that writes a complete answer to a query instead of listing links, citing the pages it drew on alongside the text. Reading those answers for the searches that matter to a business shows what Google tells people about a category, whether a site is among the cited sources, which competitors are recommended, and how the answer changes from one country or language to another.
Google AI Mode API Features
- The whole answer, formattedanswer holds the AI Mode response in Markdown with its headings, lists and tables, ready to store, diff or display.
- Every cited source, oncereferences lists the sources the answer cites without duplicates, each with position, title, url, domain, site name and the excerpt shown with the answer.
- Choose the marketlocation_code or location_name and language_code or language set the country and language of the search, so the same query can be read in several markets.
- A link back to the live pageurl opens the AI Mode page for the same query, handy for checking an answer by eye.
Google AI Mode API Parameters
| Parameters | Required | Description |
|---|---|---|
query | Required | Search to ask AI Mode, such as best crm for startups. |
location_code | Optional | Location code of the search market. Defaults to 2840 (United States). |
location_name | Optional | Market name as an alternative to location_code. When filled, it is used instead of location_code. |
language_code | Optional | Language code of the search. Defaults to en. |
language | Optional | Language name as an alternative to language_code. When filled, it is used instead of language_code. |
How to Use the Google AI Mode API
Send a search query to the Google AI Mode API and read the answer with its sources.
- POST {"query": "best crm for startups", "location_code": 2840, "language_code": "en"} to /v1/ai-search/google-ai-mode.
- Poll GET /v1/tasks/{task_id} until status is succeeded.
- Read the single row in results.items: answer for the text and references for the cited pages.
curl -X POST "https://api.socq.ai/v1/ai-search/google-ai-mode" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"best crm for startups","location_code":2840,"language_code":"en"}'Google AI Mode API Use Cases
- Check whether your pages are cited: Run your priority queries through the Google AI Mode API and look for your domain in references, noting the position and excerpt Google shows for it.
- See which brands AI Mode recommends: Read answer for buying-intent queries such as best tools in your category and record which products are named and in what order.
- Compare answers across markets: Ask the same query with different location and language settings to localize content where AI Mode tells each market a different story.
Google AI Mode API Pro Tips
- If you track Google AI Mode API answers over time, store the Markdown answer and compare versions, since wording changes show up as a text diff.
- When an answer cites a competitor's page, open its references entry and read the excerpt to see which passage Google relied on.
- If you want AI answers across many questions rather than one search, use the LLM Mentions API with your domain as target.
Related APIs
Beyond the Google AI Mode API, use these APIs when you need a different type of public AI Search data.
- LLM Mentions API — Find the AI Overviews and ChatGPT answers that cite a domain or mention a keyword, with the full answer, cited sources and each question's AI search volume.
- AI Search Visibility API — Measure how often AI answers mention a domain or keyword, with AI search volume, the most cited domains and, on ChatGPT, the brands named alongside it.
- LLM Top Sources API — Rank the 10 domains or pages that AI Overviews and ChatGPT cite most for a keyword or domain, by mentions and AI search volume.