# SpotHero Parking API

> SpotHero parking: bookable garages and lots near a point or airport, with prices for your times

- Vendor: `spotheroparkingapi` · version 1.0 · category Transport · tags spothero api, parking api, parking prices api, airport parking api, garage search api, parking availability api
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/spotheroparkingapi
- This document: https://apiclay.com/docs/spotheroparkingapi.md
- OpenAPI 3.1: https://apiclay.com/api/spotheroparkingapi/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `spotheroparkingapi`
- Updated: 2026-11-18

## About

## SpotHero Parking API

The parking search behind SpotHero, the US and Canada parking-reservation marketplace: garages and lots near a latitude and longitude for a start and end time, with the quoted total price and its breakdown (rental, service fee), availability, walking distance, amenities and the facility (title, operator, address, type, hours, navigation tips); airport parking for an IATA code; one facility by id; the airports SpotHero covers; and the performers whose events it sells parking for.

Data comes from **spothero.com** (https://spothero.com). Every route calls the source's own public API and returns it unchanged.

Typical flow: `/search?lat=41.8781&amp;lon=-87.6298&amp;starts=2026-11-20T10:00:00-06:00&amp;ends=2026-11-20T14:00:00-06:00&amp;page_size=10`, or `/airports` then `/airport-search?iata=ORD&amp;...`, then `/facility?id=`.

### Routes

#### GET `/search` - Parking near a point
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| lat | query | number | yes | Latitude, e.g. `41.8781`. |
| lon | query | number | yes | Longitude, e.g. `-87.6298`. |
| starts | query | string | yes | Start, ISO 8601 with offset, e.g. `2026-12-04T10:00:00-06:00`. |
| ends | query | string | yes | End, same format. |
| page_size | query | number | no | Results per page (default about 70; use 10 to keep responses small). |
| after | query | string | no | Cursor from the `@next` link. |

Returns: `results` array, nearest first: `distance` (`linear_meters`), `availability`, `rates` (each with `quote.total_price` (`value` in cents, `currency_code`) and `quote.order[].items` breakdown), `facility.common` (`title`, `operator_display_name`, `addresses`, `facility_type`, `hours_of_operation`, `navigation_tip`, `city`) and amenities; plus `@next` for the next page. About 10 KB per result.

#### GET `/airport-search` - Airport parking
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| iata | query | string | yes | Airport code from `/airports`, e.g. `ORD`. |
| starts | query | string | yes | Drop-off time, ISO 8601 with offset. |
| ends | query | string | yes | Pick-up time, ISO 8601 with offset. |
| page_size | query | number | no | Results per page. |
| after | query | string | no | Cursor from the `@next` link. |

Returns: `airport` and `results` like `/search`, with airport details per rate (shuttle, parking pass type, amenities, tag such as `Best Value`).

#### GET `/facility` - Facility
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| id | path | string | yes | Facility id (`facility_id` in a quote). |

Returns: `common` (title, operator, addresses, hours, images, restrictions), `transient`, `monthly` and `airport` sections.

#### GET `/airports` - Airports
No parameters.

Returns: `data.results` array of 111 airports: `name`, `iata_code`, `city`, `latitude`, `longitude`, `timezone`, `destination_id`.

#### GET `/performers` - Performers
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| search_query | query | string | yes | Artist or team name. |

Returns: `results` array: `name`, `performer_id`, `url` (SpotHero event-parking page).

### Caveats

- Prices are quotes for the times you send and are in cents; they change with demand and need a booking on spothero.com to hold. Use future times; past or very short windows return no results.
- Upstream responses can change over time. Verify fields before relying on them.
- Not affiliated with or endorsed by spothero.com.

## Pricing

- Pay as you go: 0.0012 credits/request
- Trial: 1 free requests per buyer
- Billing order: trial requests -> subscribed plan requests -> pay as you go. 1 credit's USD value is shown on the marketplace page.

## HTTP routes

Only the public, buyer-facing parts of each route are listed; vendor-side credentials stay on the gateway.

### GET /search — Parking near a point
- Gateway: `GET https://api.apiclay.com/v1/api/spotheroparkingapi/search`
- Public query params: `lat` (number, required), `lon` (number, required), `starts` (string, required), `ends` (string, required), `page_size` (number), `after` (string)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /airport-search — Airport parking
- Gateway: `GET https://api.apiclay.com/v1/api/spotheroparkingapi/airport-search`
- Public query params: `iata` (string, required), `starts` (string, required), `ends` (string, required), `page_size` (number), `after` (string)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /facility — Facility
- Gateway: `GET https://api.apiclay.com/v1/api/spotheroparkingapi/facility`
- Public query params: `id` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /airports — Airports
- Gateway: `GET https://api.apiclay.com/v1/api/spotheroparkingapi/airports`
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /performers — Performers
- Gateway: `GET https://api.apiclay.com/v1/api/spotheroparkingapi/performers`
- Public query params: `search_query` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

## Call example

```bash
curl -X GET "https://api.apiclay.com/v1/api/spotheroparkingapi/search?lat=<lat>&lon=<lon>&starts=<starts>&ends=<ends>" \
  -H "token: <YOUR_APICLAY_TOKEN>"
```

Index of every published API: https://apiclay.com/llms.txt
