No Dice.fm account or API key required. Look up an artist's or venue's upcoming shows, browse a city's or country's events, filter by genre or date, search by keyword, or pull the full worldwide city and venue directories — returns event details, ticket links, lineup, and venue data in clean JSON.

Why this API?

No credentials to manage — no upstream API key required
Six query modes — artist events, venue events, browse (city/country/genre/date filters), keyword search, city directory, venue directory
Exact artist, venue & city filtering — results are genuinely scoped to what you asked for (not fuzzy keyword matches), with full pagination
City + venue directories — the ~79 cities Dice operates in and ~5,000 venues worldwide

How artist / venue / city lookup works: you pass a name; the API resolves it to Dice's internal ID (artists/venues via Dice's search, cities via the city directory), then fetches that ID's exact event list. Name resolution is fuzzy, so an obscure name may not resolve — if it doesn't, you get an empty data with the resolved ID null. Pass a numeric Dice ID (artist/venue) or city ID directly to skip resolution — get city IDs from GET /cities, venue IDs from GET /venues.

Not supported (confirmed genuinely dead upstream): filtering by status, sold-out, or sort order. Dice's public events API has no working parameter for these in any form (singular, plural, or ID variants all checked). Results come date-ascending by default.

Endpoints

Endpoint	What it returns
`GET /events/artist`	All upcoming events for a specific artist (exact ID filter)
`GET /events/venue`	All upcoming events at a specific venue (exact ID filter)
`GET /events`	Browse events, filterable by city, country, date range, and genre/type tag
`GET /events/search`	Text search across event, artist, and venue names
`GET /cities`	City directory — the ~79 cities Dice operates in
`GET /venues`	Full worldwide venue directory

Quick start

GET /events/artist?performer=Bicep
GET /events/venue?venue=Public+Records

GET /events?city=London
GET /events?country=GB&genreTag=gig:techno
GET /events?dateFrom=2026-04-01&dateTo=2026-04-30

GET /events/search?q=boiler+room

GET /cities
GET /venues

Parameters

GET /events/artist

Parameter	Type	Description
`performer`	string	Required. Artist name (e.g. `Bicep`), or a numeric Dice artist ID to skip name lookup
Also accepts `dateFrom`, `dateTo`, `genreTag`, `typeTag`, `page`, `pageSize`.

GET /events/venue

Parameter	Type	Description
`venue`	string	Required. Venue name (e.g. `Public Records`), or a numeric Dice venue ID from `GET /venues` to skip name lookup
Also accepts `dateFrom`, `dateTo`, `genreTag`, `typeTag`, `page`, `pageSize`.

GET /events

Parameter	Type	Description
`city`	string	City name (e.g. `London`) or a Dice city ID from `GET /cities`
`country`	string	ISO-2 country code (e.g. `GB`, `US`) — events across all of that country's Dice cities
`dateFrom`	string	Start of date range — `YYYY-MM-DD`
`dateTo`	string	End of date range — `YYYY-MM-DD`
`genreTag`	string	Genre filter (e.g. `gig:techno`, `gig:hardrock`, `culture:foodanddrink`)
`typeTag`	string	Top-level type filter (e.g. `music:gig`, `culture:sport`)
`featured`	boolean	`true` to return only featured events
`page`	integer	Page number for pagination
`pageSize`	integer	Results per page (max 50)

When city or country is used, the response includes a resolved object showing the Dice city IDs matched; an unresolvable name/code returns empty data rather than an unfiltered feed.

GET /events/search

Parameter	Type	Description
`q`	string	Required. Text to search across event, artist, and venue names

Search results come from a different upstream endpoint than the other modes, so a few fields are always empty for search results specifically: description, age_limit, ticket_types, genre_tags. Everything else (dates, venue, artists, pricing, images, URL) is populated. Artist/venue/browse modes return the full event object.

GET /cities

No parameters required. Returns the city directory. Use a city's id or name with GET /events?city=, or its country_code with ?country=.

GET /venues

No parameters required. Returns the full venue directory.

Output fields

Event object (all event endpoints)

Field	Description
`id`	Dice.fm event ID
`name`	Event name
`date`	Start date/time (ISO 8601, UTC)
`date_end`	End date/time — set for multi-day events
`timezone`	IANA timezone (e.g. `Europe/London`)
`status`	`on-sale`, `off-sale`, or `cancelled`
`sold_out`	Whether the event is sold out
`venue`	Venue name (string)
`venues`	Array of venue objects with ID, name, city, and Dice.fm URL
`location`	Object with street, city, state, zip, country, lat, lng
`cities`	Array of city objects with code, name, and country
`description`	Full event description (browse only — empty on search results)
`age_limit`	Age restriction text (browse only — empty on search results)
`presented_by`	Presenter/organizer
`artists`	Array of artist objects on the bill (often empty — see notes)
`lineup`	Array of lineup entries with set times
`ticket_types`	Array of ticket types with face value, fees, and total price (browse only — empty on search results)
`price`	Base ticket price (often null — see notes)
`currency`	Currency code (e.g. `USD`, `GBP`)
`genre_tags`	Genre tags (e.g. `gig:techno`) — browse only, empty on search results
`type_tags`	Event type tags (e.g. `music:gig`)
`event_images`	Object with landscape, portrait, square, and brand image URLs
`url`	Dice.fm event link
`flags`	Feature flags (e.g. `qr-code`, `going_ahead`, `cancelled`)

Note: in practice, Dice.fm's browse feed returns [] for artists and null for price on the large majority of events — most listings carry their lineup in lineup instead and their pricing in ticket_types.

Venue object (GET /venues)

Field	Description
`venue_id`	Dice.fm venue ID (string, not numeric)
`name`	Venue name
`bundle_url`	Dice.fm venue slug
`location.full_address`	Full street address
`location.city.name`	City name
`location.country`	Country
`location.lat` / `location.long`	Coordinates
`location.place`	IANA timezone (e.g. `America/New_York`)

City object (GET /cities)

Field	Description
`id`	Dice.fm city ID — pass as `city` to `GET /events`
`name`	City name (e.g. `London`)
`perm_name`	City slug
`country_code`	ISO-2 country code — pass as `country` to browse
`country_name`	Country name
`location.lat` / `location.lng`	Coordinates
`location.place`	IANA timezone

Latency & caching

Responses are synchronous. The first request for an uncached query fetches live data:

Endpoint	Max latency	Cache TTL
`/events`, `/events/search`, `/events/artist`, `/events/venue`	~2s	1 hour
`/cities`, `/venues`	~2s	24 hours

Subsequent requests within the TTL return instantly from cache.

Error reference

Code	Meaning
`400`	Missing required parameter (e.g. `?q=`, `?performer=`, `?venue=`)
`401`	Missing or invalid API key
`500`	Unexpected server error

Use cases

City event feeds — browse everything in a city or across a country via GET /events?city= / ?country=
Artist tour tracking — pull an artist's full upcoming Dice show list by name via GET /events/artist
Venue calendars — pull a venue's full schedule via GET /events/venue
Electronic music platforms — Dice.fm specializes in electronic, club, and underground events
Ticket monitoring — watch availability across an artist's, venue's, or city's events
Calendar integrations — sync shows to Google Calendar, Notion, or Airtable

Direct access via x402

This API also supports x402 — a micropayment protocol for direct, pay-per-request access without a RapidAPI subscription. Pay $0.001 per request in USDC on Base.

Hit the server directly with an x402-compatible client:

GET https://webscrapers.onrender.com/dicefm/events/artist?performer=Four+Tet
GET https://webscrapers.onrender.com/dicefm/events?city=London
GET https://webscrapers.onrender.com/dicefm/cities

No account or API key required — just a Base wallet with USDC. See x402.org for client libraries and documentation.

This API is not affiliated with Dice.fm. Use responsibly and in accordance with Dice.fm's terms of service.