# Google Places API guide



## Start with Google Places



Resolve a place from a text query, then use the returned place ID for details and available reviews. Match address and locality before analysing a similarly named business.



These requests use your API key and can spend credits. Check the current price on the endpoint page; each new page is a separate request. Later examples use illustrative identifiers: replace them with values from your earlier response.



### 1. Find a place



Select a result by identity and address; retain its place ID. [Parameters and current cost →](https://www.monocrawl.com/docs/endpoints/google_places/search)



**google_places/search**

```
curl "https://www.monocrawl.com/v1/google_places/search?query=coffee%20in%20Worthing&limit=5" \
  -H "x-api-key: mn_your_key_here"
```



### 2. Read its details



Replace the example id with the chosen place ID. [Parameters and current cost →](https://www.monocrawl.com/docs/endpoints/google_places/place)



**google_places/place**

```
curl "https://www.monocrawl.com/v1/google_places/place?id=ChIJl1wfOSCjdUgRhrFnqMsMhQM" \
  -H "x-api-key: mn_your_key_here"
```



### 3. Read available reviews



Use that same place ID. Returned reviews are a bounded source sample, not all reviews implied by an aggregate count. [Parameters and current cost →](https://www.monocrawl.com/docs/endpoints/google_places/reviews)



**google_places/reviews**

```
curl "https://www.monocrawl.com/v1/google_places/reviews?id=ChIJl1wfOSCjdUgRhrFnqMsMhQM" \
  -H "x-api-key: mn_your_key_here"
```



## Choose filters with the source behavior in mind



| Control | Behavior and limits |
| --- | --- |
| Result bounds | Text search limit is 1–20. The declared search contract does not expose a cursor; a result page is not an exhaustive business directory. [Endpoint reference →](https://www.monocrawl.com/docs/endpoints/google_places/search) |
| Place identity | Use the place ID from the selected search result. Match address and locality when names repeat. [Endpoint reference →](https://www.monocrawl.com/docs/endpoints/google_places/place) |
| Review sample | No public cursor or exhaustive-review contract is declared here. Preserve the source sample and its attribution rather than extrapolating it to all customers. [Endpoint reference →](https://www.monocrawl.com/docs/endpoints/google_places/reviews) |



Source availability, ordering and field coverage can change. Inspect warnings and partial-result metadata alongside the rows. See [runnable workflows](https://www.monocrawl.com/docs/workflows), [metric semantics](https://www.monocrawl.com/docs/metric-semantics), [computed fields](https://www.monocrawl.com/docs/computed-fields) and the [pagination matrix](https://www.monocrawl.com/docs/pagination).



## Match the operation to your task



| Your task | Endpoint | When to use it |
| --- | --- | --- |
| A known place | [`place`](https://www.monocrawl.com/docs/endpoints/google_places/place) | Avoid another text search when you already have its ID. |
| Review text | [`reviews`](https://www.monocrawl.com/docs/endpoints/google_places/reviews) | Keep review time, rating and source attribution when available. |



Explore all documented operations by purpose below. Each endpoint reference contains its accepted parameters and current price.



### Other operations



- [`hotel`](https://www.monocrawl.com/docs/endpoints/google_places/hotel)

- [`listing`](https://www.monocrawl.com/docs/endpoints/google_places/listing)

- [`place`](https://www.monocrawl.com/docs/endpoints/google_places/place)

- [`questions`](https://www.monocrawl.com/docs/endpoints/google_places/questions)

- [`updates`](https://www.monocrawl.com/docs/endpoints/google_places/updates)



### Search and discovery



- [`hotels-search`](https://www.monocrawl.com/docs/endpoints/google_places/hotels-search)

- [`search`](https://www.monocrawl.com/docs/endpoints/google_places/search)



### Reviews and offers



- [`reviews`](https://www.monocrawl.com/docs/endpoints/google_places/reviews)



## Endpoint reference

## google_places/hotel

`GET /v1/google_places/hotel`

One hotel on Google Hotels with prices by seller, amenities, rating and contact details.

*Google hotel*

| Parameter | Required | Description |
| --- | --- | --- |
| `hotel_id` | yes | Hotel identifier from a hotels search — e.g. `ChkIoYjXwK-S_okHGg0vZy8xMW1fd3MzY243EAE` |
| `check_in` | no | Check-in date — e.g. `2026-10-10` |
| `check_out` | no | Check-out date — e.g. `2026-10-12` |
| `location` | no | Location name — e.g. `United Kingdom` |
| `language` | no | Language code — e.g. `en` |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 4 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/google_places/hotel?hotel_id=ChkIoYjXwK-S_okHGg0vZy8xMW1fd3MzY243EAE" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "address": "example",
  "amenities": [],
  "hotel_id": "example",
  "images": [
    "example"
  ],
  "location": {
    "latitude": 0,
    "location_chain": [
      {
        "card_id": "example",
        "cid": "example",
        "feature_id": "example",
        "title": "example"
      }
    ],
    "longitude": 0,
    "maps_url": "https://example.com/example",
    "neighborhood": "example",
    "neighborhood_description": "example",
    "overall_score": 0,
    "score_by_categories": {
      "airport_access": 0,
      "overall": 0,
      "restaurants": 0,
      "things_to_do": 0,
      "transit": 0
    }
  },
  "name": "example",
  "phone": "example",
  "platform": "example",
  "prices": [],
  "rating": {
    "value": 0,
    "votes": 0
  },
  "reviews_summary": {
    "mentions": [
      {
        "negative_count": 0,
        "positive_count": 0,
        "positive_score": 0,
        "title": "example",
        "total_count": 0,
        "visible_by_default": false
      }
    ],
    "rating_distribution": {},
    "value": 0,
    "votes_count": 0
  },
  "sponsored": false,
  "stars": 0
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/google_places/hotel#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/google_places/hotel.json)


## google_places/hotels-search

`GET /v1/google_places/hotels-search`

Hotels for a query on Google Hotels with price, stars, rating and amenities.

*Google Hotels search*

| Parameter | Required | Description |
| --- | --- | --- |
| `query` | yes | Search terms — e.g. `hotels in Bath` |
| `check_in` | no | Check-in date — e.g. `2026-10-10` |
| `check_out` | no | Check-out date — e.g. `2026-10-12` |
| `location` | no | Location name — e.g. `United Kingdom` |
| `language` | no | Language code — e.g. `en` |
| `limit` | no | Requested rows per response, 1–1000. The source may return fewer. Remaining rows from an already purchased page use a saved cursor and cost zero to retrieve for up to one hour; further native source pages use this endpoint’s normal price. — e.g. `5` |
| `cursor` | no | Use the returned cursor unchanged, retaining the original query, filters and limit. Saved mlo1. cursors retrieve already purchased rows at zero credits for up to one hour. A native source cursor, when supplied, starts a normally priced source page. Quote with dry_run before continuing. |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `limit`: Bound the returned rows to what your task needs. A smaller limit does not necessarily reduce source calls or price; inspect the quote.
- `cursor`: Continue the same source traversal with the complete returned cursor. Saved-result retrieval and a new source page can have different prices; quote the next call.
- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 4 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/google_places/hotels-search?query=hotels%20in%20Bath" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "check_in": "example",
  "check_out": "example",
  "count": 0,
  "has_more": false,
  "items": [
    {
      "amenities": [],
      "hotel_id": "example",
      "images": [
        "example"
      ],
      "location": {
        "latitude": 0,
        "longitude": 0
      },
      "name": "example",
      "platform": "example",
      "rating": {
        "value": 0,
        "votes": 0
      },
      "sponsored": false,
      "stars": 0
    }
  ],
  "query": "example"
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/google_places/hotels-search#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/google_places/hotels-search.json)


## google_places/listing

`GET /v1/google_places/listing`

A business's Google listing: categories, description, hours, attributes, rating, contact details and images.

*Google business listing*

| Parameter | Required | Description |
| --- | --- | --- |
| `query` | yes | Business name, optionally with a place — e.g. `Dishoom Shoreditch` |
| `location` | no | Location name — e.g. `London,England,United Kingdom` |
| `language` | no | Language code — e.g. `en` |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 4 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/google_places/listing?query=Dishoom%20Shoreditch" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "address": "example",
  "attributes": {
    "available_attributes": {
      "accessibility": [
        "example"
      ],
      "amenities": [
        "example"
      ],
      "atmosphere": [
        "example"
      ],
      "children": [
        "example"
      ],
      "crowd": [
        "example"
      ],
      "dining_options": [
        "example"
      ],
      "highlights": [
        "example"
      ],
      "offerings": [
        "example"
      ],
      "parking": [
        "example"
      ],
      "payments": [
        "example"
      ],
      "pets": [
        "example"
      ],
      "planning": [
        "example"
      ],
      "popular_for": [
        "example"
      ],
      "service_options": [
        "example"
      ]
    },
    "unavailable_attributes": {
      "accessibility": [
        "example"
      ]
    }
  },
  "categories": [
    "example"
  ],
  "category": "example",
  "cid": "example",
  "description": "example",
  "domain": "example",
  "hours": {
    "current_status": "example",
    "timetable": {
      "friday": [
        {}
      ],
      "monday": [
        {}
      ],
      "saturday": [
        {}
      ],
      "sunday": [
        {}
      ],
      "thursday": [
        {}
      ],
      "tuesday": [
        {}
      ],
      "wednesday": [
        {}
      ]
    }
  },
  "is_claimed": false,
  "latitude": 0,
  "logo": "example",
  "longitude": 0,
  "main_image": "https://example.com/example",
  "name": "example",
  "open_now": "example",
  "phone": "example",
  "place_id": "example",
  "platform": "example",
  "rating": {
    "max": 0,
    "value": 0,
    "votes": 0
  },
  "url": "https://example.com/example"
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/google_places/listing#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/google_places/listing.json)


## google_places/place

`GET /v1/google_places/place`

Full place record: contact details, opening hours, price level, rating and business status.

*Place details*

| Parameter | Required | Description |
| --- | --- | --- |
| `id` | yes | Google place id from a search result. — e.g. `ChIJl1wfOSCjdUgRhrFnqMsMhQM` |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 6 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/google_places/place?id=ChIJl1wfOSCjdUgRhrFnqMsMhQM" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "additional_categories": [
    "example"
  ],
  "address": "example",
  "attributes": {
    "available_attributes": {
      "accessibility": [
        "example"
      ],
      "atmosphere": [
        "example"
      ],
      "dining_options": [
        "example"
      ],
      "highlights": [
        "example"
      ],
      "offerings": [
        "example"
      ],
      "payments": [
        "example"
      ],
      "pets": [
        "example"
      ],
      "popular_for": [
        "example"
      ],
      "service_options": [
        "example"
      ]
    },
    "unavailable_attributes": {
      "service_options": [
        "example"
      ]
    }
  },
  "category": "example",
  "cid": "example",
  "description": "example",
  "id": "example",
  "is_claimed": false,
  "lat": 0,
  "lng": 0,
  "logo": "example",
  "main_image": "https://example.com/example",
  "name": "example",
  "open_now": false,
  "opening_hours": [
    "example"
  ],
  "phone": "example",
  "price_level": 0,
  "primary_type": "example",
  "rating": 0,
  "rating_count": 0,
  "types": [
    "example"
  ],
  "url": "https://example.com/example",
  "website": "example"
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/google_places/place#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/google_places/place.json)


## google_places/questions

`GET /v1/google_places/questions`

Questions asked on a business's Google listing with their answers.

*Google business questions*

| Parameter | Required | Description |
| --- | --- | --- |
| `query` | yes | Business name, optionally with a place — e.g. `Dishoom Shoreditch` |
| `location` | no | Location name — e.g. `London,England,United Kingdom` |
| `language` | no | Language code — e.g. `en` |
| `limit` | no | Requested rows per response, 1–1000. The source may return fewer. Remaining rows from an already purchased page use a saved cursor and cost zero to retrieve for up to one hour; further native source pages use this endpoint’s normal price. — e.g. `5` |
| `cursor` | no | Use the returned cursor unchanged, retaining the original query, filters and limit. Saved mlo1. cursors retrieve already purchased rows at zero credits for up to one hour. A native source cursor, when supplied, starts a normally priced source page. Quote with dry_run before continuing. |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `limit`: Bound the returned rows to what your task needs. A smaller limit does not necessarily reduce source calls or price; inspect the quote.
- `cursor`: Continue the same source traversal with the complete returned cursor. Saved-result retrieval and a new source page can have different prices; quote the next call.
- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 4 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/google_places/questions?query=Dishoom%20Shoreditch" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "count": 0,
  "has_more": false,
  "items": [
    {
      "answers": [
        {}
      ],
      "asked_at": "2026-09-01T12:00:00Z",
      "asked_by": "example",
      "id": "example",
      "question": "example"
    }
  ]
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/google_places/questions#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/google_places/questions.json)


## google_places/reviews

`GET /v1/google_places/reviews`

The most relevant reviews for a place (Google returns at most five; no pagination), with the place's overall rating.

*Place reviews*

| Parameter | Required | Description |
| --- | --- | --- |
| `id` | yes | Google place id from a search result. — e.g. `ChIJl1wfOSCjdUgRhrFnqMsMhQM` |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 2 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/google_places/reviews?id=ChIJl1wfOSCjdUgRhrFnqMsMhQM" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "_warnings": [
    "example"
  ],
  "count": 0,
  "items": [
    {
      "author": "example",
      "author_url": "https://example.com/example",
      "published_at": "2026-09-01T12:00:00Z",
      "rating": 0,
      "relative_time": "example",
      "text": "example",
      "url": "https://example.com/example"
    }
  ],
  "place": {
    "id": "example",
    "name": "example",
    "rating": 0,
    "rating_count": 0
  }
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/google_places/reviews#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/google_places/reviews.json)


## google_places/search

`GET /v1/google_places/search`

Search places and businesses by free text. Returns identity, address, coordinates, rating and links.

*Place text search*

| Parameter | Required | Description |
| --- | --- | --- |
| `query` | yes | Free-text search: what and where. — e.g. `coffee in Worthing` |
| `limit` | no | Requested results, 1–20 (default 20); the source may return fewer. No per-item detail enrichment. — e.g. `20` |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `limit`: Bound the returned rows to what your task needs. A smaller limit does not necessarily reduce source calls or price; inspect the quote.
- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 2 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/google_places/search?query=coffee%20in%20Worthing" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "count": 0,
  "items": [
    {
      "additional_categories": [
        "example"
      ],
      "address": "example",
      "category": "example",
      "cid": "example",
      "id": "example",
      "is_claimed": false,
      "lat": 0,
      "lng": 0,
      "main_image": "https://example.com/example",
      "name": "example",
      "open_now": false,
      "opening_hours": [
        "example"
      ],
      "phone": "example",
      "price_level": 0,
      "primary_type": "example",
      "rating": 0,
      "rating_count": 0,
      "types": [
        "example"
      ],
      "url": "https://example.com/example",
      "website": "example"
    }
  ]
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/google_places/search#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/google_places/search.json)


## google_places/updates

`GET /v1/google_places/updates`

Posts a business has published on its Google listing. Queued task.

*Google business updates*

| Parameter | Required | Description |
| --- | --- | --- |
| `query` | yes | Business name, optionally with a place — e.g. `Dishoom Shoreditch` |
| `location` | no | Location name — e.g. `London,England,United Kingdom` |
| `language` | no | Language code — e.g. `en` |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 5 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/google_places/updates?query=Dishoom%20Shoreditch" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "count": 0,
  "has_more": false,
  "items": [
    {
      "images": [],
      "links": [
        {}
      ],
      "posted_at": "2026-09-01T12:00:00Z",
      "text": "example",
      "url": "https://example.com/example"
    }
  ]
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/google_places/updates#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/google_places/updates.json)