First Avenue APIfirst-avenue.com ↗
Access upcoming concert listings from First Avenue and partner Minneapolis venues. Returns artist, date, venue, ticket links, and support acts by month.
What is the First Avenue API?
The First Avenue API exposes 1 endpoint — list_shows — that returns all upcoming concerts and events across First Avenue and its associated Minneapolis venues for any given month, with each show object carrying up to 6 fields: artist, date, venue, ticket_url, event_url, and optional support acts. A typical monthly response covers 50–80 shows and requires no authentication.
curl -X GET 'https://api.parse.bot/scraper/30f92eac-5dbb-4f57-ab38-c950d88f6b83/list_shows?year=2026&month=07' \ -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 first-avenue-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.
"""Walkthrough: First Avenue Shows API — bounded, re-runnable; every call capped."""
from parse_apis.first_avenue_com_api import FirstAvenue, ParseError
client = FirstAvenue()
# List upcoming shows for the current month
for show in client.shows.list(limit=3):
print(show.artist, show.date, show.venue, show.ticket_url)
# List shows for a specific month
for show in client.shows.list(month="08", year="2026", limit=3):
print(show.artist, show.date, show.venue)
if show.support:
print(f" with {show.support}")
# Typed error handling
try:
first_show = client.shows.list(month="07", year="2026", limit=1).first()
print(first_show.artist, first_show.event_url)
except ParseError as e:
print(f"error: {e}")
print("exercised: shows.list")
List all shows for a given month across First Avenue and partner venues. Returns artist, date, venue, ticket link, and support acts. Results are a single-page list of all events in the selected month (typically 50-80 shows). When month/year are omitted, defaults to the current month.
| Param | Type | Description |
|---|---|---|
| year | string | 4-digit year (e.g. 2026). Must be provided together with month. |
| month | string | Month number 01-12. Must be provided together with year. |
{
"type": "object",
"fields": {
"shows": "array of show objects with artist, date, venue, ticket_url, event_url, and optional support",
"total": "integer count of shows returned"
},
"sample": {
"data": {
"shows": [
{
"date": "Jul 15",
"venue": "Fine Line",
"artist": "Nick Lowe and Los Straitjackets",
"event_url": "https://first-avenue.com/event/2026-07-nick-lowe-los-straitjackets/",
"ticket_url": "https://www.axs.com/events/1400693/nick-lowe-los-straitjackets-tickets?skin=fineline"
},
{
"date": "Jul 15",
"venue": "7th St Entry",
"artist": "The Body",
"support": "BIG|BRAVE and Scaphe",
"event_url": "https://first-avenue.com/event/2026-07-the-body/",
"ticket_url": "https://www.axs.com/events/1396979/the-body-tickets?skin=firstavenue"
},
{
"date": "Jul 1",
"venue": "Fine Line",
"artist": "TopOppGen",
"support": "Aziedoesntexist",
"event_url": "https://first-avenue.com/event/2026-07-topoppgen/",
"ticket_url": ""
}
],
"total": 73
},
"status": "success"
}
}About the First Avenue API
What the API Returns
The list_shows endpoint returns a flat array of show objects for a single calendar month. Each object includes the headlining artist, an ISO-formatted date, the specific venue within the First Avenue family (e.g. First Avenue, 7th Street Entry, Turf Club, Fine Line), a ticket_url pointing directly to the ticketing page, an event_url for the show detail page on first-avenue.com, and an optional support field listing opening acts when announced.
The response also includes a total integer representing the count of shows returned, which is useful for sanity-checking pagination assumptions or building summary dashboards without iterating the full array.
Parameters and Defaults
The endpoint accepts two optional query parameters: month (01–12) and year (4-digit). Both must be supplied together — providing only one is not supported. When neither is provided, the API defaults to the current month. This makes the endpoint immediately useful for "what's happening now" queries without any parameter setup.
Scope and Limitations
Coverage is limited to events listed on first-avenue.com, which includes multiple venues operated under the First Avenue umbrella in the Minneapolis area. The API does not expose historical show archives, sold-out status, ticket pricing tiers, or age restrictions. Results reflect the published monthly calendar at the time of the request.
The First Avenue API is a managed, monitored endpoint for first-avenue.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when first-avenue.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 first-avenue.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 local event calendar app showing upcoming Minneapolis concerts by venue using the
venuefield - Send weekly email digests of new shows added to the First Avenue calendar by comparing month snapshots
- Filter the
supportfield to track which local opening acts are getting booked at First Avenue venues - Aggregate
ticket_urldata to monitor when tickets go on sale for specific artists - Power a Slack bot that posts this week's shows pulled from the
dateandartistfields - Analyze booking patterns across First Avenue's venue portfolio by grouping results on the
venuefield
| 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 First Avenue have an official developer API?+
Which venues are included in the show listings?+
list_shows endpoint returns events across the full First Avenue family of venues in Minneapolis, which includes First Avenue, 7th Street Entry, Turf Club, Fine Line, and other partner spaces listed on first-avenue.com. Each show object includes a venue field so you can filter by location.Can I retrieve show data further than one month at a time?+
month and year combinations and merge the resulting shows arrays client-side.Does the API include sold-out status or ticket pricing?+
ticket_url linking to the ticketing page, but sold-out status, ticket price tiers, and availability counts are not exposed as structured fields. You can fork this API on Parse and revise it to add those fields from the linked ticket pages.