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 travel and places data returned by the Perplexity endpoint. Travel and places data are part of the Perplexity response, so no separate API call is needed.

​
Example request

Travel and places data is intent-detected. Send a prompt that expresses travel intent (for example, hotels in a city, places to visit, things to do). No flag is required. 
{
  "prompt": "best hotels in Lisbon for families",
  "country": "PT"
}
This produces a response containing the hotels and places arrays documented below.

​
Overview

Perplexity automatically detects travel-intent queries and returns structured hotel listings and general place data.
Location data in Perplexity

​
Travel data structure

FieldTypeDescription
result.hotelsarrayHotel listings (when travel intent detected)
result.placesarrayGeneral places and locations

​
Hotel structure

Each hotel item includes:
FieldTypeDescription
namestringHotel name
urlstringHotel page URL
ratingnumberHotel rating (0-5)
num_reviewsnumberNumber of reviews
addressarrayAddress lines
phonestringPhone number
descriptionstringHotel description
image_urlstringMain hotel image URL
imagesarrayAdditional hotel image URLs
latnumberLatitude
lngnumberLongitude
price_levelstringPrice level indicator
categoriesarrayHotel categories

​
Place structure

Each place item includes:
FieldTypeDescription
namestringPlace name
urlstringPlace page URL
addressarrayAddress lines
ratingnumberPlace rating (0-5)
latnumberLatitude
lngnumberLongitude
categoriesarrayPlace categories
map_urlstringMap URL
imagesarrayPlace image URLs

​
Response example

{
  "success": true,
  "result": {
    "text": "Lisbon has several family-friendly hotels in central neighborhoods...",
    "hotels": [
      {
        "name": "Hotel Mundial",
        "url": "https://www.hotel-mundial.pt",
        "rating": 4.3,
        "num_reviews": 6421,
        "address": ["Praça Martim Moniz 2", "1100-341 Lisboa"],
        "phone": "+351 21 884 2000",
        "description": "Central family hotel with rooftop views.",
        "image_url": "https://example.com/mundial.jpg",
        "images": [
          "https://example.com/mundial-1.jpg",
          "https://example.com/mundial-2.jpg"
        ],
        "lat": 38.7167,
        "lng": -9.1357,
        "price_level": "$$",
        "categories": ["Hotel", "Family-friendly"]
      }
    ],
    "places": [
      {
        "name": "Belem Tower",
        "url": "https://www.patrimoniocultural.gov.pt/belem-tower",
        "address": ["Avenida Brasília", "Lisboa"],
        "rating": 4.6,
        "lat": 38.6916,
        "lng": -9.2160,
        "categories": ["Landmark", "UNESCO site"],
        "map_url": "https://maps.google.com/?cid=belem-tower",
        "images": ["https://example.com/belem.jpg"]
      }
    ]
  }
}