Skip to main content
This section documents the places data returned by the Google AI Mode endpoint. Places are part of the AI Mode response — no separate API call is needed.

​
Example request

Places data is intent-detected: send a prompt that expresses location intent (for example, looking for restaurants, attractions, or businesses in a place). No flag is required. 
{
  "prompt": "best ramen restaurants in Tokyo",
  "country": "JP"
}
This produces a response containing the places array documented below.

​
Overview

Location data extracted from the response when AI Mode detects location intent.

​
Place structure

FieldTypeDescription
titlestringPlace name
ratingnumberStar rating (0-5)
reviewsintegerNumber of reviews
pricestringPrice level (e.g., ”$”, ”$$”, ”$$$“)
statusstringOperating status (e.g., “Open now”)
addressstringFull address
place_idstringGoogle Places ID
linkstringGoogle search URL for the place

​
Response example

{
  "success": true,
  "result": {
    "text": "Here are some highly-rated ramen restaurants in Tokyo...",
    "places": [
      {
        "title": "Ichiran Shibuya",
        "rating": 4.4,
        "reviews": 8421,
        "price": "$$",
        "status": "Open now",
        "address": "1-22-7 Jinnan, Shibuya City, Tokyo",
        "place_id": "ChIJN1t_tDeuEmsRUsoyG83frY4",
        "link": "https://www.google.com/search?q=Ichiran+Shibuya"
      }
    ]
  }
}