Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.mindcase.co/llms.txt

Use this file to discover all available pages before exploring further.

$0.8 / 1k reviews Extract Tripadvisor reviews for specified places, with text, rating, dates, reviewer, owner responses, and place details

Endpoint

POST /api/v1/agents/tripadvisor/reviews/run

Parameters

urls
array
required
List · TripAdvisor place URLs to scrape reviews from.
maxResults
integer
default:100
Number · Reviews per place. Use 0 for all.
lastReviewDate
date
Date picker · Stop loading reviews older than this date.
reviewRatings
array
default:["ALL_REVIEW_RATINGS"]
Multi-select · Filter to reviews with these ratings. Leave empty for all.Options: 1, 2, 3, 4, 5Legend: 1 = Terrible (1★), 2 = Poor (2★), 3 = Average (3★), 4 = Very Good (4★), 5 = Excellent (5★)
reviewsLanguages
array
default:["ALL_REVIEW_LANGUAGES"]
Multi-select · Filter to reviews in these languages. Leave empty for all.View all 183 options →
includeReviewerInfo
boolean
default:true
Toggle · Pull each reviewer’s name, profile pic, location, etc.

Response columns

FieldDisplay nameType
placeUrlPlace URLurl
reviewUrlReview URLurl
reviewTitleReview Titletext
reviewTextReview Texttext
ratingRatingrating
helpfulVotesHelpful Votesnumber
postedPostedtext
platformPlatformtext
travelDateTravel Datetext
tripTypeTrip Typetext
languageLanguagetext
ownerResponseOwner Responsetext
responderRespondertext
responseDateResponse Datetext
responseLanguageResponse Languagetext
responderRoleResponder Roletext
reviewerReviewertext
reviewerUsernameReviewer Usernametext
reviewerUrlReviewer URLtext
reviewerAvatarReviewer Avatarurl
reviewerContributionsReviewer Contributionsnumber
reviewerLocationReviewer Locationtext
placeNamePlace Nametext
placeWebsitePlace Websiteurl
placeAddressPlace Addresstext
placeLocationPlace Locationtext
placeRatingPlace Ratingrating
placeReviewsPlace Reviewsnumber
latitudeLatitudenumber
longitudeLongitudenumber
cityCitytext
stateStatetext
countryCountrytext
postalCodePostal Codetext
5Count5★ Countnumber
4Count4★ Countnumber
3Count3★ Countnumber
2Count2★ Countnumber
1Count1★ Countnumber

Example

curl -X POST https://api.mindcase.co/api/v1/agents/tripadvisor/reviews/run \
  -H "Authorization: Bearer mk_live_abc123def456" \
  -H "Content-Type: application/json" \
  -d '{
  "params": {
    "urls": [
      {
        "url": "https://www.tripadvisor.com/Hotel_Review-g60763-d113317-Reviews-The_Plaza-New_York_City_New_York.html"
      }
    ],
    "maxReviews": 10
  }
}'

Example response

Response
{
  "job_id": "job_7f3a2b1c",
  "status": "completed",
  "data": [
    {
      "placeUrl": "https://www.tripadvisor.com/Hotel_Review-g60763-d113317-Reviews-Casablanca_Hotel_By_Library_Hotel_Collection-New_York_City_New_York.html",
      "reviewUrl": "https://www.tripadvisor.com/ShowUserReviews-g60763-d113317-r1057857986-Casablanca_Hotel_By_Library_Hotel_Collection-New_York_City_New_York.html",
      "reviewTitle": "Hesitating to say how much we like it because we want to be able to get a reservation for the next visit to NYC.",
      "reviewText": "Spacious room with plentiful surfaces, normal size closet, dresser with drawers and plentiful shelf space in roomy bathroom so you can lay out your toiletries and operate without banging into your partner.  Good lighting that you can adjust to suit your preference in bedroom (overhead not necessary if it isn\u2019t your preference). Good wall sconces for reading in bed. Abundant lighting and large mirrors in bathroom (including full length on inside of bathroom door). Somewhat slow but reliable elevators. Friendly, very customer-service oriented staff in every role: reception, bellman, breakfast team and housekeeping. Extra towels delivered quickly upon request, extra blanket and pillow in the closet, along with mini fridge they will plug in if requested. Also, a safe. Laundry service and room service from Tony\u2019s next door available. Flat screen TV in the room but no annoying message from the hotel playing when you walk into your room.\n\nGreat restaurant recommendations from staff as well as walking tips to avoid crowds if you are in a hurry or just sick of navigating through clumps of student groups and tourists clogging/gawking/snapping photos in Times Square. Felt very safe to be walking around after 11pm in Times Square and surrounding areas. This is NOT the Times Square of the 1970\u2019s! \n\nPleasant lounge/sitting room/Rick\u2019s cafe with TV so you can spread out at a dining table outside breakfast service to work in a semi-public space, play a game or work a puzzle or sit and scroll your device in a comfy chair with tea, coffee, seltzer, hot chocolate, cappuccino (with caffein and decaf) and baked goods and fruit all day and night. Saw guests holding small business meetings in the cafe, free WiFi and NYTimes for guests and access to nearby sports club for $17/day fee (didn\u2019t use - too much to do in NYC). Very reasonable day rate for the City. So close to Times Square Subway stop where you can go in every direction, including to LIRR or MetroNorth or the Staten Island Ferry which is still free and departs on the hour and half hour, where you pass the Statue of Liberty in NY harbor which remains a  symbol of our American Democracy that welcomes immigrants and qualified refugees. \n\n24 hour chemist/drug store and sit down-eat in eateries within two blocks of hotel, including NY\u2019s famous hot dog, pretzel, halal food and breakfast sandwich street vendors and plentiful public benches on 6th Ave and cafe tables in pedestrian zone in Times Square on which to sit while you enjoy the flavors and sights of the \u2018greatest city in the world\u2019. Though located just steps from the lights and crowds of Times Square, the hotel feels like a quiet oasis.  Easy entry (a door person always at front entrance to welcome you and provide security and eager to assist with luggage) and saw a guest in a big wheelchair, so clearly accessible no matter the mobility needs of visitors. Continental breakfast more than adequate. The same every day so you might want to go out to breakfast to change up the menu during a lengthy stay but the staff will heat up a bowl of instant oatmeal and add dried cranberries and slice banana if you request it. Cinnamon and whole milk at Coffee Bar and almond milk if you ask for it. Cereal, hard boiled eggs, pastries, yogurts. All replenished with a smile.\n\nWe were thoroughly satisfied with our 4 night stay and will return any time we are going to the theater in theater district in NYC. Too convenient - just minutes to most theaters. The Todd Haines Theater, performance space for Roundabout Theater Company is probably the furthest away to the north within theater district. Close to Diamond District, Garment District (including so many findings stores!), MOMA, Rockefeller Center and The NY Public Library/Bryant Park if you have NYC walking stamina. Lincoln Center is just a couple of Subway stops away. You just need a device with a chip in it to enter subway, no metrocard necessary. With only about 50 rooms, the service feels personal rather than the impersonal service you get at large chain hotels. Oh, and check out the lovely little outdoor courtyard adjacent to lounge area - which also has an upright piano!",
      "rating": 5,
      "helpfulVotes": 0,
      "posted": "2026-04-25",
      "platform": "MOBILE",
      "travelDate": "2026-04",
      "tripType": "COUPLES",
      "language": "en",
      "ownerResponse": null,
      "responder": null,
      "responseDate": null,
      "responseLanguage": null,
      "responderRole": null,
      "reviewer": "jb",
      "reviewerUsername": "Guide63525592608",
      "reviewerUrl": "www.tripadvisor.com/Profile/Guide63525592608",
      "reviewerAvatar": "https://dynamic-media-cdn.tripadvisor.com/media/photo-o/1a/f6/f1/b8/default-avatar-2020-22.jpg",
      "reviewerContributions": 7,
      "reviewerLocation": "Boston, Massachusetts",
      "placeName": "Casablanca Hotel By Library Hotel Collection",
      "placeWebsite": "https://casablancahotel.com/",
      "placeAddress": "147 West 43rd Street, New York City, NY 10036-6575",
      "placeLocation": "New York City, New York",
      "placeRating": 4.8,
      "placeReviews": 7778,
      "latitude": 40.756447,
      "longitude": -73.98551,
      "city": "New York City",
      "state": "NY",
      "country": "United States",
      "postalCode": "10036-6575",
      "5Count": 6712,
      "4Count": 847,
      "3Count": 133,
      "2Count": 52,
      "1Count": 34
    }
  ]
}