Perplexity travel and places schema

This section documents the travel and places data returned by the Perplexity endpoint: when Perplexity detects a travel-intent query it returns structured hotel listings in result.hotels and general place data in result.places, part of the Perplexity response so no separate API call is needed. Hotels and places appear in the order Perplexity ranks them; array index 0 is the top result for each type. For use cases, pricing context, and copy-paste examples, see the Perplexity shopping API page on the product site.

Example request

Travel and places data is intent-detected; no flag is required.

{
  "prompt": "best hotels in Lisbon for families",
  "country": "PT"
}

Hotel structure

Field	Type	Description
`name`	string	Hotel name
`url`	string	Hotel page URL
`rating`	number	Hotel rating (0-5)
`num_reviews`	number	Number of reviews
`address`	array	Address lines
`phone`	string	Phone number
`description`	string	Hotel description
`image_url`	string	Main hotel image URL
`images`	array	Additional hotel image URLs
`lat`	number	Latitude
`lng`	number	Longitude
`price_level`	string	Price level indicator
`categories`	array	Hotel categories

Place structure

Field	Type	Description
`name`	string	Place name
`url`	string	Place page URL
`address`	array	Address lines
`rating`	number	Place rating (0-5)
`lat`	number	Latitude
`lng`	number	Longitude
`categories`	array	Place categories
`map_url`	string	Map URL
`images`	array	Place 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"]
      }
    ]
  }
}

⌘I

Overview

ChatGPT

Google

Perplexity

Copilot

AI Mode

Grok

Gemini

Google News

Utilities

Perplexity travel and places schema

Example request

Hotel structure

Place structure

Response example

​Example request

​Hotel structure

​Place structure

​Response example

Example request

Hotel structure

Place structure

Response example