ai-search/
google-ai-mode

With the Google AI Mode API, a search returns the complete answer Google AI Mode writes for it, in Markdown, with the deduplicated list of sources it cites, each with title, URL, domain and excerpt.

Google AI Mode API

Full answer in Markdown
Cited sources
Any country and language
One row per search
2 credits / request
Ready
Ready

Enter parameters and send a request. The task status and normalized results will appear here.

README

By SocQ · Updated

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

ParametersRequiredDescription
queryRequiredSearch to ask AI Mode, such as best crm for startups.
location_codeOptionalLocation code of the search market. Defaults to 2840 (United States).
location_nameOptionalMarket name as an alternative to location_code. When filled, it is used instead of location_code.
language_codeOptionalLanguage code of the search. Defaults to en.
languageOptionalLanguage 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.

  1. POST {"query": "best crm for startups", "location_code": 2840, "language_code": "en"} to /v1/ai-search/google-ai-mode.
  2. Poll GET /v1/tasks/{task_id} until status is succeeded.
  3. 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.

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.

Explore other platforms

Combine AI Search data with public data from other supported social platforms.

Google AI Mode API — FAQ

Google AI Mode API returns the full answer AI Mode writes for a search query, in Markdown, together with the deduplicated sources it cites and their titles, URLs, domains and excerpts.

AI Mode is its own conversational tab in Google Search that writes a complete answer for each query, and this API reads that tab; answers from AI Overviews are covered by the LLM Mentions API.

Yes. The defaults are the United States (2840) and English (en), and location_code or location_name with language_code or language change them.

Each request costs 2 credits and returns one row with the answer and its sources.