Skip to main content
See every entry.
Google Search: expand the AI Overview in the HTML pageYou can now expand the AI Overview in the include.html page. Send include.aioverview.expand: true and the stored page shows the full AI Overview, as if Show more were clicked. This works on desktop only: on phones, Show more opens AI Mode. result.aioverview does not change.
Google AI Overview: product cards with merchant offersThe Google Search endpoint now returns the product cards in an AI Overview answer as result.aioverview.inlineProducts, with title, price, store and rating. A card that links to a Google product viewer has a productResultToken: send it to POST /v1/monitor/google/product to get the merchant offers. See AI Overview inline products.Google AI Mode inline products now also have rating.
Async: the idempotency 409 returns the existing task IDWhen you reuse an idempotencyKey, the 409 RESOURCE_ALREADY_EXISTS from POST /v1/async/task now has error.details.taskId: the ID of the task that already holds the key. If your submit request timed out before you received the taskId, resubmit with the same key and poll the returned ID. The batch endpoint returns it too, except for a key repeated inside the same batch.Google: the AI Overview is expanded in the HTMLWhen a Google Search request sends include.aioverview and include.html, the stored HTML now shows the AI Overview expanded, as it looks after a click on “Show more”. Before, it was collapsed. The cost does not change.
Place cards carry phone and website, and placeId is now a Google IDPlace cards render Call, Directions and Website buttons. places[] and map[] now read all three, on AI Mode and AI Overview alike:
address is the full postal address from the Directions link. It used to be the short line printed on the card — a street line, a “city, region” line, or nothing at all.placeId was a hash of the title and address. It is now the place’s Google Knowledge Graph ID, the same id its map entry carries, so the two join on it. Two things change for you: the value differs from what you stored before, and it is omitted on a card Google did not geo-tag.phone and website are omitted when the card renders no Call or Website button.See the places and map schemas.
Google AI Overview ships place cards as places and mapLocal answers show place cards. Their Directions and Website buttons used to reach you in sources; the cards now come back as result.aioverview.places and result.aioverview.map, with the same structure as in AI Mode.On both surfaces:
  • places[].link is the place’s Google viewer URL, the same URL as its entry in sources.
  • map[].link is a Google Maps URL that opens the place, for example https://maps.google.com/?cid=11340480041048787817.
See the AI Overview schema.
Google AI Mode and AI Overview: France (FR) is now supportedYou can now send country: "FR" to the Google AI Mode endpoint and use include.aioverview on the Google endpoint for FR requests. Previously these were rejected as unsupported regions; regular Google Search already accepted FR. The /v1/countries endpoint now lists FR under model=aimode and model=aioverview.
Google AI Overview: new relatedLinks fieldGoogle AI Overview responses now expose a relatedLinks array on result.aioverview. These are a citation chip’s “View related links” flyout items — URLs Google groups under a pill that are not in the sources rail (for example a Google Shopping comparison link). Previously these rendered inline in markdown with no structured home, which made markdown appear to carry more URLs than sources / citationPills. Each related link now shares the citationPillId of its chip (so you can group it with that chip’s citation pills) and carries label, url, and domain. The field is additive and omitted when no chip carries related links. See the AI Overview schema.
Structured citationPills array on Google AI Overview and AI ModeBoth Google AI surfaces now emit an additive citationPills array alongside the answer text and sources. Each entry is one (pill, source) pair carrying a per-source label (the source’s own page title from the sources rail), a citationPillId that groups entries from the same chip, and per-source url/domain/description/position. Cross-provider iteration over AI surface citation pills now uses one shape.
When a pill cites N sources, the array contains N entries sharing the same citationPillId but carrying distinct per-source label, url, and domain. Group by citationPillId to recover the pill-level structure.Markdown rendering is unchanged — inline [anchor](url) links remain the canonical in-text citation form. The citationPills array gives type-aware consumers per-source access without re-parsing markdown.Additive change — existing consumers are unaffected. Learn more in the AI Overview citation pills and AI Mode citation pills documentation.
AI Overview ads now carry a type discriminatorEvery entry in aioverview.ads[] on the Google Search endpoint now carries an explicit type field. Mirrors the same convention already in place for top-level ads[] (added 13th May), so callers can route ads to per-sub-type rendering without re-implementing the price/store presence heuristic.
  • type: "TEXT" — text/lead-gen ads. Carry domain + description (+ shared position / title / url / image).
  • type: "SHOPPING" — shopping/product ads. Carry price + store (+ optional old_price, + shared fields).
Each ad is exactly one sub-type — the two sub-schemas are disjoint. Sub-type-exclusive fields are only present when they apply to that ad, matching what the Google SERP actually renders. image is the one field that appears in either sub-type (product photo on shopping cards, hero image on text ads), so consumers should treat it as optional regardless of type.
Additive change — existing consumers ignoring the new field are unaffected. No opt-in, no extra credit charge. Learn more in the AI Overview ads documentation.
AI Overview and AI Mode markdown citations now match ChatGPTWhen you opt into markdown output, in-text citations from Google AI Overview and Google AI Mode are now rendered as standard inline [anchor](url) links in the markdown field — the same shape ChatGPT already uses.
Anchor text resolves via a deterministic fallback chain: matched source title → Google’s pill-chip label → URL host. Multi-source pills (Google’s +N chips) expand to N adjacent stacked links at the citation point. result.markdown is now fully self-contained — no parallel index resolution needed to render citations.Learn more in the AI Overview and AI Mode documentation.
AI Overview videos now carry full metadataaioverview.videos[] entries on the Google Search endpoint now populate title, source, platform, date, thumbnail, and duration whenever Google renders them. Previous responses returned only url for the vast majority of video cards because the extractor was matching stale Google class names.url remains the only guaranteed field. title, source, platform, and date are present on roughly 98% of videos; thumbnail (~60%) and duration (~15%) appear only when Google renders the rich carousel preview. Check for field presence before reading.No schema change, no opt-in, no extra credit charge — existing requests start receiving the richer payload automatically. Learn more in the AI Overview documentation.
Sponsored ad extraction for AI OverviewGoogle AI Overview responses now include structured sponsored ad data when Google injects advertising inside the AI Overview. Ads are exposed as a new ads array alongside the existing text, sources, and videos fields.Each ad includes:
  • Ad details: Title, destination URL, domain, and description
  • Position tracking: Position index within the AI Overview ad block
Ads also remain visible in text and markdown output for full transparency. No additional parameters required — ads are automatically included when present.Learn more in our AI Overview documentation.
Updated Google Search pricing structureWe’ve updated the Google Search endpoint baseline pricing to a more predictable tiered structure for multi-page requests.What’s changed:
  • Multi-page pricing is now tiered instead of per page:
    • 2-3 pages: +1 credit (was +2-4 credits)
    • 4-10 pages: +2 credits (was +6-18 credits)
  • Base cost and AI Overview remain unchanged:
    • Base request: 3 credits
    • AI Overview addon: +2 credits
New pricing examples:
  • 1 page, no AI Overview: 3 credits (unchanged)
  • 1 page, with AI Overview: 5 credits (unchanged)
  • 3 pages, with AI Overview: 6 credits (was 9 credits)
  • 10 pages, with AI Overview: 7 credits (was 23 credits)
Costs are more predictable, with reduced pricing for bulk multi-page extraction.
We’ve expanded our geographical coverage across all Google endpoints:
  • Google Search: Now available in all 250 countries worldwide
  • AI Mode: Expanded from 58 to 211 countries
  • AI Overview: Expanded from 59 to 230 countries
Remember to check the model-specific country list before deploying to ensure availability for your target endpoint.
More fields extracted for AI Mode and AI OverviewGoogle AI Mode and AI Overview endpoints now automatically extract rich structured data:
  • Places in AI Mode: Location information with ratings, reviews, price levels, addresses, Google Places IDs, and operating status
  • Shopping cards in AI Mode: Structured product data with currency-aware pricing, merchant details, ratings, and purchase links
  • Video content in AI Overview: Videos with thumbnails, titles, duration, platform info, and source attribution
No additional parameters required. All structured data is automatically detected and included when available in responses.Learn more in AI Mode and AI Overview.
New dedicated endpointsEach AI model now has its own dedicated endpoint for better performance and clearer documentation: