List city properties (v1)
Returns one page of a city's hotels, restaurants or attractions on TripAdvisor, for a link to any of the city's pages. data is null when no list page was served.
1 credit / requestBilled only on success
Authorization
ApiKeyAuth x-api-key<token>
In: header
Query Parameters
city_url*string
Any TripAdvisor page for the city or region: its Hotels, Restaurants, Things to Do or main page. kind picks the list, whichever page the link is. Each row carries its own geo_id, which can differ from the city's.
Length
length <= 1000kind?string
Which of the city's three list pages to read. hotels and restaurants rows are fully populated; attractions rows carry only name and coordinates. See coverage on the response.
Default
"hotels"Value in
- "hotels"
- "restaurants"
- "attractions"
offset?|
TripAdvisor's own oa cursor. Moves in steps of 30: page two is offset=30. Must be a multiple of 30 — a non-multiple is rejected rather than rounded.
Range
0 <= value <= 2970Default
0curl -X GET "https://example.com/v1/tripadvisor/list?city_url=https%3A%2F%2Fwww.tripadvisor.com%2FHotels-g60713-San_Francisco_California-Hotels.html" \ -H "x-api-key: YOUR_API_KEY"{ "data": { "geo_id": 60713, "location_slug": "San_Francisco_California", "kind": "hotels", "offset": 0, "page_size": 30, "next_offset": 30, "count": 30, "item_list_order": "Descending", "coverage": "TripAdvisor publishes attractions as TouristAttraction, which carries only name and coordinates — no rating, review count, address or location id. Hotels and restaurants carry all of them.", "breadcrumbs": [ { "position": 1, "name": "United States", "url": "string" } ], "results": [ { "position": 1, "schema_type": "Hotel", "name": "InterContinental Mark Hopkins", "url": "https://www.tripadvisor.com/HotelHighlight-g60713-d115623-Reviews-InterContinental_Mark_Hopkins-San_Francisco_California.html", "geo_id": "60713", "location_id": "115623", "rating": 4.5, "rating_scale_max": 5, "review_count": 3309, "price_range": "$$$", "telephone": "+1 415-392-3434", "image": "string", "address": { "street_address": "999 California Street", "locality": "San Francisco", "region": "CA", "postal_code": "94108", "country": "US" }, "geo": { "latitude": 37.791553, "longitude": -122.41039 } } ] }, "details": { "reason": "no_results", "message": "string" }}