$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
array
required
List · TripAdvisor place URLs to scrape reviews from.
integer
default:100
Number · Reviews per place. Use 0 for all.
date
Date picker · Stop loading reviews older than this date.
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★)array
default:["ALL_REVIEW_LANGUAGES"]
Multi-select · Filter to reviews in these languages. Leave empty for all.View all 183 options →
boolean
default:true
Toggle · Pull each reviewer’s name, profile pic, location, etc.
Response columns
| Field | Display name | Type |
|---|---|---|
placeUrl | Place URL | url |
reviewUrl | Review URL | url |
reviewTitle | Review Title | text |
reviewText | Review Text | text |
rating | Rating | rating |
helpfulVotes | Helpful Votes | number |
posted | Posted | text |
platform | Platform | text |
travelDate | Travel Date | text |
tripType | Trip Type | text |
language | Language | text |
ownerResponse | Owner Response | text |
responder | Responder | text |
responseDate | Response Date | text |
responseLanguage | Response Language | text |
responderRole | Responder Role | text |
reviewer | Reviewer | text |
reviewerUsername | Reviewer Username | text |
reviewerUrl | Reviewer URL | text |
reviewerAvatar | Reviewer Avatar | url |
reviewerContributions | Reviewer Contributions | number |
reviewerLocation | Reviewer Location | text |
placeName | Place Name | text |
placeWebsite | Place Website | url |
placeAddress | Place Address | text |
placeLocation | Place Location | text |
placeRating | Place Rating | rating |
placeReviews | Place Reviews | number |
latitude | Latitude | number |
longitude | Longitude | number |
city | City | text |
state | State | text |
country | Country | text |
postalCode | Postal Code | text |
5Count | 5★ Count | number |
4Count | 4★ Count | number |
3Count | 3★ Count | number |
2Count | 2★ Count | number |
1Count | 1★ Count | number |
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
}
}'
import requests
resp = requests.post(
"https://api.mindcase.co/api/v1/agents/tripadvisor/reviews/run",
headers={"Authorization": "Bearer mk_live_abc123def456"},
json={"params": {
"urls": [
{
"url": "https://www.tripadvisor.com/Hotel_Review-g60763-d113317-Reviews-The_Plaza-New_York_City_New_York.html"
}
],
"maxReviews": 10
}},
)
data = resp.json()
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
}
]
}