Bandsintown APIbandsintown.com ↗
Access Bandsintown concert data: search artists, get upcoming and past events by artist or city, fetch venue details with capacity, and resolve city slugs worldwide.
What is the Bandsintown API?
The Bandsintown API exposes 8 endpoints covering artist profiles, upcoming and past concert events, city event listings, venue discovery, and city slug resolution. The get_artist_events endpoint returns an artist's full upcoming tour schedule filtered by country or EU region, while search_venues finds live-music venues in any city with optional capacity range filtering. Together these endpoints give structured access to Bandsintown's global concert catalog.
curl -X GET 'https://api.parse.bot/scraper/25ccb7dd-ea12-4f2c-bb0a-966dbe1228e3/search_artists?query=Radiohead' \ -H 'X-API-Key: $PARSE_API_KEY'
Full-text search across Bandsintown's catalog. Returns matching artists, upcoming events near matching artists, festivals, and venues. Use artist id and name from results to construct slugs for get_artist_events (format: 'id-name', e.g. '1488-drake').
| Param | Type | Description |
|---|---|---|
| queryrequired | string | Search term for artist name (e.g., 'Drake', 'Radiohead') |
{
"type": "object",
"fields": {
"events": "array of upcoming event objects matching the search",
"venues": "array of venue objects matching the search",
"artists": "array of artist objects with id, name, verified, trackerText, href",
"festivals": "array of festival objects matching the search"
},
"sample": {
"data": {
"events": [
{
"id": 107813861,
"href": "https://www.bandsintown.com/e/107813861",
"venue": {
"name": "Soundwell",
"location": "Salt Lake City, UT"
},
"startsAt": "2026-06-14T19:00:00",
"timezone": "America/Denver",
"artistName": "Drake Milligan"
}
],
"venues": [],
"artists": [
{
"id": 1488,
"href": "https://www.bandsintown.com/a/1488-drake",
"name": "Drake",
"verified": true,
"trackerText": "9,133,322 Followers"
}
],
"festivals": []
},
"status": "success"
}
}About the Bandsintown API
Artist and Event Data
search_artists accepts a free-text query and returns matched artists (with id, name, verified flag, and href), upcoming events near those artists, festivals, and venues in a single response. Artist IDs from this endpoint compose the slug format (id-name, e.g. 1488-drake) required by get_artist_events and get_artist_past_events. If you already have an artist name but not their ID, get_artist_events_by_name runs the search internally and returns the same profile fields — follower_count, image_url, verified — plus the resolved artist_slug and artist_id for use in subsequent calls.
City and Venue Discovery
get_city_events takes a city_slug (e.g. new-york-ny) and returns paginated MusicEvent-schema events with name, startDate, location, performer, and offers. The start_date and end_date parameters narrow results to a date window; the next_page field in each response drives pagination. If you need to find the right slug first, resolve_city_slug accepts a free-form city name and optional country disambiguator (ISO 3166-1 alpha-2 or English country name) and returns the canonical city_slug, coordinates, region, population, and an alternatives array of other matching cities.
Venue Search
search_venues resolves a city name plus country_code to Bandsintown's city record, then returns proximity-ordered venue objects. Each venue includes id, name, slug, street_address, postal_code, url, location, capacity, and venue_type. The min_capacity / max_capacity parameters filter to venues within a specific size range; venues without a published capacity are excluded when either bound is set. Pagination uses offset and next_offset rather than page numbers.
Event Detail
get_event_details takes an event slug (e.g. 107813856-drake-milligan-at-asbury-lanes) and returns the full venue address via addressMultiline, rsvp_count, timezone, direct ticket_url, and a lineup array of co-billed artists. get_artist_past_events retrieves historical shows with latitude, longitude, city, and country per event, and accepts the same region / country filters as the upcoming events endpoint.
The Bandsintown API is a managed, monitored endpoint for bandsintown.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when bandsintown.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official bandsintown.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a tour-tracker app that shows upcoming shows for a list of followed artists using
get_artist_eventswith country filtering. - Generate a weekly digest of concerts in a specific city by polling
get_city_eventswithstart_dateandend_datebounds. - Find mid-size venues (500–2000 capacity) in a target city for event booking research using
search_venueswithmin_capacityandmax_capacity. - Enrich a music database with artist follower counts, verification status, and profile images from
get_artist_events_by_name. - Map historical tour routes for an artist by extracting
latitudeandlongitudefromget_artist_past_eventsresults. - Resolve ambiguous city names to canonical Bandsintown slugs before querying city events using
resolve_city_slugwith a country disambiguator. - Display co-billed lineups and RSVP counts on an event detail page using
get_event_details.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Bandsintown have an official developer API?+
How does `get_city_events` pagination work, and what event fields come back?+
page integer parameter to step through results. Each response includes a next_page field — when it is null, there are no further pages. Events are returned in MusicEvent schema format with name, startDate, location, performer, and offers fields. You can also narrow the window with start_date and end_date ISO date strings.Can I filter artist events by state or province, not just country or EU region?+
get_artist_events and get_artist_past_events support filtering by ISO 3166-1 alpha-2 country code or the EU region code; sub-national filtering (state, province, metro area) is not exposed. You can fork this API on Parse and revise it to add client-side filtering on the city field returned in each event object.Does the API return ticket prices or only ticket links?+
ticket_url links for events where ticketing is available, not structured price data. get_event_details also surfaces the venue address and RSVP count. Detailed pricing tiers are not part of any endpoint's response. You can fork this API on Parse and revise it to parse pricing data from the linked ticket pages.What is the `failed_venues` field in `search_venues` responses?+
failed_venues is an array of objects with id, name, and error for any venue whose detail page could not be loaded during the request. These venues are not included in the main venues array. If you need full coverage, you can retry those specific venues individually or adjust your limit and offset to re-scan.