scraper
Back to API docs

Overview

  • Overview

APIs

  • POSTReviews

Tripadvisor Reviews

1 credit

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

POST/api/v1/tools/tripadvisor/reviews

Parameters

businessstringrequired

Tripadvisor URL or numeric location ID. 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 a positive integer. Defaults to 20. Upper bound is determined by your plan.

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 date. Format: YYYY-MM-DD. Forces mobile scraping path when set.

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".

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 due to a timeout. 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"
  }
}