> ## Documentation Index
> Fetch the complete documentation index at: https://mindcase.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# TripAdvisor Listings
> Extract Tripadvisor data on hotels, restaurants, attractions, pricing, and ratings, requiring no input
`$2 / 1k listings`
Extract Tripadvisor data on hotels, restaurants, attractions, pricing, and ratings, requiring no input
## Endpoint
`POST /api/v1/agents/tripadvisor/listings/run`
## Parameters
**List** · One per line. You can input location names / keywords (e.g. 'Paris', 'Eiffel Tower') or TripAdvisor URLs (search or location pages).
**Number** · Places per query / URL. Use 0 for all.
**Multi-select** · Which kinds of places to include.
**Options:** `attractions`, `restaurants`, `hotels`
*Legend: `attractions` = Attractions (museums, parks, things to do), `restaurants` = Restaurants, `hotels` = Hotels*
**Toggle** · Also include places nearby that didn't strictly match your search.
**Date picker** · Hotel-only: check-in date for room pricing.
**Date picker** · Hotel-only: check-out date for room pricing.
**Toggle** · Pull bookable hotel offers (depends on check-in / check-out dates).
**Dropdown** · Language for the listing data.
[View all 183 options →](/agents/tripadvisor/listings/values#language)
**Dropdown** · Currency for prices.
[View all 119 options →](/agents/tripadvisor/listings/values#currency)
**Toggle** · Pull review category tags (e.g. "Family-friendly", "Romantic").
**Number** · Photos to fetch per place. Use 0 for all.
**Dropdown** · Which photo source to pull from.
**Options:** `fromEveryone`, `fromManagement`, `fromTravelers`
*Legend: `fromEveryone` = From Everyone, `fromManagement` = From Management, `fromTravelers` = From Travelers*
## Response columns
| Field | Display name | Type |
| ------------------- | ------------------- | -------- |
| `tripadvisorUrl` | TripAdvisor URL | url |
| `name` | Name | text |
| `localName` | Local Name | text |
| `description` | Description | text |
| `type` | Type | text |
| `category` | Category | text |
| `subcategories` | Subcategories | text |
| `address` | Address | text |
| `localAddress` | Local Address | text |
| `location` | Location | text |
| `phone` | Phone | phone |
| `email` | Email | email |
| `website` | Website | url |
| `photo` | Photo | url |
| `amenities` | Amenities | text |
| `hotelClass` | Hotel Class | text |
| `classAttribution` | Class Attribution | text |
| `rooms` | Rooms | number |
| `reviews` | Reviews | number |
| `rating` | Rating | rating |
| `rank` | Rank | number |
| `of` | Of | text |
| `rankingString` | Ranking String | text |
| `rawRanking` | Raw Ranking | number |
| `priceLevel` | Price Level | text |
| `priceRange` | Price Range | text |
| `quotedPrice` | Quoted Price | text |
| `perNight` | Per Night | currency |
| `originalPrice` | Original Price | text |
| `tax` | Tax | currency |
| `provider` | Provider | text |
| `vendor` | Vendor | text |
| `payInInstallments` | Pay In Installments | boolean |
| `5Count` | 5★ Count | number |
| `4Count` | 4★ Count | number |
| `3Count` | 3★ Count | number |
| `2Count` | 2★ Count | number |
| `1Count` | 1★ Count | number |
| `tipRating` | Tip Rating | rating |
| `nearestMetro` | Nearest Metro | text |
| `metroAddress` | Metro Address | text |
| `metroDistance` | Metro Distance | number |
| `city` | City | text |
| `neighborhood` | Neighborhood | text |
| `cityDetail` | City (Detail) | text |
| `state` | State | text |
| `country` | Country | text |
| `postalCode` | Postal Code | text |
| `street` | Street | text |
| `photoCount` | Photo Count | number |
| `latitude` | Latitude | number |
| `longitude` | Longitude | number |
| `checkInDate` | Check-In Date | text |
| `checkOutDate` | Check-Out Date | text |
| `nearbyResult` | Nearby Result | boolean |
| `localLanguage` | Local Language | text |
## Example
```bash curl theme={null}
curl -X POST https://api.mindcase.co/api/v1/agents/tripadvisor/listings/run \
-H "Authorization: Bearer mk_live_abc123def456" \
-H "Content-Type: application/json" \
-d '{
"params": {
"query": "Chicago",
"maxResults": 10,
"language": "en",
"currency": "USD",
"maxPhotosPerPlace": 0
}
}'
```
```python Python theme={null}
import requests
resp = requests.post(
"https://api.mindcase.co/api/v1/agents/tripadvisor/listings/run",
headers={"Authorization": "Bearer mk_live_abc123def456"},
json={"params": {
"query": "Chicago",
"maxResults": 10,
"language": "en",
"currency": "USD",
"maxPhotosPerPlace": 0
}},
)
data = resp.json()
```
### Example response
```json Response theme={null}
{
"job_id": "job_7f3a2b1c",
"status": "completed",
"data": [
{
"tripadvisorUrl": "https://www.tripadvisor.com/Hotel_Review-g35805-d20951654-Reviews-Nobu_Hotel_Chicago-Chicago_Illinois.html",
"name": "Nobu Hotel Chicago",
"localName": "Nobu Hotel Chicago",
"description": "Nestled amidst the energy of Fulton Market restaurant district and steps to the financial center of the City, Nobu Hotel Chicago delivers the perfect blend of industrial chic and Japanese simplicity. The hotel offers 115 guest rooms and suites, a world-renowned Nobu restaurant, Nobu rooftop bar, naturally lit event space overlooking the City, a tranquil heated swimming pool, mens and womens separate steam rooms and a fitness gym with Technogym equipment.",
"type": "HOTEL",
"category": "hotel",
"subcategories": [
"Hotel"
],
"address": "155 N. Peoria Street, Chicago, IL 60607",
"localAddress": "155 N. Peoria Street, 60607",
"location": "Chicago, Illinois",
"phone": "0013127798888",
"email": "guestservices@nobuhotelchicago.com",
"website": "http://chicago.nobuhotels.com/",
"photo": null,
"amenities": [
"Pool",
"Suites",
"Room service",
"Wheelchair access",
"Restaurant",
"Bar/Lounge",
"Pets Allowed",
"Dry Cleaning",
"Non-smoking rooms",
"Fitness center",
"Laundry Service",
"Banquet Room",
"Air conditioning",
"Refrigerator in room",
"Minibar",
"Non-smoking hotel",
"Safe",
"Rooftop Bar",
"Rooftop Terrace",
"Indoor pool",
"Breakfast Available",
"Housekeeping",
"Baggage Storage",
"Bath / Shower",
"Bathrobes",
"Blackout Curtains",
"Bottled Water",
"Breakfast in the Room",
"Bridal Suite",
"24-Hour Check-in",
"Coffee / Tea Maker",
"Complimentary Tea",
"Desk",
"Doorperson",
"English",
"Fitness / Spa Locker Rooms",
"Complimentary Instant Coffee",
"Complimentary Toiletries",
"24-Hour Front Desk",
"Hair Dryer",
"Interconnected room(s) available",
"Ironing Service",
"Pool / Beach Towels",
"Seating Area",
"24-Hour Security",
"Snack Bar",
"Internet",
"Free Internet",
"Wifi",
"Public Wifi",
"Meeting rooms",
"Concierge",
"Conference Facilities",
"Heated pool",
"Flatscreen TV",
"Parking",
"Facilities for Disabled Guests",
"Kids Stay Free",
"Sauna",
"Aerobics Off-site",
"ATM On Site",
"Bidet",
"Bowling Off-site",
"Cable / Satellite TV",
"Car Hire",
"Express Check-in / Check-out",
"Children's Television Networks",
"Clothes Rack",
"Dining Area",
"Electric Kettle",
"First Aid Kit",
"French",
"Happy Hour",
"Highchairs Available",
"Iron",
"Landmark View",
"Laptop Safe",
"Newspaper",
"On-Demand Movies",
"Outdoor Dining Area",
"Outdoor Furniture",
"Patio",
"Private Bathrooms",
"Paid Private Parking Nearby",
"Paid Public Parking Nearby",
"Separate Living Room",
"Shallow End",
"Spanish",
"Steam Room",
"Street Parking",
"Sun Deck",
"Taxi Service",
"Telephone",
"Umbrella",
"Valet Parking",
"Wake Up Service / Alarm Clock",
"Walk-in Shower",
"Walking Tours",
"Wardrobe / Closet",
"Wine / Champagne"
],
"hotelClass": "5.0",
"classAttribution": "This property is classified according to Giata.",
"rooms": 115,
"reviews": 509,
"rating": 4.9,
"rank": 1,
"of": "215",
"rankingString": "#1 of 215 hotels in Chicago",
"rawRanking": 4.876439094543457,
"priceLevel": "$$$$",
"priceRange": "$424 - $1,025",
"quotedPrice": null,
"perNight": null,
"originalPrice": null,
"tax": null,
"provider": null,
"vendor": null,
"payInInstallments": null,
"5Count": 466,
"4Count": 27,
"3Count": 5,
"2Count": 6,
"1Count": 5,
"tipRating": null,
"nearestMetro": null,
"metroAddress": null,
"metroDistance": null,
"city": null,
"neighborhood": null,
"cityDetail": "Chicago",
"state": "IL",
"country": "United States",
"postalCode": "60607",
"street": "155 N. Peoria Street",
"photoCount": 365,
"latitude": 41.884686,
"longitude": -87.64946,
"checkInDate": "2026-05-02",
"checkOutDate": "2026-05-03",
"nearbyResult": false,
"localLanguage": "en-US"
}
]
}
```