scraper
Back to API docs

Overview

  • Overview

APIs

  • POSTReviews
  • POSTPlace Search
  • POSTPlace Detail

Tripadvisor Reviews

1 credit

Get reviews for hotels, restaurants, and attractions from Tripadvisor.

POST/api/v1/tools/tripadvisor/reviews

Parameters

businessstringrequired

Tripadvisor-host URL or numeric location ID. IDs must be integers from 1 to 2147483647. Accepts a full URL like "https://www.tripadvisor.com/Hotel_Review-g60763-d209422-..." or a plain location ID like "209422".

maxReviewsnumber

Maximum number of reviews to return. Must be an integer from 1 to 100000. Defaults to 20. Your plan can set a lower limit.

numberOfPagesnumber

Maximum number of upstream review pages to read. Must be a positive integer.

languagestring

Filter reviews by language code. Defaults to "all" (no language filter). Whitespace-only values are treated as "all".

ratingnumber[]

Filter by star rating. Array of integers from 1 to 5. Omit for all ratings.

tripTypestring[]

Filter by trip type. Array of values: "Business", "Couples", "Family", "Friends", "Solo". Omit for all trip types.

sincestring

Only return reviews published on or after this real calendar date. Format: YYYY-MM-DD. This uses the mobile path and requires sortBy "recent".

monthsnumber[]

Filter by month of visit. Array of integers from 1 (January) to 12 (December). Omit for all months.

searchQuerystring

Keyword search within review text. Omit or leave empty to skip keyword filtering.

sortBystring

Sort order for reviews. One of "recent" (newest first), "detailed" (most favorable rating), or "highest" (highest rating). Defaults to "recent". A non-recent order fails if the web source is unavailable because the mobile fallback cannot preserve it.

fieldsstring[]

Fields to include per review. Omit for defaults: id, rating, title, text, publishedDate, author, helpfulVotes, ownerResponse. Use ["*"] for all fields. Available fields: id, rating, title, text, publishedDate, author, helpfulVotes, ownerResponse, locationId, businessName, businessUrl, dateVisited, tripType, subratings, photos, reviewUrl, placeType, accommodationCategory, isTranslated, tipText, createdDate, publishedDateISO, dateVisitedISO, language, originalLanguage, status, publishPlatform, translationType, reviewTips, ownerResponseDetail, scrapedAt.

Response Schema

dataobject

Tripadvisor reviews result

businessobject

Business information

reviewsobject[]

Array of review objects. Fields depend on the fields parameter. Default fields: id, rating, title, text, publishedDate, author, helpfulVotes, ownerResponse.

countnumber

Number of reviews returned

sourcestring

Scraping path used: "web" or "mobile"

truncatedboolean

True if results were cut short by the request deadline, a later upstream failure, malformed rows, or a pagination problem. Only present when truncation occurred.

metaobject

Request metadata

toolstring

Tool name (tripadvisor-reviews)

creditsUsednumber

Credits consumed (1)

requestIdstring

Unique request ID

Request

curl -X POST https://scraper.run/api/v1/tools/tripadvisor/reviews \
  -H "Authorization: Bearer sc_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "business": "https://www.tripadvisor.com/Hotel_Review-g60763-d209422-Reviews-The_Plaza-New_York_City_New_York.html",
    "maxReviews": 10,
    "rating": [4, 5],
    "sortBy": "recent"
  }'

Response Example

{
  "data": {
    "business": {
      "locationId": 209422,
      "name": "The Plaza",
      "url": "https://www.tripadvisor.com/Hotel_Review-g60763-d209422-Reviews-The_Plaza-New_York_City_New_York.html"
    },
    "reviews": [
      {
        "id": "987654321",
        "rating": 5,
        "title": "Exceptional stay in every way",
        "text": "From check-in to check-out, the staff went above and beyond. The room had a stunning view of Central Park and the afternoon tea was superb.",
        "publishedDate": "April 2026",
        "author": {
          "displayName": "TravellerJane",
          "hometown": "London, UK",
          "totalContributions": 48
        },
        "helpfulVotes": 7,
        "ownerResponse": "Thank you for your wonderful review, Jane! We hope to welcome you back soon."
      },
      {
        "id": "876543210",
        "rating": 4,
        "title": "Beautiful hotel, great location",
        "text": "The hotel is stunning and the location is perfect for exploring Midtown. Service was mostly excellent, though breakfast was a bit slow.",
        "publishedDate": "March 2026",
        "author": {
          "displayName": "Marco R.",
          "hometown": "Rome, Italy",
          "totalContributions": 22
        },
        "helpfulVotes": 3,
        "ownerResponse": null
      }
    ],
    "count": 2,
    "source": "web"
  },
  "meta": {
    "tool": "tripadvisor-reviews",
    "creditsUsed": 1,
    "requestId": "req_abc123"
  }
}