What it returns
Search upcoming live events (concerts, sports, theater, comedy, family shows) across the US, Canada, UK, Ireland, Australia, New Zealand, Mexico and more, and get clean structured listings you can export to CSV, Excel or JSON or pull through the API.
Event name, ID and ticket page URL. Local date and time, UTC timestamp, timezone, status (on sale, cancelled, postponed, rescheduled). Public on-sale and off-sale dates, plus presale windows. Category: segment, genre and sub-genre. Price range (min, max, currency) where published. Venue: name, ID, street address, city, state, country, postcode, latitude and longitude. Performers / attractions, promoter, ticket limit, important notes, seat map and a high-resolution image.
Common uses
Build a local events calendar or newsletter. Track tour dates and on-sale times for artists or teams. Venue and promoter market research. Feed event data into travel, hospitality or ticketing apps.
Request
POST https://api.pushbuild.com/events-search/run with a JSON body. Send your key in the X-API-Key header.
| Field | Type | Description |
|---|---|---|
keywords | list of strings | Artists, teams, shows or any search words. Each keyword is searched separately. Leave empty to list every event matching the location and date filters. |
city | string | City name, e.g. Boston. |
stateCode | string | e.g. MA, CA, ON. |
countryCode | string | ISO code, e.g. US, CA, GB, AU, IE, MX, NZ. Default: "US". |
postalCode | string | Search around this postcode (use with radius). |
latlong | string | Search around a point, e.g. 42.36,-71.06 (use with radius). |
radius | integer | Distance around the postcode or point. |
unit | string: miles, km | Miles or kilometres. Default: "miles". |
classificationName | string | Music, Sports, Arts & Theatre, Film, Miscellaneous, or a genre such as Rock, Basketball, Comedy. |
startDate | string | YYYY-MM-DD. Events on or after this day. |
endDate | string | YYYY-MM-DD. Events on or before this day. |
venueId | string | Only events at this venue (venueId from a previous run). |
sort | string: date,asc, date,desc, relevance,desc, name,asc | Order of results. Default: "date,asc". |
maxResults | integer | Up to 1,000 per keyword. Narrow by date or location to cover more. Default: 200. |
maxItems | integer | Maximum items to return (1-500). Default: 100. |
Example
curl -X POST https://api.pushbuild.com/events-search/run \
-H "X-API-Key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"keywords": ["Taylor Swift"], "maxItems": 20}'Response
{"count": 20, "truncated": false, "seconds": 1.4, "items": [ { ... } ]}Each call returns up to 500 items. Records that fail validation or are not found are flagged in the items and not charged.
Pricing
Pay only for results returned: $0.80 per 1,000 events. No charge for errors or empty searches.
Related APIs
Bank of England API: Bank Rate, SONIA, Gilts & Mortgages API
Bank of England statistics from its official database: Bank Rate, SONIA, gilt yields, implied inflation, mortgage rates and approvals, M4 money, lending and sterling FX.
BLS Data API: Any Bureau of Labor Statistics Series API
Any US Bureau of Labor Statistics time series by id (CPI, payrolls by industry, unemployment, wages, PPI, JOLTS, import prices) plus state unemployment and labor force from plain state codes, with month-over-month and year-over-year changes..
Cboe Put/Call Ratios & VIX Futures Term Structure API
Daily Cboe options statistics: total, equity, index, SPX and VIX put/call ratios with call and put volume and open interest by product, plus the VIX futures curve with settlements, open interest and contango versus spot VIX..
CFPB Consumer Complaints: Banks, Lenders, Fintech API
Search 18 million+ official CFPB consumer complaints against banks, lenders, card issuers, debt collectors, credit bureaus and fintechs.
CFTC Commitments of Traders (COT) Reports API
Weekly CFTC Commitments of Traders positioning for every futures market: legacy, disaggregated (managed money, producers, swap dealers) and financial (leveraged funds, asset managers).
ClinicalTrials.gov API
Search 500,000+ clinical studies from ClinicalTrials.gov by condition, drug, sponsor, location, phase and status.
Tell us what you need built.
Questions about this API, higher volumes, or a data source you need that we don't cover yet.
hello@pushbuild.com