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

# Google Hotels API

> Hotels from Google Hotels with property and place IDs, category, star rating and prices for your dates. Search by location, check-in and check-out date, or hotel class.

`POST /v1/data/google-hotels/hotels/run`

**Pricing:** $0.002 per hotel ($2.00 per 1,000).

## Request

Send the inputs under `params`. Only the keys below are accepted; any other key returns `422 invalid_params`.

**location** `string` *required*

Location.

**checkInDate** `date` *required*

Check In Date as a date (YYYY-MM-DD).

**checkOutDate** `date` *required*

Check Out Date as a date (YYYY-MM-DD).

**hotelClass** `string[]`

One or more hotel class. One request reads them all.

**sortBy** `string` (default: relevance)

Sort By to use. Relevance by default.

Allowed values: `relevance` (Relevance), `price_low` (Price (Low to High)), `price_high` (Price (High to Low)), `rating` (Rating), `most_reviewed` (Most reviewed), `distance` (Distance).

**adults** `integer` (default: 2)

Adults as a whole number.

Min `1`; max `9`.

**currency** `string` (default: USD)

Three-letter currency code for prices, e.g. USD, EUR, GBP, INR. Defaults to USD.

**maxResults** `integer` (default: 100)

How many hotels to return in total. Defaults to 100; use 0 for all.

## Example

```bash cURL theme={null}
curl -X POST "https://api.mindcase.co/v1/data/google-hotels/hotels/run?wait=true" \
  -H "Authorization: Bearer $MINDCASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "params": {
    "location": "New York",
    "checkInDate": "2026-12-17",
    "checkOutDate": "2026-12-19",
    "maxResults": 5
  }
}'
```

```python Python theme={null}
import os, requests

r = requests.post(
    "https://api.mindcase.co/v1/data/google-hotels/hotels/run",
    params={"wait": "true"},
    headers={"Authorization": f"Bearer {os.environ['MINDCASE_API_KEY']}"},
    json={"params": {
    "location": "New York",
    "checkInDate": "2026-12-17",
    "checkOutDate": "2026-12-19",
    "maxResults": 5
}},
)
job = r.json()
rows = job.get("data", [])  # if job["status"] == "running", poll /v1/jobs/{job_id}/results
```

```javascript Node.js theme={null}
const r = await fetch("https://api.mindcase.co/v1/data/google-hotels/hotels/run?wait=true", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.MINDCASE_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ params: {
  "location": "New York",
  "checkInDate": "2026-12-17",
  "checkOutDate": "2026-12-19",
  "maxResults": 5
} }),
});
const job = await r.json();
const rows = job.data ?? []; // if job.status === "running", poll /v1/jobs/{job_id}/results
```

## Response fields

Each row in `data` is one hotel, keyed by these fields.

| Field | Name | Type |
| - | - | - |
| `name` | Name | text |
| `hotelUrl` | Hotel URL | url |
| `propertyId` | Property ID | text |
| `placeId` | Place ID | text |
| `category` | Category | text |
| `starRating` | Star Rating | number |
| `checkIn` | Check In | date |
| `checkOut` | Check Out | date |
| `pricePerNight` | Price Per Night | number |
| `totalPrice` | Total Price | number |
| `currency` | Currency | text |
| `originalPricePerNight` | Original Price Per Night | number |
| `priceHistory` | Price History | object |
| `rating` | Rating | rating |
| `reviews` | Reviews | number |
| `ratingDistribution` | Rating Distribution | object\_array |
| `reviewAspects` | Review Aspects | object\_array |
| `externalRatings` | External Ratings | object\_array |
| `reviewSummaryPositive` | Review Summary Positive | text |
| `reviewSummaryNegative` | Review Summary Negative | text |
| `featuredReviewSnippets` | Featured Review Snippets | array |
| `amenities` | Amenities | array |
| `address` | Address | text |
| `phone` | Phone | phone |
| `website` | Website | url |
| `latitude` | Latitude | number |
| `longitude` | Longitude | number |
| `neighborhood` | Neighborhood | text |
| `neighborhoodDescription` | Neighborhood Description | text |
| `locationHierarchy` | Location Hierarchy | object\_array |
| `countryCode` | Country Code | text |
| `description` | Description | text |
| `highlights` | Highlights | array |
| `checkInTime` | Check In Time | text |
| `checkOutTime` | Check Out Time | text |
| `ecoCertified` | Eco Certified | boolean |
| `inclusivityLabels` | Inclusivity Labels | array |
| `thumbnail` | Thumbnail | url |
| `roomTypes` | Room Types | object\_array |
| `bookingLinks` | Booking Links | object\_array |
| `photos` | Photos | object\_array |
| `nearbyPlaces` | Nearby Places | object\_array |

## Example response

Abridged: long text and lists are shortened.

```json theme={null}
{
  "job_id": "7f3a1c2e-0b9d-4c55-9a51-3f2e8d1b6a40",
  "agent": "google-hotels/hotels",
  "status": "completed",
  "row_count": 1,
  "truncated": false,
  "data": [
    {
      "ratingDistribution": [
        {
          "stars": 5,
          "count": 331
        },
        {
          "stars": 4,
          "count": 299
        }
      ],
      "propertyId": "4187470369895733431",
      "locationHierarchy": [
        {
          "kgPath": "/m/059rby",
          "name": "New York (state)"
        },
        {
          "kgPath": "/m/04n3l",
          "name": "Long Island"
        }
      ],
      "nearbyPlaces": [
        {
          "name": "The Museum of Modern Art",
          "photoUrl": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcR29jonVEhaIEWAUbk8OlLIKJSmVP2PW5rdU6eUlnie2nme3BGy",
          "rating": 4.6,
          "reviewCount": 61532,
          "description": "Works from van Gogh to Warhol & beyond plus a sculpture garden, 2 cafes & The Modern restaurant.",
          "latitude": 40.7614327,
          "longitude": -73.97762159999999,
          "category": "Point of interest",
          "travelTimes": [
            {
              "mode": "car",
              "duration": "15 min"
            },
            {
              "mode": "transit",
              "duration": "25 min"
            }
          ]
        },
        {
          "name": "The Metropolitan Museum of Art",
          "photoUrl": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSFbma3f3Z7O4mJ7HuO6nHBg2qMvT7uWsF3CpWdHpW3UReR8fDc",
          "rating": 4.8,
          "reviewCount": 95488,
          "description": "A grand setting for one of the world's greatest collections of art, from ancient to contemporary.",
          "latitude": 40.7794366,
          "longitude": -73.963244,
          "category": "Point of interest",
          "travelTimes": [
            {
              "mode": "car",
              "duration": "18 min"
            },
            {
              "mode": "transit",
              "duration": "29 min"
            }
          ]
        }
      ],
      "longitude": -73.9374619,
      "reviewSummaryNegative": "Other reviews mention the staff can be dismissive and the rooms can be noisy.",
      "checkOut": "2026-12-12",
      "currency": "USD",
      "priceHistory": {
        "currentPrice": 117,
        "typicalLow": 130,
        "typicalHigh": 211,
        "percentile": 0.10495847,
        "priceInsight": "31% less than usual",
        "priceInsightCode": 2
      },
      "checkIn": "2026-12-10",
      "name": "Q4 Hotel New York City",
      "ecoCertified": false,
      "pricePerNight": 117,
      "totalPrice": 234,
      "placeId": "ChIJFd1mFdVYwokRa2H13ptXTQk",
      "featuredReviewSnippets": [
        "\"The location is great, staff is great, the rooms could be a bit better.\"",
        "\"The beds don't provide a small shelf area for your personal belongings.\""
      ],
      "externalRatings": [
        {
          "source": "Tripadvisor",
          "rating": 3.700000047683716,
          "maxRating": 5,
          "count": 310
        },
        {
          "source": "Trip.com",
          "rating": 3.5,
          "maxRating": 5,
          "count": 52
        }
      ],
      "highlights": [
        "Hipster hostel with 24-hour security offering private & dorm-style rooms, free WiFi & a TV lounge."
      ],
      "website": "https://www.q4hotelny.com/#",
      "reviewSummaryPositive": "This hostel is considered a good value, featuring a spacious common area with a kitchen and being conveniently located within a minute's walk of the subway.",
      "address": "29-09 Queens Plaza N, Long Island City, NY 11101",
      "reviews": 955,
      "amenities": [
        "Free parking",
        "Smoke-free property"
      ],
      "starRating": 1,
      "neighborhoodDescription": "Redeveloped industrial area in Queens, with high-rises, art spaces, a riverfront park & MoMA PS1."
    }
  ]
}
```

## Related APIs

For Booking.com's own listing detail use [`booking/listings`](https://docs.mindcase.co/apis/booking/listings); for TripAdvisor ratings use [`tripadvisor/hotels`](https://docs.mindcase.co/apis/tripadvisor/hotels).


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