# Bestparking — 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.

> Search for available parking spots across cities, view detailed lot information including pricing and availability, use location autocomplete to quickly find parking near any destination, and see which cities are supported.

**Category:** Maps & Geospatial | **Website:** [bestparking.com/](https://bestparking.com/) | **Docs:** [parse.bot/marketplace/e01637b3-6d29-4a77-bc22-74ce6ea9d83b/bestparking-com-api](https://parse.bot/marketplace/e01637b3-6d29-4a77-bc22-74ce6ea9d83b/bestparking-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-bestparking-com-api-e01637b3/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### autocomplete_locations

Get location suggestions and upcoming events based on a search term. Returns autocomplete results for cities, addresses, venues, and landmarks, plus relevant events with venue info and timing.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search term (e.g. city name, address, venue, landmark). |

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

### get_parking_lot_details

Get detailed information and pricing quotes for a specific parking lot. When start_time and end_time are provided, returns quotes with pricing for that time range (response is an array of quote objects with embedded location). Without times, returns static location details only (name, address, description, rating, photos, hours). The location_id comes from search_parking results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `end_time` | string | No | End time for the parking quote in ISO 8601 format (e.g. 2026-06-12T14:00:00Z). |
| `location_id` | string | Yes | Unique identifier for the parking lot (from search_parking results, e.g. '52007'). |
| `start_time` | string | No | Start time for the parking quote in ISO 8601 format (e.g. 2026-06-12T10:00:00Z). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-bestparking-com-api-e01637b3/get_parking_lot_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"end_time":"<string>","location_id":"<string>","start_time":"<string>"}'
```

### get_supported_cities

Retrieve a list of major cities supported by BestParking with their coordinates and URL slugs. Returns a static curated list.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-bestparking-com-api-e01637b3/get_supported_cities \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_parking

Search for parking locations (hourly or monthly) near a specific coordinate. Returns detailed pricing, availability, and curated recommendations (cheapest, closest). When start_time and end_time are omitted, defaults to a 2-hour window starting now. Each result includes full location info, pricing segments, amenities, and booking options.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `end_time` | string | No | End time for the parking quote in ISO 8601 format (e.g. 2026-06-12T12:00:00). Defaults to 2 hours after start_time if omitted. |
| `lat` | number | Yes | Latitude of the search center. |
| `lng` | number | Yes | Longitude of the search center. |
| `search_type` | string | No | Type of search: 'transient' (hourly/daily) or 'monthly'. |
| `start_time` | string | No | Start time for the parking quote in ISO 8601 format (e.g. 2026-06-12T10:00:00). Defaults to current hour if omitted. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-bestparking-com-api-e01637b3/search_parking \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"end_time":"<string>","lat":"<number>","lng":"<number>","search_type":"<string>","start_time":"<string>"}'
```