# Bandsintown — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search for artists and discover their upcoming concerts, or browse live events happening in specific cities with detailed ticket information. Find exactly what shows you're interested in attending with artist profiles, event dates, venues, and direct links to purchase tickets.

**Category:** Music | **Website:** [bandsintown.com/](https://bandsintown.com/) | **Docs:** [parse.bot/marketplace/11ac4662-194e-4b32-85e7-d4d9e54e75be/bandsintown-com-api](https://parse.bot/marketplace/11ac4662-194e-4b32-85e7-d4d9e54e75be/bandsintown-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-bandsintown-com-api-11ac4662/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_artist_events

Get profile information and upcoming events for a specific artist. Takes an artist slug in 'id-name' format (e.g. '1488-drake'). Returns the artist's profile (name, image, follower count) and a list of upcoming events. Artists with no scheduled shows return an empty events array. Optionally filter events by country (ISO 3166-1 alpha-2 code) or region ('EU' for the 27 EU member states: AT, BE, BG, HR, CY, CZ, DK, EE, FI, FR, DE, GR, HU, IE, IT, LV, LT, LU, MT, NL, PL, PT, RO, SK, SI, ES, SE). When neither country nor region is provided, all worldwide events are returned.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `artist` | string | Yes | Artist slug in format 'id-name' (e.g., '1488-drake', '1005-drake-bell'). Obtain from search_artists results by combining artist id and lowercased hyphenated name. |
| `country` | string | No | ISO 3166-1 alpha-2 country code to filter events (e.g. 'DE', 'FR', 'US'). When omitted, returns all events worldwide. |
| `region` | string | No | Region code to filter events. Currently supports 'EU' for the 27 EU member states. When omitted, returns all events worldwide. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-bandsintown-com-api-11ac4662/get_artist_events \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"artist":"<string>","country":"<string>","region":"<string>"}'
```

### get_artist_events_by_name

Resolve an artist by name (using search) and return their profile and upcoming events. Searches Bandsintown's catalog for the best-matching artist, then fetches their profile page. Returns the same fields as get_artist_events plus the resolved artist_slug and artist_id for downstream use. Optionally filter events by country (ISO 3166-1 alpha-2 code) or region ('EU' for the 27 EU member states: AT, BE, BG, HR, CY, CZ, DK, EE, FI, FR, DE, GR, HU, IE, IT, LV, LT, LU, MT, NL, PL, PT, RO, SK, SI, ES, SE). When neither country nor region is provided, all worldwide events are returned.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `artist_name` | string | Yes | Artist name to search for (e.g., 'Drake', 'Radiohead'). The best-matching artist from search results is used. |
| `country` | string | No | ISO 3166-1 alpha-2 country code to filter events (e.g. 'DE', 'FR', 'US'). When omitted, returns all events worldwide. |
| `region` | string | No | Region code to filter events. Currently supports 'EU' for the 27 EU member states. When omitted, returns all events worldwide. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-bandsintown-com-api-11ac4662/get_artist_events_by_name \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"artist_name":"<string>","country":"<string>","region":"<string>"}'
```

### get_artist_past_events

Get past concert events for a specific artist from their tour history. Takes an artist slug in 'id-name' format (e.g. '1488-drake'). Returns the artist's past events with venue, location, and timing details. Optionally filter by country (ISO 3166-1 alpha-2 code) or region ('EU' for the 27 EU member states: AT, BE, BG, HR, CY, CZ, DK, EE, FI, FR, DE, GR, HU, IE, IT, LV, LT, LU, MT, NL, PL, PT, RO, SK, SI, ES, SE). When neither country nor region is provided, all past events worldwide are returned.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `artist` | string | Yes | Artist slug in format 'id-name' (e.g., '1488-drake', '25874-radiohead'). Obtain from search_artists results by combining artist id and lowercased hyphenated name. |
| `country` | string | No | ISO 3166-1 alpha-2 country code to filter events (e.g. 'DE', 'FR', 'US'). When omitted, returns all past events worldwide. |
| `region` | string | No | Region code to filter events. Currently supports 'EU' for the 27 EU member states. When omitted, returns all past events worldwide. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-bandsintown-com-api-11ac4662/get_artist_past_events \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"artist":"<string>","country":"<string>","region":"<string>"}'
```

### get_city_events

Get upcoming events for a specific city. Returns events from the city's event page. Supports pagination via the page parameter. When coordinates are available from the page, uses the pagination API for richer results; otherwise returns JSON-LD structured data. Events can be filtered by date range using start_date and end_date.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `city_slug` | string | Yes | City slug (e.g., 'denver-co', 'new-york-ny', 'san-francisco-ca', 'los-angeles-ca') |
| `end_date` | string | No | ISO date (YYYY-MM-DD) to filter events on or before this date. |
| `page` | integer | No | Page number for pagination. |
| `start_date` | string | No | ISO date (YYYY-MM-DD) to filter events on or after this date. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-bandsintown-com-api-11ac4662/get_city_events \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"city_slug":"<string>","end_date":"<string>","page":"<integer>","start_date":"<string>"}'
```

### get_event_details

Get detailed information for a single event, including direct ticket links, full venue address, RSVP count, and event lineup (co-billed artists). Takes an event slug from search or city event results (format: 'id-slug', e.g. '107813856-drake-milligan-at-asbury-lanes'). Returns comprehensive event data including venue address, timezone, and lineup array.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `event` | string | Yes | Event slug (e.g., '107813856-drake-milligan-at-asbury-lanes'). Obtain from search_artists events or get_city_events results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-bandsintown-com-api-11ac4662/get_event_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"event":"<string>"}'
```

### search_artists

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').

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search term for artist name (e.g., 'Drake', 'Radiohead') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-bandsintown-com-api-11ac4662/search_artists \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```