> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stophy.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Places and travel

> Parsers for places and travel: google-maps, google-maps-place, google-maps-reviews, google-flights, google-hotels, tripadvisor-search, yelp-search and more.

Send the example URL to [scrape](https://docs.stophy.dev/api-reference/endpoint/scrape.md) with the format `{"type": "json", "parser": "<name>"}`. See [Pre-built parsers](https://docs.stophy.dev/scrape/prebuilt-parsers).

### `google-maps`

A Google Maps search page that names a place after in, near or around. Example: `https://www.google.com/maps/search/dentists+in+Ljubljana`

Returns `results`, `cursor`, `page`, `total`.

Works without an API key when you send no options.

Options:

* `minRating`
* `openNow`: Google Maps' own Hours filter, Open now: only places open at the moment of the search.
* `country`
* `language`
* `page`

### `google-maps-place`

A Google Maps place page. Example: `https://www.google.com/maps/place/Eiffel+Tower/@48.8584,2.2945,17z/data=!3m1!4b1!4m6!3m5!1s0x47e66e2964e34e2d:0x8ddca9ee380ef7e0`

Returns `id`, `url`, `name`, `categories`, `address`, `location`, `phone`, `website`, `description`, `rating`, `reviewCount`, `priceLevel`, `hours`, `images`.

Options:

* `country`
* `language`

### `google-maps-reviews`

A Google Maps place page. Example: `https://www.google.com/maps/place/Eiffel+Tower/@48.8584,2.2945,17z/data=!3m1!4b1!4m6!3m5!1s0x47e66e2964e34e2d:0x8ddca9ee380ef7e0`

Returns `results`, `cursor`, `page`, `total`.

Works without an API key when you send no options.

Options:

* `sort`
* `language`
* `limit`: Return at most this many reviews. You pay \$0.001 for each 10 returned.
* `cursor`

### `google-flights`

A Google Flights search page, from the address bar or with a q of IATA airport codes and a date, like Flights to JFK from LHR on 2026-12-15. Example: `https://www.google.com/travel/flights?q=Flights%20to%20JFK%20from%20LHR%20on%202026-12-15`

Returns `isBest`, `price`, `priceCurrency`, `airlines`, `stops`, `durationSeconds`.

Options:

* `returnDate`
* `adults`
* `cabin`
* `currency`
* `stops`: Google Flights' Stops filter.
* `airlines`: Google Flights' Airlines filter, as airline codes like KQ or EK.
* `carryOnBags`: Google Flights' Bags filter: prices include this many carry-on bags.
* `checkedBags`: Google Flights' Bags filter: prices include this many checked bags.
* `maxPrice`: Google Flights' Price filter, in currency for all adults.
* `departureTime`: Google Flights' Times filter for the outbound departure.
* `arrivalTime`: Google Flights' Times filter for the outbound arrival.
* `maxDurationHours`: Google Flights' Duration filter.

### `google-hotels`

A Google Hotels page with a place in q, like hotels in Lisbon. Example: `https://www.google.com/travel/search?q=hotels%20in%20Lisbon`

Returns `name`, `hotelId`, `hotelUrl`, `price`, `totalPrice`, `priceCurrency`.

Options:

* `checkIn`: Defaults to tomorrow.
* `checkOut`: Defaults to one night after checkIn.
* `adults`
* `childrenAges`: One age per child, like \[7, 12].
* `currency`
* `minPrice`: Per night.
* `maxPrice`: Per night.
* `minRating`: Google Hotels' own Guest rating.
* `hotelClass`: Google Hotels' own Hotel class, as star counts like \[4, 5].
* `amenities`: Google Hotels' own Amenities. Every one must be offered.
* `propertyTypes`: Google Hotels' own Property type.
* `freeCancellation`
* `specialOffers`
* `sort`
* `cursor`

### `tripadvisor-search`

A Tripadvisor search page, like tripadvisor.com/Search?q=ritz+london. Example: `https://www.tripadvisor.com/Search?q=ritz+london&ssrc=h`

Returns `results`, `cursor`, `page`, `total`.

Options:

* `location`

### `tripadvisor-place`

A Tripadvisor hotel, restaurant or attraction page. Example: `https://www.tripadvisor.com/Hotel_Review-g186338-d187591-Reviews-The_Ritz_London_Hotel-London_England.html`

Returns `id`, `url`, `name`, `categories`, `address`, `location`, `phone`, `website`, `description`, `rating`, `reviewCount`, `priceLevel`, `hours`, `images`.

### `tripadvisor-reviews`

A Tripadvisor hotel, restaurant or attraction page. Example: `https://www.tripadvisor.com/Hotel_Review-g186338-d187591-Reviews-The_Ritz_London_Hotel-London_England.html`

Returns `results`, `cursor`, `page`, `total`.

Options:

* `language`
* `ratings`
* `travelerTypes`: Tripadvisor's own Traveler type filter: families, couples, solo, business or friends. Only reviews from these travelers.
* `months`: Tripadvisor's own Time of year filter: marMay, junAug, sepNov or decFeb. Only reviews written in these months of the year.
* `sort`: Tripadvisor's own Sort by: mostRecent (Most recent) or detailed (Detailed reviews, ordered by recency and how much they say).
* `page`

### `yelp-search`

A Yelp search page with both what and where, like yelp.com/search?find\_desc=pizza\&find\_loc=Austin%2C+TX. Example: `https://www.yelp.com/search?find_desc=plumber&find_loc=Austin%2C+TX`

Returns `results`, `cursor`, `page`, `total`.

### `yelp-business`

A Yelp business page, like yelp.com/biz/franklin-barbecue-austin. Example: `https://www.yelp.com/biz/franklin-barbecue-austin`

Returns `id`, `url`, `name`, `categories`, `address`, `location`, `phone`, `website`, `description`, `rating`, `reviewCount`, `priceLevel`, `hours`, `images`.

### `yelp-reviews`

A Yelp business page, like yelp.com/biz/franklin-barbecue-austin. Example: `https://www.yelp.com/biz/franklin-barbecue-austin?sort_by=date_desc`

Returns `results`, `cursor`, `page`, `total`.

Options:

* `page`

### `booking-search`

A Booking.com search results page with a place in ss, like booking.com/searchresults.html?ss=Lisbon. Example: `https://www.booking.com/searchresults.html?ss=Lisbon&checkin=2026-12-10&checkout=2026-12-12&group_adults=2&no_rooms=1`

Returns `results`, `cursor`, `page`, `total`.

Options:

* `currency`
* `sort`: Booking.com's own Sort by: relevance (Our top picks) or distance (closest to the center of the place first).
* `cursor`

### `booking-hotel`

A Booking.com hotel page, like booking.com/hotel/pt/hf-fenix-urban.html. Example: `https://www.booking.com/hotel/pt/hf-fenix-urban.html`

Returns `id`, `url`, `title`, `description`, `price`, `pricePeriod`, `status`, `address`, `location`, `bedrooms`, `bathrooms`, `area`, `propertyType`, `rating`, `reviewCount`, `images`, `host`.

### `booking-reviews`

A Booking.com hotel page, like booking.com/hotel/pt/hf-fenix-urban.html. Example: `https://www.booking.com/hotel/pt/hf-fenix-urban.html`

Returns `results`, `cursor`, `page`, `total`.

Options:

* `sort`: Booking.com's own Sort reviews by: newest, mostRelevant or lowestScore (lowest scores first). Only newest pages without gaps. The other orders change between requests, so a walk through the pages can miss reviews.
* `cursor`

### `expedia-hotels`

An Expedia hotel search page with a destination, like expedia.com/Hotel-Search?destination=Paris. Example: `https://www.expedia.com/Hotel-Search?destination=Paris&startDate=2026-12-10&endDate=2026-12-12&adults=2`

Returns `results`, `cursor`, `page`, `total`.

Options:

* `sort`: Expedia's own sort: relevance (Recommended), priceLow (lowest price first) or rating (guest rating).
* `page`

### `airbnb-search`

An Airbnb search page for a place with checkin and checkout dates, like airbnb.com/s/Lisbon--Portugal/homes?checkin=2026-12-10\&checkout=2026-12-12. Example: `https://www.airbnb.com/s/Lisbon--Portugal/homes?checkin=2026-12-10&checkout=2026-12-12&adults=2`

Returns `results`, `cursor`, `page`, `total`.

Options:

* `minPrice`: Airbnb's own price range minimum: the nightly price after discounts and before taxes, in currency.
* `maxPrice`: Airbnb's own price range maximum: the nightly price after discounts and before taxes, in currency.
* `roomType`: Airbnb's own Type of place filter: entireHome (Entire home) or privateRoom (Room).
* `currency`: Currency of every price in the answer and of minPrice and maxPrice.
* `cursor`

### `airbnb-listing`

An Airbnb listing page, like airbnb.com/rooms/18249319. With check\_in, check\_out and adults in the link it also returns the price for those dates. Example: `https://www.airbnb.com/rooms/18249319`

Returns `id`, `url`, `title`, `description`, `price`, `pricePeriod`, `status`, `address`, `location`, `bedrooms`, `bathrooms`, `area`, `propertyType`, `rating`, `reviewCount`, `images`, `host`.

Options:

* `checkIn`: First night, as YYYY-MM-DD. Send it with checkOut to get the price.
* `checkOut`: Day you leave, as YYYY-MM-DD. Send it with checkIn to get the price.
* `guests`: Number of guests. Only stays that fit this many.
* `currency`: Currency of every price in the answer and of minPrice and maxPrice.

### `airbnb-reviews`

An Airbnb listing page, like airbnb.com/rooms/18249319. Example: `https://www.airbnb.com/rooms/18249319`

Returns `results`, `cursor`, `page`, `total`.

Options:

* `page`

### `luma-events`

A Luma city page, like luma.com/sf or lu.ma/london. Example: `https://luma.com/sf`

Returns `results`, `cursor`, `page`, `total`.

Options:

* `category`: Only events in this Luma category.
* `cursor`

### `luma-event`

A Luma event page, like luma.com/nighthack. Example: `https://luma.com/nighthack`

Returns `id`, `url`, `title`, `description`, `startsAt`, `endsAt`, `timezone`, `isOnline`, `address`, `location`, `price`, `hosts`, `images`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.