@openpets/bandsintown

Bandsintown Pet

Access artist information and event data from Bandsintown. Get upcoming concerts, past events, venue details, and ticket information for any artist.

Features

• Search for artists and get profile information
• Get upcoming, past, or all events for any artist
• Filter events by date range
• Access venue details including location coordinates
• Get ticket links and availability status

Setup

1. Get Your App ID

Contact Bandsintown at http://help.bandsintown.com/ to request a personal application ID. You'll need to describe your use case and agree to their Terms and Conditions.

2. Configure Environment

# Add to your .env file
BANDSINTOWN_APP_ID=your_app_id_here

3. Test Connection

opencode run "test bandsintown connection"

Available Tools

Custom Tools (Convenience Wrappers)

Tool	Description
bandsintown-search-artist	Search for an artist and get their profile (auto-includes app_id)
bandsintown-get-events	Get events for an artist with optional date filtering (auto-includes app_id)

OpenAPI Generated Tools

Tool	Description
bandsintown-artist	Get artist information (requires app_id parameter)
bandsintown-artist-events	Get events with date filtering (requires app_id parameter)
bandsintown-test-connection	Test API connection status

Example Queries

# Search for an artist
opencode run "search for Radiohead on bandsintown"

# Get upcoming events
opencode run "get upcoming events for Taylor Swift"

# Get all events including past shows
opencode run "get all events for Coldplay including past shows"

# Get events in a date range
opencode run "find concerts for Beyoncé between 2024-01-01 and 2025-12-31"

Response Data

Artist Information

{
  "id": 510,
  "name": "Maroon 5",
  "url": "http://www.bandsintown.com/Maroon5",
  "image_url": "https://s3.amazonaws.com/bit-photos/large/7481529.jpeg",
  "thumb_url": "https://s3.amazonaws.com/bit-photos/thumb/7481529.jpeg",
  "facebook_page_url": "https://www.facebook.com/maroon5",
  "tracker_count": 1234567,
  "upcoming_event_count": 15
}

Event Information

{
  "id": "13722599",
  "artist_id": "438314",
  "url": "http://www.bandsintown.com/event/13722599",
  "datetime": "2024-03-19T11:00:00",
  "on_sale_datetime": "2024-03-01T18:00:00",
  "description": "Festival performance",
  "venue": {
    "name": "Madison Square Garden",
    "city": "New York",
    "region": "NY",
    "country": "United States",
    "latitude": "40.7505",
    "longitude": "-73.9934"
  },
  "offers": [
    {
      "type": "Tickets",
      "url": "http://www.bandsintown.com/event/13722599/buy_tickets",
      "status": "available"
    }
  ],
  "lineup": ["Artist Name", "Supporting Act"]
}

Date Filtering Options

The date parameter accepts:

Value	Description
upcoming	Only upcoming events (default)
past	Only past events
all	All events (past and upcoming)
2024-01-01,2024-12-31	Events within a date range

Special Characters in Artist Names

If an artist name contains special characters, use these codes:

Character	Code
/	%252F
?	%253F
*	%252A
"	%27C

Regenerating OpenAPI Tools

To update the generated tools from the latest Bandsintown API spec:

cd pets/bandsintown
pets generate-openapi --verbose

API Documentation

• Bandsintown API Documentation
• Bandsintown Help Center