Bandsintown APIbandsintown.com ↗
Search artists, get upcoming concerts by artist or city, and retrieve event details including venue addresses and ticket URLs via the Bandsintown API.
What is the Bandsintown API?
The Bandsintown API exposes 4 endpoints covering artist search, upcoming events by artist or city, and per-event detail. The get_artist_events endpoint returns an artist's full profile alongside a list of upcoming shows with venue names, city, start times, and direct ticket URLs. The get_event_details endpoint adds full venue addresses, RSVP counts, and timezone data for individual events.
curl -X GET 'https://api.parse.bot/scraper/25ccb7dd-ea12-4f2c-bb0a-966dbe1228e3/search_artists?query=Radiohead' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace bandsintown-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Bandsintown concert discovery: search artists, browse city events, get event details."""
from parse_apis.bandsintown_api import Bandsintown, CitySlug, ResourceNotFound
client = Bandsintown()
# Search for artists by name — limit caps total items fetched
for artist in client.artists.search(query="Radiohead", limit=3):
print(artist.name, artist.tracker_text, artist.verified)
# Get an artist's profile and upcoming events by slug
profile = client.artistprofiles.get(artist="1488-drake")
print(profile.name, profile.follower_count, len(profile.events), "upcoming events")
# Browse city events using the CitySlug enum
page = client.cityeventpages.get(city_slug=CitySlug.NEW_YORK_NY, page=1)
print(page.city_slug, page.next_page)
# Get full event details with venue and ticket info
try:
event = client.events.get(event="107813856-drake-milligan-at-asbury-lanes")
print(event.artist_name, event.venue.name, event.venue.address, event.starts_at)
except ResourceNotFound as exc:
print(f"Event not found: {exc}")
print("exercised: artists.search / artistprofiles.get / cityeventpages.get / events.get")
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 Search and Profiles
The search_artists endpoint accepts a query string and returns arrays of matching artists, events, venues, and festivals in a single call. Each artist object includes id, name, verified status, trackerText, and href. The artists array is the primary source for the slug you'll pass to get_artist_events — slugs follow the format {id}-{name}, for example 1488-drake.
Artist Events
Passing an artist slug to get_artist_events returns an artist object (with image_url, follower_count, and verified) alongside an events array. Each event carries title, venue_name, city, starts_at, and ticket_url. Only upcoming events are returned; past shows are not in scope.
City Events and Pagination
The get_city_events endpoint takes a city_slug such as denver-co or new-york-ny and returns a list of events structured as MusicEvent objects with name, startDate, location, performer, and offers. The next_page field in the response indicates whether additional pages exist; pass the page integer parameter to walk through them. The city_slug field is echoed back in the response for easy correlation.
Event Detail
get_event_details accepts an event slug obtained from search_artists or get_city_events results and returns the deepest level of data: a venue object with address, addressMultiline, and url; ISO datetimes for starts_at and ends_at; a timezone identifier; rsvp_count; and a ticket_url where available. The artist_id field links back to the artist record.
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 concert calendar app that lists upcoming shows in a given city using
get_city_eventswith pagination. - Monitor a specific artist's tour schedule by polling
get_artist_eventsand alerting when new dates appear. - Aggregate
ticket_urllinks from event detail responses to compare ticket availability across multiple artists. - Display artist profile cards — including
follower_count,image_url, andverifiedstatus — fromget_artist_eventsresponses. - Build a venue discovery tool by collecting
venueobjects (withaddressandurl) fromget_event_detailscalls. - Create a festival tracker by extracting the
festivalsarray returned bysearch_artistsfor a given query. - Power a geo-aware events widget by iterating city slugs and combining
startDateandlocationfields from city event results.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Bandsintown have an official developer API?+
What does `get_event_details` return that the other endpoints don't?+
get_event_details is the only endpoint that returns a full venue object with address and addressMultiline, an ends_at ISO datetime, the timezone identifier, and rsvp_count. The artist-level and city-level endpoints return venue_name and city as plain strings without the full address breakdown.Does the API cover past or historical events?+
get_artist_events and get_city_events both return future shows; get_event_details applies to events reachable via those results. You can fork this API on Parse and revise it to target Bandsintown's past-events pages if historical data is needed.Can I filter city events by genre or date range?+
get_city_events accepts only city_slug and page as parameters. The returned events are not filterable by genre, date window, or venue type within the API. You can fork it on Parse and revise to add genre or date filtering against the response data.How does pagination work for city events?+
page parameter of get_city_events. The response includes a next_page field — if it is an integer, that value is the next page to request. If next_page is null, you have reached the last page of results for that city slug.