Get the AI Overview Google shows for a search

POST/v1/tools/google.serp.ai-overview/callsNeeds an API key

Returns the AI Overview Google shows for a search, with the sources it cites and any products it shows. Use it to see which sites AI answers cite.

Tool google.serp.ai-overview on Google. Contract version 1, released 2026-10-27.

Over REST, send the input in the body. Over MCP, pass the same input to call_tool.

Both return the full response: the call's ID, status and cost, with this tool's result in output.

Input

querystringRequired

The search query.

countrystring· default us

Two-letter ISO 3166-1 country code. Case-insensitive.

One of the 249 values of the countries list: ISO 3166-1 alpha-2 country codes, lowercase.

languagestring· default en

Two-letter ISO 639-1 language code. Case-insensitive.

One of the 184 values of the languages list: ISO 639-1 two-letter language codes, lowercase.

locationstring

Google location name, such as "New York, New York, United States".

devicestring· default desktop

desktop

mobile

tablet

Output

A successful call returns these blocks in its output. A field not marked required can be null.

`text_blocks`

A list of rows. Always present, possibly empty. The overview in reading order. Empty when Google shows no AI Overview for the query.

typestringRequired

Kind of block: paragraph, heading, list, table, image or code.

paragraph

heading

list

table

image

code

textstring

Text of a paragraph or heading, the code of a code block, or the caption of an image. Null for a list and a table.

urlstring

Where an image links to, such as the product it shows. Null for any other block.

image_urlstring

Address of an image. Null for any other block.

list_itemsarray of object

The items of a list, in reading order. Null for any other block.

list_items.titlestring

Lead-in of the item, such as "Grind size". Null for an item without one.

list_items.textstring

The rest of the item. Null for an item that is only its title.

list_items.urlstring

The item's own link, such as the product it names. Null for an item without one.

table_headerarray of string

The header cells of a table, left to right; an empty cell is null. Null for any other block.

table_rowsarray of object

The body rows of a table, top to bottom, the header excluded. Null for any other block.

table_rows.cellsarray of string

The row's cells, left to right, as plain text. An empty cell is null.

reference_positionsarray of integer

The sources the block cites, each by its position in references, in the order cited. Null for a block that cites none, or when the provider does not say.

`references`

A list of rows. Can be null. The sources of the overview, each once: the cited in citation order, then the uncited.

positionintegerRequired

Rank among the sources, starting at 1. What reference_positions refers to.

titlestring

Title of the source.

urlstring

Address of the cited page. Null for a source Google shows without a link, such as a product.

domainstring

Host of url, such as "www.reddit.com".

sourcestring

Name of the publisher, such as "Reddit".

snippetstring

The passage of the page the overview draws on.

`products`

A list of rows. Can be null. The products the overview shows as shopping cards, in reading order.

titlestringRequired

Name of the product.

urlstring

Google's page for the product.

pricenumber

Current price, in currency.

regular_pricenumber

Price before a discount, in currency. Null when not discounted.

currencystring

ISO 4217 code of the prices, such as "USD".

displayed_pricestring

The price as Google shows it, such as "$499.99 $580".

ratingnumber

Average rating, out of 5.

rating_votesinteger

Number of ratings the average is of.

sellerstring

The store offering the price.

image_urlstring

Address of the product's image.

`answer`

One object. Can be null. The whole overview as one document. Null when the provider sends none.

markdownstringRequired

The overview as markdown, as the provider writes it.

curl https://api.voxoria.ai/v1/tools/google.serp.ai-overview/calls \
  -H "Authorization: Bearer $VOXORIA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"query":"what is photosynthesis","language":"en"}}'

import os

import httpx

response = httpx.post(
    "https://api.voxoria.ai/v1/tools/google.serp.ai-overview/calls",
    headers={"Authorization": f"Bearer {os.environ['VOXORIA_API_KEY']}"},
    json={
        "input": {"query": "what is photosynthesis", "language": "en"},
    },
    timeout=60,
)
print(response.json())

const response = await fetch("https://api.voxoria.ai/v1/tools/google.serp.ai-overview/calls", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.VOXORIA_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "input": {"query": "what is photosynthesis", "language": "en"},
  }),
});
console.log(await response.json());

{
  "name": "call_tool",
  "arguments": {
    "tool": "google.serp.ai-overview",
    "input": {
      "query": "what is photosynthesis",
      "language": "en"
    }
  }
}

200 OKoutputapplication/json

{
  "text_blocks": [
    {
      "type": "paragraph",
      "text": "Photosynthesis is the biological process that green plants, algae, and certain bacteria use to convert light energy into chemical energy .",
      "url": null,
      "image_url": null,
      "list_items": null,
      "table_header": null,
      "table_rows": null,
      "reference_positions": [
        1
      ]
    },
    {
      "type": "heading",
      "text": "The Formula",
      "url": null,
      "image_url": null,
      "list_items": null,
      "table_header": null,
      "table_rows": null,
      "reference_positions": null
    },
    {
      "type": "paragraph",
      "text": "During this process, plants absorb carbon dioxide and water and use solar energy to transform them into glucose (sugar) and oxygen:",
      "url": null,
      "image_url": null,
      "list_items": null,
      "table_header": null,
      "table_rows": null,
      "reference_positions": [
        5
      ]
    }
  ],
  "references": [
    {
      "position": 1,
      "title": "Introduction to Photosynthesis for Children: FreeSchool",
      "url": "https://www.youtube.com/watch?v=XCzFE0SB2N4&t=8",
      "domain": null,
      "source": "YouTube",
      "snippet": "you may have heard it said that plants make their own food. but have you ever wondered how they can do that. the answer is a proce..."
    },
    {
      "position": 2,
      "title": "What is Photosynthesis?",
      "url": "https://www.youtube.com/watch?v=E22APTvfwyE&t=7",
      "domain": null,
      "source": "YouTube",
      "snippet": "all organisms need energy from food animals get food they need by eating plants other animals or both plants and animals are also ..."
    },
    {
      "position": 3,
      "title": null,
      "url": "https://www.youtube.com/watch?v=CL9A8YhwUps&t=16",
      "domain": null,
      "source": "YouTube",
      "snippet": null
    }
  ],
  "products": null,
  "answer": null
}

The output of a real call, each list cut to 3 items.