↑ ↓ to move ↵ to open
SpotHero API · Endpoint

SpotHero Events Search API

Find events by name or by venue, with their SpotHero IDs, times and venue.

  • 1 credit per call
  • Failed calls are free
  • Updated
  • spothero.search
Response completed
{  "scraped_at": "2026-10-05T18:43:59Z",  "events": [    {      "title": "Pre-Season: Chicago Bulls v Phoenix Suns",      "city": "Chicago",      "destination_id": 2,      "destination_title": "United Center",      "end_time": "2026-10-07T22:00:00-05:00",      "event_id": 1418307,      "parking_ends": "2026-10-07T23:00:00-05:00",      "parking_starts": "2026-10-07T18:00:00-05:00",      "start_time": "2026-10-07T19:00:00-05:00"    },    {      "title": "Pre-Season: Chicago Bulls v Memphis Grizzlies",      "city": "Chicago",      "destination_id": 2,      "destination_title": "United Center",      "end_time": "2026-10-09T22:00:00-05:00",      "event_id": 1418601,      "parking_ends": "2026-10-09T23:00:00-05:00",      "parking_starts": "2026-10-09T18:00:00-05:00",      "start_time": "2026-10-09T19:00:00-05:00"    }  ]}
Try it live, free
Input

What you send

The input object of the request, with every field the endpoint accepts.

FieldTypeRequiredWhat it doesExample
destination_id integer one of A venue's SpotHero ID, to list its events.
query string one of An event's name, such as Chicago Bulls. Chicago Bulls
limit integer no How many events to return.
Response

Fields it returns

What each record in the response holds, with the values from the sample above.

FieldTypeWhat it isExample
events[].title string The name as SpotHero shows it. Pre-Season: Chicago Bulls v Phoenix Suns
events[].city string The city. Chicago
events[].destination_id integer SpotHero's ID for the venue; the venue and event endpoints take it. 2
events[].destination_title string The venue's name. United Center
events[].end_time string When the event ends. 2026-10-07T22:00:00-05:00
events[].event_id integer SpotHero's ID for the event; the event endpoints take it. 1,418,307
events[].parking_ends string When event parking ends. 2026-10-07T23:00:00-05:00
events[].parking_starts string When event parking starts. 2026-10-07T18:00:00-05:00
events[].start_time string When the parking or event starts. 2026-10-07T19:00:00-05:00
events array The events. 10 records
scraped_at string When the data was read. 2026-10-05T18:43:59Z
REST API · MCP server

Call it from your code, or ask your agent

Set UPSCRAPE_API_KEY to your key and copy a working request.

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.search",  "input": {    "query": "Chicago Bulls"  }}'
In your AI agent Claude · Cursor · any MCP client
1Add the Upscrape MCP server
https://data.upscrape.com/mcp
2Ask for the data in plain words

Using Upscrape, find Chicago Bulls events on SpotHero and list their dates, venues and event IDs.

The agent finds the endpoint, shows you the price, and runs it with your credits.
SpotHero

More from the SpotHero API

Questions

SpotHero Events Search API FAQ

The short answers. The docs have the long ones.

Still have a question? Talk to the people who build the endpoints.
How much does the SpotHero Events Search API cost?

1 credit per successful call, shown before it runs. You buy credits once, and paid credits never expire.

What do I send?

Send query or destination_id. The input fields below list every option with its type and limits.

Do I need a SpotHero login?

No. It reads public SpotHero data; nothing runs on your account.

Can my AI agent call it?

Yes, over MCP: the agent finds spothero.search, checks its price and runs it with the same credits as the REST API.

Get started

Your first SpotHero call is free.

Up to 100 free credits to start, no card needed.