> ## Documentation Index
> Fetch the complete documentation index at: https://cloro.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Travel and places

> Schema for hotel listings and place cards returned by the Perplexity endpoint when travel intent is detected, including pricing, ratings, and amenities.

This section documents the **travel and places** data returned by the [Perplexity endpoint](/api-reference/endpoint/monitor-perplexity). 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.

```json theme={null}
{
  "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. Hotels and places appear in the order Perplexity ranks them; array index `0` is the top result for each type.

<Frame caption="Location data in Perplexity">
  <img src="https://mintcdn.com/cloro/Qv2xgJAgMecwTTRq/images/perplexity/location-data.webp?fit=max&auto=format&n=Qv2xgJAgMecwTTRq&q=85&s=23f117f924be206a85abd2c5341c5ab4" alt="Location data in Perplexity" width="1530" height="1422" data-path="images/perplexity/location-data.webp" />
</Frame>

## Travel data structure

| Field           | Type  | Description                                  |
| --------------- | ----- | -------------------------------------------- |
| `result.hotels` | array | Hotel listings (when travel intent detected) |
| `result.places` | array | General places and locations                 |

## Hotel structure

Each hotel item includes:

| 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

Each place item includes:

| 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

```json theme={null}
{
  "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"]
      }
    ]
  }
}
```