# Google — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Access data from google.com.

**Category:** Maps & Geospatial | **Website:** [www.google.com/maps/](https://www.google.com/maps/) | **Docs:** [parse.bot/marketplace/bc9775b9-cb40-4e94-a64c-a6df9491037a/google-com-api](https://parse.bot/marketplace/bc9775b9-cb40-4e94-a64c-a6df9491037a/google-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-google-com-api-bc9775b9/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_list_places

Retrieve all places from a shared Google Maps list. Accepts a list URL containing the list identifier and returns every place on that list with its name, address, coordinates, hex place_id, and any user-added note. The list metadata (title, description, total count) is also returned. Results are returned in a single page containing all places on the list (up to 500).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `list_url` | string | Yes | Full Google Maps list URL (e.g. 'https://www.google.com/maps/@/data=!3m1!4b1!4m3!11m2!2s006VguEfoox94oKjnWhRfqwuDz-kOg!3e3'). The list ID is extracted from the URL automatically. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-google-com-api-bc9775b9/get_list_places \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"list_url":"<string>"}'
```

### get_place_busyness

Retrieve popular times histogram and live busyness status for a place given its Google Maps place URL. Returns hourly busyness percentages and descriptions for each day of the week, plus the current live busyness status when available. Also returns the place name and address for confirmation. Requires a full Google Maps place URL containing the place name and coordinates (e.g. from the browser address bar when viewing a place). Popular times may be null for places that do not have enough visitor data.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `place_url` | string | Yes | Full Google Maps place URL (e.g. 'https://www.google.com/maps/place/Ghirardelli+Chocolate+Experience/@37.8019012,-122.4114176,14z/'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-google-com-api-bc9775b9/get_place_busyness \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"place_url":"<string>"}'
```

### get_place_details

Search Google Maps for a specific place and return its detailed information including photos, popular times, and live busyness data. Returns the top matching place's name, address, coordinates, rating, review count, price level, current opening status with today's hours, phone number, website, categories, neighborhood, timezone, description, photos (logo, cover, and categorized place photos), popular times histogram showing typical busyness by hour for each day of the week, live busyness status, and business specialties/highlights. The query can be a place name, business name with address, or any search term that would work in the Google Maps search bar. An optional price_level filter can be provided; when set, the response includes price_level_filter (the requested level) and price_level_match (boolean indicating whether the place's price level matches the filter). Full place details are always returned regardless of filter match.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `price_level` | string | No | Optional price level filter. When provided, the response includes price_level_filter and price_level_match fields indicating whether the place matches. Accepted values: '$', '$$', '$$$', '$$$$', '$100+'. |
| `query` | string | Yes | Place name, business name, or address to search for on Google Maps (e.g. 'Starbucks 1500 Broadway New York', 'Empire State Building', 'Central Park Zoo'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-google-com-api-bc9775b9/get_place_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"price_level":"<string>","query":"<string>"}'
```