> ## 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

> Find places on Google Maps and Tripadvisor with their reviews, and search stays on Google Hotels, Airbnb and Booking.com. Search flights on Google. Filter by rating, traveler type, dates and more.

Find places on Google Maps and Tripadvisor with their reviews, and search stays on Google Hotels, Airbnb and Booking.com. Search flights on Google. Filter by rating, traveler type, dates and more. See every field in the [Places and travel reference](/api-reference/endpoint/google-maps-search), or try it in the [playground](https://stophy.dev/playground).

## Scrape Google Maps search results

<CodeGroup>
  ```typescript TypeScript icon="https://mintcdn.com/sirathic/7E4w9-IC4ysabjfc/images/icons/typescript.svg?fit=max&auto=format&n=7E4w9-IC4ysabjfc&q=85&s=d8272a85e64145620f1fbbfcf7932986" theme={null}
  import { Stophy } from "stophy";

  const stophy = new Stophy({ apiKey: process.env.STOPHY_API_KEY });
  const result = await stophy.google.maps.search({ query: "coffee", location: "Austin, TX", openNow: true });
  console.log(result.data.results);
  ```

  ```python Python icon="python" theme={null}
  from stophy import Stophy

  stophy = Stophy()  # reads STOPHY_API_KEY
  result = stophy.google.maps.search(query="coffee", location="Austin, TX", open_now=True)
  print(result["data"]["results"])
  ```

  ```bash cURL icon="terminal" theme={null}
  curl -X POST https://api.stophy.dev/v1/google/maps/search \
    -H "Authorization: Bearer $STOPHY_API_KEY" \
    -H "content-type: application/json" \
    -d '{"query":"coffee","location":"Austin, TX","openNow":true}'
  ```

  ```bash CLI icon="square-terminal" theme={null}
  stophy google maps search --query coffee --location "Austin, TX" --openNow
  ```
</CodeGroup>

The response:

```json theme={null}
{
  "success": true,
  "data": {
    "results": [
      {
        "placeId": "abc123",
        "googlePlaceId": "abc123",
        "placeUrl": "https://example.com/",
        "name": "Example title",
        "categories": [
          "example"
        ],
        "address": "example",
        "latitude": 1,
        "longitude": 1,
        "rating": 4.5,
        "reviews": 1234,
        "photos": 1,
        "phone": "example",
        "website": "https://example.com/",
        "description": "A short, readable summary of the result.",
        "hours": [
          {
            "days": "example",
            "times": [
              "example"
            ]
          }
        ],
        "hoursToday": "example",
        "openStatus": "example",
        "timezone": "example",
        "thumbnailUrl": "https://example.com/image.jpg",
        "reservationUrl": "https://example.com/",
        "attributes": [
          "example"
        ]
      }
    ],
    "page": 1
  },
  "creditsUsed": 1,
  "requestId": "e27d88d4-1b6f-4017-87cb-40f5102cbf1d"
}
```

## Endpoints

| Endpoint | Cost |
| - | - |
| [Scrape Google Maps search results](/api-reference/endpoint/google-maps-search) | 1 credit (no key needed) |
| [Scrape a Google Maps place's details](/api-reference/endpoint/google-maps-place) | 1 credit |
| [Scrape a Google Maps place's reviews](/api-reference/endpoint/google-maps-reviews) | 1 credit (no key needed) |
| [Scrape Tripadvisor search results](/api-reference/endpoint/tripadvisor-search) | 1 credit |
| [Scrape a Tripadvisor place page](/api-reference/endpoint/tripadvisor-place) | 1 credit |
| [Scrape a Tripadvisor place's reviews](/api-reference/endpoint/tripadvisor-reviews) | 1 credit |
| [Scrape Google Hotels results with prices and ratings](/api-reference/endpoint/google-hotels) | 1 credit |
| [Scrape Google Flights results with prices and times](/api-reference/endpoint/google-flights) | 1 credit |
| [Scrape Airbnb search results with prices](/api-reference/endpoint/airbnb-search) | 1 credit |
| [Scrape an Airbnb listing's details, host, amenities, ratings and price](/api-reference/endpoint/airbnb-listing) | 1 credit |
| [Scrape an Airbnb listing's guest reviews](/api-reference/endpoint/airbnb-reviews) | 1 credit |
| [Scrape Booking.com search results with prices](/api-reference/endpoint/booking-search) | 1 credit |
| [Scrape a Booking.com hotel page](/api-reference/endpoint/booking-hotel) | 1 credit |
| [Scrape a Booking.com hotel's guest reviews](/api-reference/endpoint/booking-hotel-reviews) | 1 credit |

## More ways to call it

### Scrape Google Hotels results with prices and ratings

<CodeGroup>
  ```typescript TypeScript icon="https://mintcdn.com/sirathic/7E4w9-IC4ysabjfc/images/icons/typescript.svg?fit=max&auto=format&n=7E4w9-IC4ysabjfc&q=85&s=d8272a85e64145620f1fbbfcf7932986" theme={null}
  import { Stophy } from "stophy";

  const stophy = new Stophy({ apiKey: process.env.STOPHY_API_KEY });
  const result = await stophy.google.hotels({ query: "Lisbon", checkIn: "2026-11-23" });
  console.log(result.data.results);
  ```

  ```python Python icon="python" theme={null}
  from stophy import Stophy

  stophy = Stophy()  # reads STOPHY_API_KEY
  result = stophy.google.hotels(query="Lisbon", check_in="2026-11-23")
  print(result["data"]["results"])
  ```

  ```bash cURL icon="terminal" theme={null}
  curl -X POST https://api.stophy.dev/v1/google/hotels \
    -H "Authorization: Bearer $STOPHY_API_KEY" \
    -H "content-type: application/json" \
    -d '{"query":"Lisbon","checkIn":"2026-11-23"}'
  ```

  ```bash CLI icon="square-terminal" theme={null}
  stophy google hotels Lisbon --checkIn 2026-11-23
  ```
</CodeGroup>

### Scrape Google Flights results with prices and times

<CodeGroup>
  ```typescript TypeScript icon="https://mintcdn.com/sirathic/7E4w9-IC4ysabjfc/images/icons/typescript.svg?fit=max&auto=format&n=7E4w9-IC4ysabjfc&q=85&s=d8272a85e64145620f1fbbfcf7932986" theme={null}
  import { Stophy } from "stophy";

  const stophy = new Stophy({ apiKey: process.env.STOPHY_API_KEY });
  const result = await stophy.google.flights({ origin: "JFK", destination: "LAX", departDate: "2026-11-23" });
  console.log(result.data.results);
  ```

  ```python Python icon="python" theme={null}
  from stophy import Stophy

  stophy = Stophy()  # reads STOPHY_API_KEY
  result = stophy.google.flights(origin="JFK", destination="LAX", depart_date="2026-11-23")
  print(result["data"]["results"])
  ```

  ```bash cURL icon="terminal" theme={null}
  curl -X POST https://api.stophy.dev/v1/google/flights \
    -H "Authorization: Bearer $STOPHY_API_KEY" \
    -H "content-type: application/json" \
    -d '{"origin":"JFK","destination":"LAX","departDate":"2026-11-23"}'
  ```

  ```bash CLI icon="square-terminal" theme={null}
  stophy google flights --origin JFK --destination LAX --departDate 2026-11-23
  ```
</CodeGroup>

<Tip>Google Maps search and Google Maps reviews work without a key. Pass the place id from a Google Maps search, or the place link from a Tripadvisor search, into that source's other endpoints.</Tip>


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