TripAdvisor Listings

$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

inputs

array

required

List · One per line. You can input location names / keywords (e.g. ‘Paris’, ‘Eiffel Tower’) or TripAdvisor URLs (search or location pages).

maxResults

integer

default:50

Number · Places per query / URL. Use 0 for all.

placeTypes

array

default:["attractions","restaurants","hotels"]

Multi-select · Which kinds of places to include.Options: attractions, restaurants, hotelsLegend: attractions = Attractions (museums, parks, things to do), restaurants = Restaurants, hotels = Hotels

includeNearbyResults

boolean

default:false

Toggle · Also include places nearby that didn’t strictly match your search.

checkInDate

date

Date picker · Hotel-only: check-in date for room pricing.

checkOutDate

date

Date picker · Hotel-only: check-out date for room pricing.

includePriceOffers

boolean

default:false

Toggle · Pull bookable hotel offers (depends on check-in / check-out dates).

language

string

default:"en"

Dropdown · Language for the listing data.View all 183 options →

currency

string

default:"USD"

Dropdown · Currency for prices.View all 119 options →

includeTags

boolean

default:true

Toggle · Pull review category tags (e.g. “Family-friendly”, “Romantic”).

maxPhotosPerPlace

integer

Number · Photos to fetch per place. Use 0 for all.

photosType

string

default:"fromEveryone"

Dropdown · Which photo source to pull from.Options: fromEveryone, fromManagement, fromTravelersLegend: 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

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
  }
}'

Example response

Response

{
  "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"
    }
  ]
}

Agents

Jobs

Endpoint

Parameters

Response columns

Example

Example response

Agents

Jobs

Documentation Index

​Endpoint

​Parameters

​Response columns

​Example

​Example response

Endpoint

Parameters

Response columns

Example

Example response