Endpoint Playground
Searches TripAdvisor hotels in the area given by the required `geo_id`. Filter with `class`, `amenities`, `price_min`, `price_max`, `pricing_mode`, `travelers_choice` and `currency`; page with `offset` and `limit`; order with `sort`. Each hotel has its title, URL, image, rating, review count, star rating, rank, price, provider, location and a review snippet when TripAdvisor supplies them.
14 Oct 2026: 3 results; 18 fields had a value in every checked item and 3 varied between items.
Sample value profiles: rating: 3.1 to 4.5, median 4.4; title: “Rambler Oasis Hotel” and 2 other values; url: tripadvisor.com.
curl "https://api.crawlora.net/api/v1/tripadvisor/hotels?geo_id=294217" \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| geo_id | integer | Yes | 294217 | TripAdvisor geo id |
| filter_id | string | No | Optional filter id such as class or ufe | |
| class | integer | No | Hotel class filter | |
| amenities | array | No | Amenity filter ids | |
| price_min | integer | No | Minimum price filter | |
| price_max | integer | No | Maximum price filter | |
| pricing_mode | string | No | Pricing mode | |
| travelers_choice | boolean | No | Filter Travelers' Choice properties | |
| travelers_choice_botb | boolean | No | Filter Best of the Best properties | |
| currency | string | No | Currency code | |
| offset | integer | No | Zero-based result offset | |
| limit | integer | No | Maximum results | |
| sort | string | No | Sort value |
{
"code": 200,
"msg": "OK",
"data": {
"geo_id": 294217,
"currency": "HKD",
"offset": 0,
"limit": 3,
"sort": "BEST_VALUE",
"total": 519,
"full_matches": 519,
"results": [
{
"id": "113311",
"title": "The Peninsula New York",
"type": "hotel",
"url": "https://www.tripadvisor.com/Hotel_Review-g60763-d113311-Reviews-The_Peninsula_New_York-New_York_City_New_York.html",
"image": "https://dynamic-media-cdn.tripadvisor.com/media/photo.jpg",
"rating": 4.5,
"review_count": 1517,
"star_rating": 5,
"rank": 146,
"rank_label": "#141 of 519 hotels in New York City",
"price": "HK$7,793",
"provider": "Agoda",
"currency": "HKD",
"parent": "New York City"
}
]
}
}The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.