# SpotHero parking · Search parking

Get places and reviews from maps with SpotHero parking · Search parking from Alexandria through one Spiral API key. Find parking near a place or venue for a specific arrival and departure time and compare quoted prices; follow `facility_id` into facility_quote or facility_reviews. It runs in the background and returns structured JSON. Pay as you go, with no subscription.

- Provider: Alexandria
- Category: Maps & Reviews
- Runs: In the background
- Returns: json
- Tool id: `alexandria` / `spothero-com/parking/search_parking`
- Page: https://spiral.ai/tools/alexandria/spothero-com/parking/search_parking

## Pricing

$0.00873 per call.

## Limits

- Longest queue wait: 1 hour
- Run deadline: 5 minutes
- Longest run, end to end: 225 minutes
- Largest inline input: 1 MB
- Largest input file: 2 GB
- Largest output: 5 GB

## Input

| Field | Kind | Allowed | Default | Description |
| --- | --- | --- | --- | --- |
| `ends` | text |  | — | Local wall-clock time at the parking location, `YYYY-MM-DDTHH:mm` or `YYYY-MM-DDTHH:mm:ss`, no offset (SpotHero interprets it in the facility's time zone). Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}(:[0-9]{2})?$. |
| `cursor` | text |  | — | `next_cursor` from a previous page of this function. When given, the other search inputs must be omitted. |
| `starts` | text |  | — | Local wall-clock time at the parking location, `YYYY-MM-DDTHH:mm` or `YYYY-MM-DDTHH:mm:ss`, no offset (SpotHero interprets it in the facility's time zone). Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}(:[0-9]{2})?$. |
| `latitude` | number | -90 to 90 | — | latitude |
| `oversize` | true or false |  | — | Search for an oversize vehicle (default false). |
| `longitude` | number | -180 to 180 | — | longitude |
| `page_size` | number | 1 to 25 | — | Results per page (default 10, at most 25). |
| `destination_id` | number | 1 to … | — | SpotHero destination id (e.g. 2 United Center, 583 O'Hare); from `destination_id` fields of events, airports or a pasted `/search?kind=destination&id=` URL. |
| `show_unavailable` | true or false |  | — | Include facilities that cannot be booked for the window, with their `unavailable_reasons` (default false). |
| `max_distance_meters` | number | 100 to 20000 | — | Search radius; SpotHero's default is used when omitted. |

## Example

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "alexandria",
    "model": "spothero-com/parking/search_parking",
    "input": {
      "ends": "<ends>"
    }
  }'
```

Try it in the Playground: https://spiral.ai/start?provider=alexandria&model=spothero-com%2Fparking%2Fsearch_parking

## Common questions

### SpotHero parking · Search parking

**How much does SpotHero parking · Search parking cost?**

$0.00873 per call. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.

**How do I use SpotHero parking · Search parking through an API?**

Send `POST /v1/runs` with `"provider": "alexandria"`, `"model": "spothero-com/parking/search_parking"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.

**Do I need an account with Alexandria to use SpotHero parking · Search parking?**

No. Spiral runs it on its own Alexandria account and charges your Spiral balance.

**Can my AI agent use SpotHero parking · Search parking?**

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.

