# Get place

Fetch one place with available identity, contact, rating, category, coordinate, and Google Maps URL fields. Provide a search query or a Maps URL; a URL that contains the place ID returns that exact place or not found.

- Platform: [Google Maps](https://docs.upscrape.com/docs/platforms/googlemaps)
- Capability ID: `googlemaps.place`
- Cost: 1 credit per request
- Maximum runtime: 90 seconds
- Execute endpoint: `POST https://data.upscrape.com/execute`

## Request

Use the exact public capability ID in the shared execute envelope.

```bash
curl --request POST \
  --url https://data.upscrape.com/execute \
  --header "Authorization: Bearer $UPSCRAPE_API_KEY" \
  --header "Content-Type: application/json" \
  --header "Prefer: wait=30" \
  --data '{
  "input": {
    "query": "Empire State Building New York"
  },
  "capability": "googlemaps.place"
}'
```

## Input


| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `country` | `string` | No | Two-letter country code (default 'us'). Default: `us`. |
| `lang` | `string` | No | Language code such as 'en' or 'en-US' (default 'en'). Default: `en`. |
| `query` | `string` | No | Place name/address, ChIJ or GhIJ Place ID (optionally prefixed place_id:), decimal CID (optionally prefixed cid:), or 0x...:0x... feature ID. Explicit identifiers must match the returned place. |
| `url` | `string` | No | HTTPS Google Maps URL with an explicit ID or named place. Supports maps.app.goo.gl and goo.gl/maps short links with at most five redirects to allowed Maps hosts. Also normalizes google.co.in, google.co.uk, google.fr, google.de, google.ca and google.com.au (bare or www) to www.google.com. Explicit IDs are verified; name-only URLs use the best search match. |

### Example input

```json
{
  "query": "Empire State Building New York"
}
```

## Response

Successful output is returned in `results[0].data`.

Raw platform output is intentionally open-ended and may evolve with the upstream source.

### Illustrative sample output

This example shows one response. Values and optional fields vary with the data available.

```json
{
  "address": "Empire State Building, 20 W 34th St., New York, NY 10001",
  "cid": "15074921902713971043",
  "feature_id": "0x89c259a9b3117469:0xd134e199a405a163",
  "lat": 40.7484405,
  "lng": -73.98566439999999,
  "maps_url": "https://www.google.com/maps/place/?q=place_id:ChIJaXQRs6lZwokRY6EFpJnhNNE",
  "name": "Empire State Building",
  "place_id": "ChIJaXQRs6lZwokRY6EFpJnhNNE",
  "rating": 4.7,
  "types": [
    "Observation deck",
    "Historical landmark",
    "Historical place museum"
  ],
  "website": "https://www.esbnyc.com/"
}
```
### Illustrative output fields

Derived from the sample above for orientation only. These fields are not a fixed response schema.

| Path | Observed type | Example |
| --- | --- | --- |
| `address` | `string` | Empire State Building, 20 W 34th St., New York, NY 10001 |
| `cid` | `string` | 15074921902713971043 |
| `feature_id` | `string` | 0x89c259a9b3117469:0xd134e199a405a163 |
| `lat` | `number` | 40.7484405 |
| `lng` | `number` | -73.98566439999999 |
| `maps_url` | `string` | https://www.google.com/maps/place/?q=place_id:ChIJaXQRs6lZwokRY6EFpJnhN… |
| `name` | `string` | Empire State Building |
| `place_id` | `string` | ChIJaXQRs6lZwokRY6EFpJnhNNE |
| `rating` | `number` | 4.7 |
| `types` | `array` | 3 items |
| `types` | `array` | 3 items |
| `website` | `string` | https://www.esbnyc.com/ |

## Execution behavior

A `200` response completed inline. A `202` response was queued; poll `GET /jobs/{id}` until the job reaches `completed` or `failed`. Use an `Idempotency-Key` when retrying must not create a duplicate logical job.

## Related documentation

- [Authentication](https://docs.upscrape.com/docs/api/authentication)
- [Jobs and results](https://docs.upscrape.com/docs/api/jobs)
- [Errors and retries](https://docs.upscrape.com/docs/api/errors)
- [Idempotency](https://docs.upscrape.com/docs/api/idempotency)