Tripadvisor Place Search

1 credit

Search restaurants, hotels, and attractions on Tripadvisor.

POST/api/v1/tools/tripadvisor/search

Parameters

searchModestring

Search mode: area, boundingBox, or nearby. Defaults to area.

locationstringrequired

Area text, supported area URL, or exact place ID/URL for nearby mode. Maximum 500 characters.

boundingBoxobject

Required in boundingBox mode. Object with north, south, east, and west coordinates.

placeTypesstring[]

Unique place types: restaurant, hotel, and attraction. Defaults to all three.

maxItemsPerTypenumber

Maximum results for each place type. Integer from 1 to 30. Defaults to 30.

restaurantFiltersobject[]

Up to 14 restaurant filter rules. Each rule has one supported field and value list.

restaurantSortstring

auto, popularity, relevance, or featured. Defaults to auto.

hotelFiltersobject[]

Up to 13 hotel filter rules. Each rule has one supported field and value list.

hotelSortstring

auto, bestValue, popularity, priceLowToHigh, or distanceFromCityCenter. Defaults to auto.

attractionFiltersobject[]

Up to eight attraction filter rules. Each rule has one supported field and value list.

attractionSortstring

auto, travelerFavorite, travelerRanked, featured, priceLowToHigh, priceHighToLow, durationShortToLong, or durationLongToShort.

currencystring

Three-letter uppercase currency code. Defaults to USD.

unitLengthstring

Distance unit: MILES or KILOMETERS. Defaults to MILES.

hotelStayobject

Hotel context with checkIn, checkOut, and one to 30 rooms. Each room has adults and optional childrenAges.

restaurantReservationobject

Restaurant context with date, 24-hour time, and partySize.

attractionVisitobject

Attraction context with date and one to five traveler groups. Each group has an ageBand and count.

Response Schema

dataobject

Tripadvisor place search result

placesobject[]

Normalized place records

countnumber

Places returned

partialboolean

Whether one place type failed

failuresobject[]

Per-type failures

metaobject

Request metadata

toolstring

Tool name (tripadvisor-places-search)

creditsUsednumber

Credits consumed (1)

requestIdstring

Unique request ID

Request

curl -X POST https://scraper.run/api/v1/tools/tripadvisor/search \
  -H "Authorization: Bearer sc_live_..." \
  -H "Content-Type: application/json" \
  -d '{
  "location": "Boston",
  "placeTypes": [
    "restaurant"
  ],
  "maxItemsPerType": 5,
  "restaurantSort": "popularity"
}'

Response Example

{
  "data": {
    "places": [
      {
        "contentId": "5572598",
        "contentType": "restaurant",
        "name": "Ostra",
        "url": "https://www.tripadvisor.com/Restaurant_Review-g60745-d5572598-Reviews-Ostra.html",
        "rating": 4.6,
        "reviewCount": 1140,
        "address": "Boston, Massachusetts"
      }
    ],
    "count": 1,
    "partial": false,
    "failures": []
  },
  "meta": {
    "tool": "tripadvisor-places-search",
    "creditsUsed": 1,
    "requestId": "req_abc123"
  }
}

curl -X POST https://scraper.run/api/v1/tools/tripadvisor/search \

-H "Authorization: Bearer sc_live_..." \

-H "Content-Type: application/json" \

-d '{

"location": "Boston",

"placeTypes": [

"restaurant"

"maxItemsPerType": 5,

"restaurantSort": "popularity"

{

"data": {

"places": [

{

"contentId": "5572598",

"contentType": "restaurant",

"name": "Ostra",

"url": "https://www.tripadvisor.com/Restaurant_Review-g60745-d5572598-Reviews-Ostra.html",

"rating": 4.6,

"reviewCount": 1140,

"address": "Boston, Massachusetts"

}

"count": 1,

"partial": false,

"failures": []

"meta": {

"tool": "tripadvisor-places-search",

"creditsUsed": 1,

"requestId": "req_abc123"

}