Tripadvisor Scraper

Scrape Tripadvisor.com — hotels, restaurants, attractions and vacation rentals — from a single Actor. Six purpose-built endpoints: autocomplete, free-text location resolver, paginated hotel search (geoId / coordinates / polygon), full details by locationId or Tripadvisor URL, and traveler reviews by locationId. Backed by realtyapi.io's real-time Tripadvisor API.

⭐️ Found this useful? Please leave 5 stars! Issues / requests: 📬 oneapi.project@gmail.com

---

What you can do

Section	What it does	Input format
🔍 Autocomplete	Tripadvisor typeahead — resolves any partial query to canonical locationId + name + parent geo + photo + URL. Filter by vertical (Hotels, Restaurants, Attractions, Vacation Rentals, Geos, Airports, Cruises).	free text, one per line
📍 Search by Location	Deterministic free-text resolver: text → locationId → enriched detail (lat/lng, parent geo, official URL, photos).	Paris, France, New York City, etc.
🏨 Search Hotels	Paginated hotel search with rating, review count, price range, ranking, address, phone, photo, and Tripadvisor URL per row.	geoId digits, lat,lng,radius_mi, or lat,lng;lat,lng;... polygon (≥3 pts)
ℹ️ Details by ID	Full location detail for any Tripadvisor locationId (city / hotel / restaurant / attraction / vacation rental).	digits, one per line
🔗 Details by URL	Same details by parsing the -dXXXXX id out of any Tripadvisor /Hotel_Review-..., /Restaurant_Review-..., /Attraction_Review-... or /VacationRentalReview-... URL.	full Tripadvisor URL
⭐ Reviews by ID	Traveler reviews per locationId — author, date, rating, title, body, trip type, owner response.	digits + Reviews entity type (HOTEL / RESTAURANT / ATTRACTION / VACATION_RENTAL)

Fill any combination of sections in a single run — leave the others empty.

---

Output

Each autocomplete hit / resolved location / hotel / detail / review is pushed as one dataset row, flattened to friendly columns plus a Raw column with the full upstream JSON for power users.

Mode	Location ID	Name	Rating	# Reviews	Price	Address	Photos	Tripadvisor URL
autocomplete	60763	New York City	—	—	—	New York, United States	https://media-cdn.tripadvisor.com/...	https://www.tripadvisor.com/Tourism-g60763-...
search_bylocation	60763	New York City	—	—	—	New York	https://...	https://www.tripadvisor.com/Tourism-g60763-...
search_hotels/geoId	671150	The Empire Hotel	3.7	9615	from $208	44 W 63rd Street, New York City, NY 10023	https://...	https://www.tripadvisor.com/Hotel_Review-...
details_byid	671150	The Empire Hotel	—	—	—	New York City	https://...	https://www.tripadvisor.com/Hotel_Review-...
details_byurl	671150	The Empire Hotel	—	—	—	New York City	https://...	https://www.tripadvisor.com/Hotel_Review-...
reviews	671150	Excellent stay	5	—	—	Caroline H	—	—

For nested fields (full photo galleries, style tags, parent-geo hierarchy, owner responses, etc.), the complete upstream JSON is in the Raw column.

---

Sample input

{
    "autocomplete_inputs": ["Paris", "Hilton New York"],
    "autocomplete_searchType": "HOTELS",
    "autocomplete_resultCount": 10,

    "search_bylocation_inputs": ["Paris, France", "New York City"],

    "search_hotels_inputs": [
        "60763",
        "40.7128,-74.0060,5",
        "40.6,-74.1;40.6,-73.9;40.8,-73.9;40.8,-74.1"
    ],
    "search_hotels_resultCount": 30,
    "search_hotels_pages": 2,
    "search_hotels_sortOrder": "BEST_VALUE",
    "search_hotels_priceRange": "min:100,max:500",
    "search_hotels_minRating": "4",
    "search_hotels_currency": "USD",

    "details_byid_inputs": ["60763", "671150"],

    "details_byurl_inputs": [
        "https://www.tripadvisor.com/Hotel_Review-g60763-d671150-Reviews-The_Empire_Hotel-New_York_City_New_York.html"
    ],

    "reviews_inputs": ["671150"],
    "reviews_contentType": "HOTEL",
    "reviews_resultCount": 50
}

---

Hotel search filters

• search_hotels_resultCount — hotels per page (1–100, default 30).
• search_hotels_pages — pages per input (1–20).
• search_hotels_sortOrder — BEST_VALUE, PRICE_LOW_TO_HIGH, PRICE_HIGH_TO_LOW, TRAVELER_RANKING, DISTANCE.
• search_hotels_priceRange — min:X | max:Y | min:X,max:Y in the chosen currency.
• search_hotels_minRating — minimum bubble rating (4 = 4.0+).
• search_hotels_currency — USD, EUR, GBP, CAD, AUD, JPY, CNY, INR, AED, BRL, MXN.

---

Pricing

Pay per result — $3 per 1,000 items pushed. Failed inputs return a row with Summary: ERROR: ... and are billed the same as a successful row.

To cap spend, set Max paid dataset items on the run page.

---

Tips

• Don't know a geoId? Run the Autocomplete section first — its Location ID column gives you the canonical id to drop into Search Hotels or Details by ID.
• One free-text city → enriched record? Use Search by Location — it does the typeahead resolve + detail fetch in one call.
• Lat/lng circle search? Format: 40.7128,-74.0060,5 (last value is radius in miles).
• Polygon search? Format: lat,lng;lat,lng;... with at least 3 points.
• Got a Tripadvisor URL? Drop it into Details by URL — works on Hotels, Restaurants, Attractions, and Vacation Rentals (any -dXXXXX URL).
• Bulk reviews? Reviews returns up to 100 per locationId. Set reviews_contentType to the entity vertical (HOTEL / RESTAURANT / ATTRACTION / VACATION_RENTAL).