Google AI Mode
Google's AI Mode: a full conversational answer with the businesses it recommends (place ids included) and its sources.
Google's AI Mode: a full conversational answer with the businesses it recommends (place ids
included) and its sources. Coordinates place the question; country and language set
gl and hl.
In the document form. $1 request $2 q and no query is the document-form Google AI Mode call,
answered as the document: search_metadata, search_parameters, local_results,
inline_shopping, text_blocks, markdown, reference_links. location (a place name,
placed by its uule in the URL and a cookie), uule or latitude with longitude place the
question. url (an image to search) and conversation_token (a follow-up turn) are a 400. Not
returned: web_results, a local result's distance, open_state, thumbnail, type.
X-API-Key<token>Your API key.
cancel_token?stringA name you make up for this request (a UUID is fine), so you can later GET /v1/cancel
with it. Only you know it, so only you can cancel. Use a new one for every request, retries included: a cancelled token stays cancelled for a few minutes.
1 <= length <= 128query?stringThe question, as it is to be asked. 1 to 2000 characters after trimming.
1 <= length <= 2000location?|A canonical place name; placed by its uule, in the URL and in a cookie.
latitude?numberSend with longitude.
-90 <= value <= 90longitude?number-180 <= value <= 180q?string1 <= length <= 8193uule?stringgl?string"us"hl?string"en"The answer: with query and location, ours; with q, the document.
application/json- response
One shape for the AI engines. What each fills:
| Engine | answer_status | model | businesses | citations | location_used |
|---|---|---|---|---|---|
google_ai_overview | answered or no_answer | null | with Google ids when shown as cards; kgmid only for a linked name | title, url, snippet, source | when the footer says, source: device |
google_ai_mode | answered | null | usually with Google ids, rating, reviews | title, url, snippet, source | null |
chatgpt | answered | null | from place cards, with maps_url; no ids | a chip's citation is the site's origin only | null on today's pages |
Identical questions get different answers; asking again is not a cache hit.
search_metadata*search_parameters*The request's own fields as sent, engine first, without cancel_token.
search_information*The parser's own, e.g. yelp_search's; otherwise {}.
answer_status?stringno_answer only from google_ai_overview in practice; for the others a page with no reply is parsed: false.
"answered""no_answer"model?string|nullanswer_text?|Plain text. Null with no_answer.
answer_markdown?|Headings, lists, bold, tables; code fenced with its language, formulas as $LaTeX$. Prefer it for display.
businesses?array<>citations?array<>location_used?|nullcurl -X GET 'https://api.justserp.com/v1/google/ai-mode?query=Who+has+the+best+pizza+near+Chelsea%2C+New+York%2C+NY%3F&location%5Blatitude%5D=40.7455&location%5Blongitude%5D=-74.0083&location%5Bcountry%5D=us&location%5Blanguage%5D=en'{ "search_metadata": { "id": "string", "status": "Success", "created_at": "string", "request_url": "string", "html_url": "string" }, "search_parameters": {}, "search_information": {}, "answer_status": "answered", "model": "string", "answer_text": "string", "answer_markdown": "string", "businesses": [ { "position": 0, "name": "string", "snippet": "string", "place_id": "string", "data_id": "string", "data_cid": "string", "kgmid": "string", "website": "string", "address": "string", "phone": "string", "latitude": 0, "longitude": 0, "rating": 0, "reviews": 0, "citation_indexes": [ 0 ], "maps_url": "string" } ], "citations": [ { "position": 0, "url": "string", "title": "string", "snippet": "string", "source": "string", "date": "string" } ], "location_used": { "latitude": 0, "longitude": 0, "name": "string", "source": "string" }}Google AI Overview GET
The AI Overview Google shows above its results, in full, with the businesses and sources it names.
Google Events GET
Google's Events tab (`udm=54`), which Google serves to a phone only (every job runs on one): each event's title, date and time, venue, town and picture, under the `google_events` field names, with an `event_token` for `/v1/google/events/details`.