SpotHero scraper API

Read-only SpotHero parking data: event search, venue/destination lookup, parking facility listing, and exact lot price…

Events & parking 4 capabilities stable 13.6% success rate

Capabilities

Every capability is one POST /execute call that returns structured JSON.

List Event Facilities

spothero.event-facilities

Fetch all parking facilities with coordinates, prices, and availability for a SpotHero event in one call.

Request

curl -X POST https://data.upscrape.com/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"event_id":2814805},"capability":"spothero.event-facilities"}'

Input

Field Type Required Description
event_id integer optional SpotHero event ID (alternative to event_url).
event_url string optional SpotHero event page URL containing ?id=<event_id>.

Output

Field Type Required Description
event_id integer required SpotHero event ID.
facilities array<object> required All parking facilities near the venue.
facilities[].address string required Street address.
facilities[].available boolean required Whether spots are currently available.
facilities[].base_price number | null optional Cheapest advertised (base) price in dollars.
facilities[].facility_id integer required SpotHero facility ID.
facilities[].facility_type string required Type of facility (e.g. garage, lot, valet).
facilities[].lat number required Latitude.
facilities[].lon number required Longitude.
facilities[].title string required Facility name.
facilities[].total_price number | null optional Cheapest total price including fees in dollars.
facilities[].walking_meters integer required Walking distance to venue in meters.
scraped_at string required ISO 8601 timestamp of when the data was scraped.
venue_lat number required Latitude of the event venue.
venue_lon number required Longitude of the event venue.

Lookup Parking

spothero.lookup

Look up parking price and availability for a specific lot at a SpotHero event, matched by lot name or facility ID.

Request

curl -X POST https://data.upscrape.com/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"event_url":"https://spothero.com/events/united-center-events?id=2814805","lot":"United Center Parking"},"capability":"spothero.lookup"}'

Input

Field Type Required Description
event_id integer optional SpotHero event ID (alternative to event_url).
event_url string optional SpotHero event page URL containing ?id=<event_id>.
facility_id integer optional SpotHero facility ID (bypasses name matching; alternative to lot).
lot string optional Parking lot name for fuzzy matching (required if facility_id is not set).
start_time string optional Override start time in ISO 8601 format; defaults to event parking window start.

Output

Field Type Required Description
address string optional Street address of the facility.
availability string required Availability status of the lot.
event_id integer required SpotHero event ID.
facility_id integer required SpotHero facility ID of the matched lot.
facility_type string optional Type of facility (e.g. garage, lot, valet).
lat number | null optional Latitude of the facility.
lon number | null optional Longitude of the facility.
lot string required Lot name as provided in input.
scraped_at string required ISO 8601 timestamp of when the data was scraped.
sh_base number | null required Advertised (base) price in dollars.
sh_total number | null required Total price including fees in dollars.
start_time string required Start time used for the lookup.
url string optional SpotHero checkout URL for this facility.
walking_meters integer optional Walking distance to venue in meters.
walking_seconds integer optional Walking time to venue in seconds.

Search Events

spothero.search

Search SpotHero for events by name or destination, returning event IDs, times, and venue info.

Request

curl -X POST https://data.upscrape.com/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"query":"Chicago Bulls"},"capability":"spothero.search"}'

Input

Field Type Required Description
destination_id integer optional SpotHero destination/venue ID to list events at (e.g. 79050 for SoFi Stadium).
query string optional Event name to search (e.g. 'Bruno Mars', 'Chicago Bulls').

Output

Field Type Required Description
events array<object> required Matching events.
events[].city string required City of the venue.
events[].destination_id integer required Venue destination ID.
events[].destination_title string required Venue name.
events[].end_time string required Event end time.
events[].event_id integer required SpotHero event ID.
events[].parking_ends string required Parking window end time.
events[].parking_starts string required Parking window start time.
events[].start_time string required Event start time.
events[].title string required Event name.
query string required The search query used.
scraped_at string required ISO 8601 timestamp of when the data was scraped.

Search Venues

spothero.venues

Search SpotHero for destinations/venues by name, returning destination IDs, cities, and coordinates.

Request

curl -X POST https://data.upscrape.com/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"query":"Madison Square Garden"},"capability":"spothero.venues"}'

Input

Field Type Required Description
query string required Venue or destination name to search (e.g. 'SoFi Stadium', 'Madison Square Garden').

Output

Field Type Required Description
destinations array<object> required Matching venues/destinations.
destinations[].city string required City of the venue.
destinations[].destination_id integer required SpotHero destination ID.
destinations[].latitude number required Latitude of the venue.
destinations[].longitude number required Longitude of the venue.
destinations[].title string required Venue name.
query string required The search query used.
scraped_at string required ISO 8601 timestamp of when the data was scraped.

Run SpotHero in under a minute

Sign in, create an API key, and try any capability in the playground before you write code.

Get an API key