↑ ↓ to move ↵ to open
SpotHero API reference

SpotHero Hourly Parking Search

spothero.parking.search

Find hourly and daily parking near a point for a time window: each facility's total and base price, availability, address, walking distance, operator and rating.

At a glance

Endpoint ID
spothero.parking.search
Price
1–2 credits per call; failed calls are free
Runs for up to
30 seconds
Request
POST /execute
Run an endpoint
MCP tool when pinned
spothero__parking__search
Pin tools
OpenAPI
openapi.json
Download

Request

Send the endpoint ID as capability and its fields as input. Set UPSCRAPE_API_KEY to your key first.

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 '{  "capability": "spothero.parking.search",  "input": {    "ends": "2026-10-10T20:00:00-05:00",    "latitude": 41.881943,    "longitude": -87.630976,    "starts": "2026-10-10T16:00:00-05:00"  }}'

Input

FieldTypeRequiredWhat it doesExample
ends string yes When parking ends, in the same format. 2026-10-10T20:00:00-05:00
latitude number yes Where you want to park: the latitude of the destination. 41.881943
longitude number yes Where you want to park: the longitude of the destination. -87.630976
starts string yes When parking starts, with its time zone, such as 2026-10-10T16:00:00-05:00. 2026-10-10T16:00:00-05:00
cursor string no Pass next_cursor from the last response to get the next page.
include_unavailable boolean no Keep facilities that have no space for that window.
limit integer no How many facilities to return.
max_distance_meters integer no How far from the point to look, in metres.

Response

A finished call answers with HTTP 200; the data is in results[0].data, and billing.credits_charged is what it cost. A call still running after the wait answers 202: see jobs and results.

This is results[0].data from a real run:

results[0].data
{  "search_type": "transient",  "facilities": [    {      "title": "100 W Monroe St. - Hyatt Centric The Loop Chicago",      "address": "100 West Monroe Street",      "available": true,      "base_price": 70.5,      "facility_id": 96444,      "facility_type": "valet_stand",      "lat": 41.880914999999995,      "lon": -87.631092,      "navigation_tip": "Enter this location on West Monroe Street. Arrive at 100 W Monroe St. This is the Valet Stand for Hyatt Centric The Loop, operated by SP+. …",      "operator": "SP+ Parking",      "rating_average": 4.1,      "rating_count": 27,      "total_price": 74.73,      "walking_meters": 167    },    {      "title": "172 W Madison St. - Washington-Madison-Wells (WMW) Garage",      "address": "172 W Madison St",      "available": true,      "base_price": 15,      "facility_id": 118195,      "facility_type": "garage",      "lat": 41.88198,      "lon": -87.63324,      "navigation_tip": "****Parking is available on all levels of the garage, including the rooftop. Please proceed up the ramps if lower levels appear full.\r\n\r\nEnte…",      "operator": "InterPark Parking",      "rating_average": 4.6,      "rating_count": 4662,      "total_price": 15.99,      "walking_meters": 202    }  ]}

Fields

FieldTypeWhat it isExample
facilities[].title string The name as SpotHero shows it. 100 W Monroe St. - Hyatt Centric The Loop Chicago
facilities[].address string The parking facility's street address. 100 West Monroe Street
facilities[].total_price number The price with fees. 74.73
facilities[].base_price number The price before fees. 70.5
facilities[].available boolean Whether a space can be booked for the time asked. true
facilities[].walking_meters integer The walk from the facility to the destination, in metres. 167
facilities[].rating_average number The facility's average star rating. 4.1
facilities[].operator string The company that runs the facility. SP+ Parking
facilities[].facility_type string The kind of facility, such as a lot or garage. valet_stand
facilities[].facility_id integer SpotHero's ID for the facility. 96,444
facilities[].lat number The facility's latitude. 41.88
facilities[].lon number The facility's longitude. -87.63
facilities[].navigation_tip string The facility's directions for drivers. Enter this location on West Monroe Street. Arrive at 100 W Monr…
facilities[].rating_count integer How many ratings the facility has. 27
facilities array The parking facilities. 20 records
search_type string Whether hourly or monthly parking was searched. transient

If a call fails

A failed call costs nothing. The response carries an error.code you can branch on; Errors and retries lists every code and which ones to retry.

Other SpotHero endpoints

Something missing or unclear? Ask the team that builds the SpotHero endpoints.