Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.cloro.dev/llms.txt

Use this file to discover all available pages before exploring further.

This section documents the places data returned by the Google AI Mode endpoint. Places are part of the AI Mode response, so no separate API call is needed.

​
Example request

Places are 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

Inline place cards extracted from the response when AI Mode detects location intent.
Places in AI Mode
For GPS-enriched location data with latitude and longitude coordinates, see map. places and map may both appear in the same response.

​
Place structure

FieldTypeDescription
titlestringPlace name
linkstringGoogle viewer URL for the place
place_idstringGoogle Places ID
indexintegerPosition index of the place in the results
thumbnailstringPlace thumbnail image URL
ratingnumberStar rating (0-5)
reviewsintegerNumber of reviews
typestringPlace type or category
price_levelstringPrice level indicator (e.g., ”$”, ”$$”, ”$$$“)
addressstringFull address
statusstringOperating status (e.g., “Open now”)

​
Response example

{
  "success": true,
  "result": {
    "text": "Here are highly-rated ramen restaurants in Tokyo...",
    "places": [
      {
        "title": "Gion District",
        "link": "https://www.google.com/viewer/place?mid=/g/11bw3yq9kp",
        "place_id": "/g/11bw3yq9kp",
        "index": 0,
        "thumbnail": "https://lh5.googleusercontent.com/p/example",
        "rating": 4.5,
        "reviews": 2900,
        "type": "Tourist attraction",
        "price_level": "$$",
        "address": "Gionmachi, Higashiyama Ward, Kyoto",
        "status": "Open now"
      }
    ]
  }
}