Bandsintown
Access live, upcoming and past music events by location, venue and artist name.
Version: 1.0.0•Category: Entertainment
GET /search
Find events, artists, festivals, and venues based on various filters, including keywords, location, and date range.
Parameters
keyword
STRING
Search term to filter results by artist, event, festival, or venue name. For example, use "Coldplay" to find events related to the artist Coldplay
city
STRING
A city for location-based searches (e.g., "New York").
types
STRING
Specifies the types of results to include in the search. Available types are "artist", "event", "festival", and "venue". Multiple types can be specified as a comma-separated list (e.g., "artist,event").
page
NUMBER
latitude
NUMBER
Coordinates for location-based searches. Use these to find events within a specific radius of a geographical point.
longitude
NUMBER
Coordinates for location-based searches. Use these to find events within a specific radius of a geographical point.
radius
NUMBER
The radius (in kilometers) around the specified location (latitude/longitude or city name) to search for events. Defaults to 75 km if not specified.
starts_at
DATE (YYYY-MM-DD)
Specifies the starting date and time for the search. Only events happening on or after this date will be included in the results. Use ISO 8601 date format (YYYY-MM-DDTHH:MM:SSZ) or (YYYY-MM-DD)
ends_at
DATE (YYYY-MM-DD)
Specifies the ending date and time for the search. Only events happening on or before this date will be included in the results. Use ISO 8601 date format (YYYY-MM-DDTHH:MM:SSZ) or (YYYY-MM-DD)
sort
STRING
Determines the sorting order of the results. Options include
- popularity **Default**
- start_date
- announcement_date
- on_sale_date
filter
STRING
Filters events based on type. Options include physical (for in-person events) and streaming (for online events).
genre
STRING
Filters by genre. Available genres include
- alternative
- blues
- christian-gospel
- classical
- country
- comedy
- electronic
- folk
- hip-hop
- jazz
- latin
- metal
- pop
- punk
- rnb-soul
- reggae
- rock
If left empty, all genres are included
Code Examples
Language:
Client:
fetch('https://api.apivex.com/bandsintown/search?types=event&keyword=metallica', {
method: 'GET',
headers: {
'x-apivex-key': 'YOUR_API_KEY'
}
})
.then(response => response.json())
.then(data => console.log(data));Responses
200
Successful response