Query Google AI Mode for a natural-language question or search query. The response always includes search_parameters, text_blocks, references, and shopping_results.
This endpoint is active . The response shape may evolve.
Pair with Google Search when you also need organic listings.
POST https://api.piloterr.com/v2/google/search/ai
Content-Type: application/json
{"query": "what is mozilla firefox", "gl": "us", "hl": "en"}
GET and POST are supported. On GET, pass parameters in the query string. On POST, send the same fields as a JSON body.
GET https://api.piloterr.com/v2/google/search/ai?query=what+is+mozilla+firefox&gl=us&hl=en
Parameter
Type
Required
Description
querystring
yes
Question or search query for Google AI Mode.
locationstring
no
City-level location (mutually exclusive with uule)
uulestring
no
Google-encoded location (mutually exclusive with location)
glstring
no
2-letter country code e.g. us, fr, gb
hlstring
no
2-letter language code e.g. en, fr, de
Field
Type
Description
search_parameters.enginestring
Always google_ai_mode
search_parameters.qstring
Echoed search query
search_parameters.glstring
Country code
search_parameters.hlstring
Language code
search_parameters.locationstring
Human-readable location when set
search_parameters.uulestring
Encoded location when set
text_blocks[]array
Always present. Types: paragraph, heading, list, ordered_list
text_blocks[].snippetstring
Block text. Headings also include level
text_blocks[].list[]array
Items for list and ordered_list. Optional title, snippet, snippet_links, reference_indexes, shopping_result
reconstructed_markdownstring
Markdown reconstruction. Omitted when the answer is empty
references[]array
Always present
references[].titlestring
Source title
references[].linkstring
Cited page URL. A Google redirect is resolved; the destination is not re-encoded
references[].sourcestring
Source site name
references[].indexnumber
0-based citation index
references[].snippetstring
Source excerpt, when present
references[].source_iconstring
Favicon URL, when present
references[].thumbnailstring
Thumbnail URL, when present
shopping_results[]array
Always present. Product cards, or []
shopping_results[].titlestring
Product name
shopping_results[].product_linkstring
Product URL as returned, often a Google Shopping prds link
shopping_results[].sourcestring
Seller or source label, when present
shopping_results[].thumbnailstring
Image URL, when present
shopping_results[].pricestring
Display price, when Google includes it
shopping_results[].extracted_pricenumber
Numeric price, when present
shopping_results[].old_pricestring
Previous display price, when present
shopping_results[].extracted_old_pricenumber
Numeric previous price, when present
shopping_results[].ratingnumber
Star rating, when present
shopping_results[].reviewsnumber
Review count, when present
shopping_results[].indexnumber
0-based product index
errorstring
Only when the AI Mode page could not be fetched
Status: active. Response structure may evolve.
Cost: 3 credits per call
location and uule are mutually exclusive: use only one at a timeUnset location / uule are omitted from search_parameters
A fetched page with no answer content returns empty text_blocks, references, and shopping_results, without error
HTTP 400 when query is missing
HTTP 500 on fetch or parse failure
Archive AI Mode answers for a keyword set
Extract cited domains and links for citation checks
Pull structured summaries for research pipelines
Compare AI Mode answers over time, country, and language
This is not an official API. Piloterr is an independent data provider and is not affiliated with, endorsed by, or sponsored by Autom or its owners. All trademarks belong to their respective owners.
