> ## 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 hotels and flights on Google. Filter by rating, traveler type, dates, and more.

Find places on Google Maps and Tripadvisor with their reviews, and search hotels and 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).

## Search places on Google Maps by keyword and location

<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": "cc56bfc2-db4e-4d82-9bb7-ee7cd3a1340f"
}
```

## Endpoints

| Endpoint | Cost |
| - | - |
| [Search places on Google Maps by keyword and location](/api-reference/endpoint/google-maps-search) | 1 credit (no key needed) |
| [Get a place's address, hours, rating and contact details](/api-reference/endpoint/google-maps-place) | 1 credit |
| [Get a place's reviews](/api-reference/endpoint/google-maps-reviews) | 1 credit |
| [Search hotels, restaurants and attractions](/api-reference/endpoint/tripadvisor-search) | 1 credit |
| [Get a place's rating, ranking and details](/api-reference/endpoint/tripadvisor-place) | 1 credit |
| [Get a place's reviews](/api-reference/endpoint/tripadvisor-reviews) | 1 credit |
| [Search Google Hotels with prices, ratings and Google's own filters](/api-reference/endpoint/google-hotels) | 1 credit |
| [Search flights with prices and times](/api-reference/endpoint/google-flights) | 1 credit |

## More ways to call it

### Search Google Hotels with prices, ratings and Google's own filters

<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-19" });
  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-19")
  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-19"}'
  ```

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

### Search flights 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-19" });
  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-19")
  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-19"}'
  ```

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

<Tip>Google Maps search works 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.