Skip to main content
This section documents the travel and location data returned by the Perplexity endpoint. Travel and location data are part of the Perplexity response — no separate API call is needed.

​
Example request

Travel and location 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": "Centrally located 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"]
      }
    ]
  }
}