TripAdvisor Reviews API
Scrape TripAdvisor Reviews data with one API call. Returns a unified ReviewList of traveler reviews for a TripAdvisor place, keyed by its `url_path` (`entity_id` on every review). Each review carries the star rating, full text, title, reviewer profile, attached photos, owner/management `responses[]`, the original + translated language (TripAdvisor auto-translates — a `translated` flag marks it), and publish date. Get the `url_path` from /v1/tripadvisor/search. Filter by traveler rating, traveler type, or a keyword. The synchronous endpoint caps `depth` at 30 (deeper history is a future async surface); a place with no matching reviews returns 404 (auto-refunded). Sourced from DataForSEO's task-based Business Data API (first calls ~15-45s, then cached).
Last updated August 2026Maintained by the SocialCrawl team
Returns traveler reviews for a TripAdvisor place: star rating, title, full text, reviewer, photos, management replies, language, and publish date.
Use it once search has given you a place's url_path. Filter by rating, traveler type, or keyword when you want one slice of the reviews.
Searching 48 platforms in parallel
What can you do with the Reviews API?
The Reviews endpoint gives you structured TripAdvisor data with computed fields in a single request. No scraping infrastructure to build or maintain.
Example Request
curl -H "x-api-key: YOUR_API_KEY" \
"https://www.socialcrawl.dev/v1/tripadvisor/reviews?url_path=Hotel_Review-g60763-d23462501-Reviews-Margaritaville_Times_Square-New_York_City_New_York.html"import requests
response = requests.get(
"https://www.socialcrawl.dev/v1/tripadvisor/reviews",
params={
'url_path': 'Hotel_Review-g60763-d23462501-Reviews-Margaritaville_Times_Square-New_York_City_New_York.html',
},
headers={"x-api-key": "YOUR_API_KEY"},
)
data = response.json()const response = await fetch(
"https://www.socialcrawl.dev/v1/tripadvisor/reviews?url_path=Hotel_Review-g60763-d23462501-Reviews-Margaritaville_Times_Square-New_York_City_New_York.html",
{
headers: { "x-api-key": "YOUR_API_KEY" },
},
);
const data = await response.json();Parameters
| Parameter | Required | Description |
|---|---|---|
| url_path | Yes | The TripAdvisor `url_path` of the place (from a search result), e.g. 'Hotel_Review-g60763-d23462501-Reviews-Margaritaville_Times_Square-New_York_City_New_York.html'. |
| depth | No | Number of reviews to retrieve (multiples of 10, default 10, max 30 on this synchronous endpoint). |
| sort_by | No | Review ordering: `most_recent` or `detailed_reviews`. (most_recent | detailed_reviews) |
| rating | No | Filter by traveler rating bucket: excellent | very_good | average | poor | terrible. (excellent | very_good | average | poor | terrible) |
| visit_type | No | Filter by traveler type: families | couples | solo | business | friends. (families | couples | solo | business | friends) |
| search_reviews_keyword | No | Only return reviews containing this keyword. |
| translate | No | Translate reviews to the place's domain language (default true). The `translated` flag + `original_language` are always returned. |
What does the TripAdvisor Reviews API return?
Every response follows one unified schema. Here is a real, unmodified response body, so you can see the exact fields you get back before spending a credit.
Example response
{
"success": true,
"platform": "tripadvisor",
"endpoint": "/v1/tripadvisor/reviews",
"data": {
"items": [
{
"review": {
"id": "1069450429",
"entity_id": "Hotel_Review-g60763-d23462501-Reviews-Margaritaville_Times_Square-New_York_City_New_York.html",
"url": "https://www.tripadvisor.com/ShowUserReviews-g60763-d23462501-r1069450429-Margaritaville_Resort_Times_Square-New_York_City_New_York.html",
"title": "Beautiful rooms, Beautiful hotel.",
"text": "SO clean\nSO quiet\nBeautifully decorated.\n\nONLY ONLY downfall is the elevators have no ac. \n\nStill, I would return in a heart beat.",
"rating": {
"value": 5,
"max": 5
},
"author": {
"name": "Monika Hoffman",
"avatar_url": "https://dynamic-media-cdn.tripadvisor.com/media/photo-o/1a/f6/e9/60/default-avatar-2020-64.jpg",
"url": "https://www.tripadvisor.com/Profile/moniihxo",
"location": "Toronto, Canada",
"reviews_count": 8
},
"helpful_votes": null,
"verified": null,
"source": null,
"language": "en",
"original_language": "en",
"translated": false,
"images": null,
"responses": [
{
"id": "1070145994",
"author": "Valentyna M",
"text": "Dear Guest,\n\nThank you for the fantastic review!\n\nWe’re delighted you enjoyed our beautiful rooms, sparkling clean spaces, peaceful atmosphere, and tropical décor. We appreciate your feedback about the elevators and will share it with our team.\n\nWe can’t wait to welcome you back for another Margaritaville escape in the heart of Times Square!\n\nWarm regards,\n\nValentyna Muravyk\nValentyna.Muravyk@margaritavilleresortnyc.com",
"published_at": "2026-07-26 00:00:00 +00:00"
}
],
"published_at": "2026-07-21 00:00:00 +00:00"
}
},
{
"review": {
"id": "1042829859",
"entity_id": "Hotel_Review-g60763-d23462501-Reviews-Margaritaville_Times_Square-New_York_City_New_York.html",
"url": "https://www.tripadvisor.com/ShowUserReviews-g60763-d23462501-r1042829859-Margaritaville_Resort_Times_Square-New_York_City_New_York.html",
"title": "Excellent hotel!",
"text": "We stay here whenever we visit NYC. The location is excellent; it is walking distance to Penn Station, Bryant Park, Rockefeller Center, and the Broadway theaters. The hotel itself is beautiful and immaculate. The theming is fun. The entire staff is wonderful. Housekeeping does an amazing job. All-in-all, an extremely pleasant place to stay.",
"rating": {
"value": 5,
"max": 5
},
"author": {
"name": "Daryl1961",
"avatar_url": null,
"url": "https://www.tripadvisor.com/Profile/Daryl1961",
"location": null,
"reviews_count": 22
},
"helpful_votes": null,
"verified": null,
"source": null,
"language": "en",
"original_language": "en",
"translated": false,
"images": null,
"responses": [
{
"id": "1043250289",
"author": "Valentyna M",
"text": "Dear Daryl,\n\nThank you so much for taking the time to share your wonderful feedback! We are thrilled to hear that you consistently choose to stay with us whenever you visit NYC and that our location, cleanliness, and theming contributed to a memorable stay. It’s also fantastic to know that our team, especially housekeeping, made such a positive impression.\n\nWe truly appreciate your kind words and look forward to welcoming you back on your next trip to the city!\n\nWarm regards,\n\nValentyna Muravyk\nValentyna.Muravyk@margaritavilleresortnyc.com",
"published_at": "2025-12-21 00:00:00 +00:00"
}
],
"published_at": "2025-12-17 00:00:00 +00:00"
}
}
],
"total": 10,
"dropped": 0
},
"credits_used": 1,
"credits_remaining": 9999,
"request_id": "req_example000000",
"cached": false,
"pagination": {
"next_cursor": null,
"has_more": false,
"page_size": 10
}
}Live sample illustrating the unified response shape. Field values reflect the record you query.
How does the TripAdvisor Reviews API work?
Send a GET request with your API key and get back clean, structured JSON in our unified schema. Supported computed fields are populated when the source provides the required inputs.
Method
GET
Response
JSON
How do you scrape social media data in seconds?
The fastest social media scraping API for developers. Scrape profiles, posts, comments, and analytics from 48 platforms covering 10B+ monthly active users.
One schema, every platform
Query 48 platforms with identical response structures. Write your integration once.
Computed fields, not just scraped
When an endpoint supports these metrics and the source provides the required inputs, the normalized record includes engagement_rate, estimated_reach, content_category, and language — ready to use.
See your data before you code
Visual Data Explorer — paste any URL, get rich result cards, sortable tables, CSV export.
import requests
response = requests.get(
'https://www.socialcrawl.dev/v1/tiktok/profile',
params={'handle': 'charlidamelio'},
headers={'x-api-key': 'sc_YOUR_API_KEY'}
)
data = response.json(){
"success": true,
"platform": "tiktok",
"data": {
"author": {
"username": "charlidamelio",
"followers": 152400000
},
"engagement": {
"likes": 12400000000,
"engagement_rate": 0.087
},
"metadata": {
"language": "en",
"content_category": "lifestyle"
}
}
}Have a question? We got answers
Find answers to frequently asked questions about SocialCrawl's API, pricing, and capabilities.
Contact usHow do I use the TripAdvisor Reviews API?
What fields does each TripAdvisor review include?
Can I filter TripAdvisor reviews by rating or traveler type?
How many TripAdvisor reviews can I pull per request?
Does the API translate TripAdvisor reviews?
What happens if a place has no matching reviews?
Ask AI about SocialCrawl
Ready to scrape TripAdvisor Reviews data?
Get your API key and start pulling TripAdvisor data in under 60 seconds.
