# Bandsintown API

> Bandsintown returns artist tour dates and concert listings, available as a workflow and API.

Bandsintown’s Get artist tour dates returns upcoming artist shows; provide an artist, with optional city and country. Bandsintown’s Search concerts returns city listings by date and genre; provide a city, with optional dates and genre.

- Page: https://fous.com/tools/bandsintown
- Handle: `@bandsintown`
- Category: [Entertainment](https://fous.com/tools/category/entertainment)
- Source website: https://bandsintown.com
- Last verified: Sep 29, 2026

## Methods

### Get artist tour dates

Operation `get_artist_tour_dates`, version 1. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.

Get an artist’s upcoming concerts, followers, venue locations, lineup and ticket links. City filtering matches the listed city, not a distance radius. Some event details may be unavailable on the event page.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `city` | string | no | `"Atlanta"` | Keep shows listed in this city, such as London. |
| `artist` | string | yes | `"Ed Sheeran"` | Artist name, such as Hozier. |
| `country` | string | no | `"US"` | Country name or two-letter code, such as United Kingdom or GB; blank means anywhere. |
| `max_results` | integer | no | `2` | Maximum number of shows, such as 50. |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "artist"
  ],
  "properties": {
    "city": {
      "type": "string",
      "description": "Keep shows listed in this city, such as London.",
      "examples": [
        "Atlanta"
      ]
    },
    "artist": {
      "type": "string",
      "description": "Artist name, such as Hozier.",
      "examples": [
        "Ed Sheeran",
        "Hozier"
      ]
    },
    "country": {
      "type": "string",
      "default": "",
      "description": "Country name or two-letter code, such as United Kingdom or GB; blank means anywhere.",
      "examples": [
        "US",
        "CL"
      ]
    },
    "max_results": {
      "type": "integer",
      "default": 50,
      "maximum": 200,
      "minimum": 1,
      "description": "Maximum number of shows, such as 50.",
      "x-fous-developer": true,
      "examples": [
        2
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "city": "Atlanta",
      "artist": "Ed Sheeran",
      "country": "US"
    },
    {
      "artist": "Hozier"
    },
    {
      "artist": "Ed Sheeran",
      "country": "CL",
      "max_results": 2
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `shows` | array |  |  |
| `shows[].city` | string or null | `"Atlanta"` |  |
| `shows[].venue` | string or null | `"Mercedes Benz Stadium"` |  |
| `shows[].lineup` | array |  |  |
| `shows[].region` | string or null | `"GA"` |  |
| `shows[].country` | string or null | `"United States"` |  |
| `shows[].festival` | string or null |  |  |
| `shows[].page_link` | string | `"https://www.bandsintown.com/e/107381647-ed-sheeran-at-mercedes-benz-stadium"` |  |
| `shows[].start_local` | string or null | `"2026-10-03T17:30:00-04:00"` |  |
| `shows[].ticket_link` | string or null | `"https://www.bandsintown.com/t/107381647?came_from=2500&app_id=bandsintown_web&utm_medium=web&utm_source=artist_event_pa` |  |
| `shows[].ticket_status` | string or null | `"Get Tickets"` |  |
| `followers` | integer | `8813335` |  |
| `artist_link` | string | `"https://www.bandsintown.com/a/190899-ed-sheeran"` |  |
| `artist_name` | string | `"Ed Sheeran"` |  |

**Example input**

```json
{
  "city": "Atlanta",
  "artist": "Ed Sheeran",
  "country": "US"
}
```

**Example output**

```json
{
  "shows": [
    {
      "city": "Atlanta",
      "venue": "Mercedes Benz Stadium",
      "lineup": [],
      "region": "GA",
      "country": "United States",
      "festival": null,
      "page_link": "https://www.bandsintown.com/e/107381647-ed-sheeran-at-mercedes-benz-stadium",
      "start_local": "2026-10-03T17:30:00-04:00",
      "ticket_link": "https://www.bandsintown.com/t/107381647?came_from=2500&app_id=bandsintown_web&utm_medium=web&utm_source=artist_event_page&utm_campaign=ticket",
      "ticket_status": "Get Tickets"
    }
  ],
  "followers": 8813335,
  "artist_link": "https://www.bandsintown.com/a/190899-ed-sheeran",
  "artist_name": "Ed Sheeran"
}
```

### Search concerts

Operation `search_concerts`, version 1. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.

Find upcoming concerts in a city for a date range and genre, with venue, local time, supporting lineup, and event link. Shows reflect Bandsintown listings and may include nearby venues.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `city` | string | yes | `"Austin, TX"` | City name, including state or region when needed, for example Austin, TX. |
| `genre` | string | no | `"rock"` | Genre, for example rock or hip-hop. Defaults to all genres. |
| `end_date` | string | no | `"2026-10-02"` | Last local concert date, for example 2026-10-08. Defaults to seven days after the start date; up to 90 days after it. |
| `start_date` | string | no | `"2026-09-29"` | First local concert date, for example 2026-10-01. Defaults to today. |
| `max_results` | integer | no | `3` | Most concerts to return, for example 50 (maximum 200). |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "city"
  ],
  "properties": {
    "city": {
      "type": "string",
      "description": "City name, including state or region when needed, for example Austin, TX.",
      "examples": [
        "Austin, TX",
        "San Francisco, CA"
      ]
    },
    "genre": {
      "type": "string",
      "description": "Genre, for example rock or hip-hop. Defaults to all genres.",
      "examples": [
        "rock"
      ]
    },
    "end_date": {
      "type": "string",
      "format": "date",
      "description": "Last local concert date, for example 2026-10-08. Defaults to seven days after the start date; up to 90 days after it.",
      "examples": [
        "2026-10-02"
      ]
    },
    "start_date": {
      "type": "string",
      "format": "date",
      "description": "First local concert date, for example 2026-10-01. Defaults to today.",
      "examples": [
        "2026-09-29"
      ]
    },
    "max_results": {
      "type": "integer",
      "default": 50,
      "maximum": 200,
      "minimum": 1,
      "description": "Most concerts to return, for example 50 (maximum 200).",
      "x-fous-developer": true,
      "examples": [
        3,
        4
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "city": "Austin, TX",
      "genre": "rock",
      "end_date": "2026-10-02",
      "start_date": "2026-09-29",
      "max_results": 3
    },
    {
      "city": "San Francisco, CA",
      "end_date": "2026-10-02",
      "start_date": "2026-09-29",
      "max_results": 4
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `concerts` | array |  |  |
| `concerts[].city` | string or null | `"Austin, TX"` |  |
| `concerts[].venue` | string or null | `"Private Event"` |  |
| `concerts[].artist` | string | `"Austin Gilliam"` |  |
| `concerts[].lineup` | array |  |  |
| `concerts[].event_link` | string | `"https://www.bandsintown.com/e/108738277-austin-gilliam-at-private-event?came_from=274&utm_medium=web&utm_source=search_` |  |
| `concerts[].start_time` | string | `"2026-09-29T17:00:00-05:00"` | Local concert start time with UTC offset. |

**Example input**

```json
{
  "city": "Austin, TX",
  "genre": "rock",
  "end_date": "2026-10-02",
  "start_date": "2026-09-29",
  "max_results": 3
}
```

**Example output**

```json
{
  "concerts": [
    {
      "city": "Austin, TX",
      "venue": "Private Event",
      "artist": "Austin Gilliam",
      "lineup": [],
      "event_link": "https://www.bandsintown.com/e/108738277-austin-gilliam-at-private-event?came_from=274&utm_medium=web&utm_source=search_result&utm_campaign=event",
      "start_time": "2026-09-29T17:00:00-05:00"
    },
    {
      "city": "Austin, TX",
      "venue": "Clive Bar",
      "artist": "Angelyn",
      "lineup": [],
      "event_link": "https://www.bandsintown.com/e/108901216-angelyn-at-clive-bar?came_from=274&utm_medium=web&utm_source=search_result&utm_campaign=event",
      "start_time": "2026-09-29T17:00:00-05:00"
    },
    {
      "city": "Austin, TX",
      "venue": "Lady Bird Johnson Wildflower Center",
      "artist": "Anna La Mare",
      "lineup": [],
      "event_link": "https://www.bandsintown.com/e/108687718-anna-la-mare-at-lady-bird-johnson-wildflower-center?came_from=274&utm_medium=web&utm_source=search_result&utm_campaign=event",
      "start_time": "2026-09-29T17:00:00-05:00"
    }
  ]
}
```

## Quick start

Replace `YOUR_API_KEY` with a Fous API key. To create one, open Developers at the bottom of Fous Studio, turn on Developer mode, then go to API keys (https://app.fous.com/keys). Change the values in `input` to run the same tool on new data.

```bash
curl 'https://api.fous.com/v1/query' \
  --fail-with-body --silent --show-error --max-time 180 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "api": "@bandsintown",
  "visibility": "public",
  "operation": "get_artist_tour_dates",
  "version": 1,
  "input": {
    "city": "Atlanta",
    "artist": "Ed Sheeran",
    "country": "US"
  },
  "response": {
    "format": "json"
  }
}'
```

```python
# Save as fous.py and run with python3 fous.py. No packages needed.
import json
import urllib.error
import urllib.request

api_key = "YOUR_API_KEY"

body = json.loads("{\n  \"api\": \"@bandsintown\",\n  \"visibility\": \"public\",\n  \"operation\": \"get_artist_tour_dates\",\n  \"version\": 1,\n  \"input\": {\n    \"city\": \"Atlanta\",\n    \"artist\": \"Ed Sheeran\",\n    \"country\": \"US\"\n  },\n  \"response\": {\n    \"format\": \"json\"\n  }\n}")
request = urllib.request.Request(
    "https://api.fous.com/v1/query",
    data=json.dumps(body).encode("utf-8"),
    headers={
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json",
    },
    method="POST",
)
try:
    with urllib.request.urlopen(request, timeout=180) as response:
        result = json.load(response)
except urllib.error.HTTPError as error:
    raise RuntimeError(f"HTTP {error.code}: {error.read().decode('utf-8', errors='replace')}") from error
if result.get("success") is False:
    raise RuntimeError(result.get("error", {}).get("message", "Request failed"))
print(json.dumps(result["data"]["output"], indent=2))
```

```typescript
// Save as fous.mts and run with npx tsx fous.mts.
const apiKey = "YOUR_API_KEY";

const response = await fetch("https://api.fous.com/v1/query", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  signal: AbortSignal.timeout(180_000),
  body: JSON.stringify({
  "api": "@bandsintown",
  "visibility": "public",
  "operation": "get_artist_tour_dates",
  "version": 1,
  "input": {
    "city": "Atlanta",
    "artist": "Ed Sheeran",
    "country": "US"
  },
  "response": {
    "format": "json"
  }
}),
});
type ApiResult = { success: boolean; data?: { output: unknown }; error?: { message: string } };
const result: ApiResult = await response.json();
if (!response.ok || result.success === false) {
  throw new Error(result.error?.message ?? `HTTP ${response.status}`);
}
if (!result.data) throw new Error("Missing API response data");
console.log(result.data.output);
```

## Use from an AI assistant

Connect this tool to Claude Code, Claude Desktop, Cursor, VS Code, Codex and any MCP client as its own MCP server. Each method is a typed tool whose arguments are the method’s input.

- Server URL: `https://api.fous.com/mcp/tools/bandsintown`
- Authorization: `Authorization: Bearer <Fous API key>`

**Tools**

- `get_artist_tour_dates`: Get artist tour dates. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `search_concerts`: Search concerts. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `fous_get_run`: the result of a run that was still going, by its `request_id`. Free.

Claude Code:

```bash
claude mcp add --scope user --transport http fous-bandsintown https://api.fous.com/mcp/tools/bandsintown --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"
```

To give the assistant every tool, connect `https://api.fous.com/mcp`: it finds one with `fous_search_tools` and runs it with `fous_run_tool`. Setup for other clients: https://fous.com/llms-full.txt.

## Use cases

- Track upcoming shows for an artist in selected cities.
- Find concerts by city, date range, and genre.
- Review concert venues and local start times.
- Collect ticket links and event pages for artist shows.
- Compare artist follower counts with upcoming tour dates.

## FAQ

### Can I run it with my own inputs?

Yes. Change the inputs in Studio and press Run, or send new inputs from your code, or ask a connected AI assistant.

### Can I call this Bandsintown tool as an API?

Yes. Send a POST request to /v1/query with your Fous API key and the inputs, and get JSON back.

### How much does it cost?

Each completed run costs 1 credit. Failed runs without a completed receipt are free; completed work can remain charged if delivery is interrupted. With pay as you go, a credit costs 1¢. Monthly plans cost less per credit.

### Do I need a Bandsintown account?

No. You only need a Fous account.

### How current is the data?

Fous gets the data from bandsintown.com when you run it. Some results are reused for up to 24 hours, and results that use your account or key are never reused. It was last verified on Sep 29, 2026.

### What upcoming concerts does an artist have?

Get artist tour dates returns upcoming concerts, venues, lineups, local start times, and ticket links for the artist you name.

### Which concerts are happening in a city this month?

Search concerts returns city listings for a date range, with venues, local times, lineups, and event links.

## Related

- [Songkick API](https://fous.com/tools/songkick.md): Songkick finds live concerts, festivals, and artist tour dates, including upcoming artist shows and city concerts within selected dates, with ticket links when available.
- [Ticketmaster API](https://fous.com/tools/ticketmaster.md): Ticketmaster finds upcoming live events and shows available ticket options with prices, excluding partner-only listings and offers requiring a code or sign-in.
- [setlist.fm API](https://fous.com/tools/setlist-fm.md): setlist.fm provides artists’ newest past concerts with performed songs, individual concert details and songs, and most-played songs by tour or year based on published setlists.
- [MusicBrainz API](https://fous.com/tools/musicbrainz.md): MusicBrainz provides community-maintained recording and release information, matching songs to identifiers and release dates and providing artist details and links when available; some release information may be incomplete.
- [Last.fm API](https://fous.com/tools/last-fm.md): Last.fm provides listening statistics, artist profiles, discovery, up to 50 tracks or albums, similar artists without percentages, and upcoming events that may be absent.
- [Spotify API](https://fous.com/tools/spotify.md): Spotify returns public artist profiles, album credits and ordered tracks, song details and play counts, up to 500 playlist songs, keyword results, and country-based podcast charts; dates and regional options vary.
- [Eventbrite API](https://fous.com/tools/eventbrite.md): Eventbrite helps discover live and online events, with public search results that may be limited and event details that may omit public ticket listings.
- [Genius API](https://fous.com/tools/genius.md): Genius provides lyrics, annotations, credits, and music knowledge, plus song stories, relationships, page details, and artist song lists by popularity or release date; dates and views may be unavailable.
- [All Entertainment tools](https://fous.com/tools/category/entertainment)