DICE
Unified search
Search across events, artists and venues by free text, optionally biased toward a location.
Costs 2 credits per request.
Authorization
ApiKeyAuth X-API-Key<token>
API key created in the extractr dashboard (ext_live_...). Also accepted as Authorization: Bearer.
In: header
Query Parameters
q*string
Length
1 <= lengthlat?|
Range
-90 <= value <= 90lng?|
Range
-180 <= value <= 180limit?integer
Range
1 <= value <= 30Default
10Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/dice/search?q=overmono"{ "query": "string", "events": [ { "id": "6a537c5e3bebf0000107926c", "name": "Percolate presents Overmono", "status": "on-sale", "url": "https://dice.fm/event/6a537c5e3bebf0000107926c", "images": { "square": "https://dice-media.imgix.net/a1b2c3.jpg", "landscape": "string" }, "venue": { "id": 12903, "name": "Village Underground", "address": "54 Holywell Lane", "city": "London", "country_code": "GB", "latitude": 51.5266, "longitude": -0.078 }, "date": { "start": "2026-09-12T20:00:00.000Z", "end": "2026-09-13T03:00:00.000Z", "timezone": "Europe/London", "on_sale": "2026-07-01T09:00:00.000Z" }, "price": { "amount": 2500, "currency": "GBP", "amount_from": 1500, "display": "£25.00" }, "lineup": [ "Overmono", "Anz" ], "tag": "techno" } ], "artists": [ { "id": "string", "name": "string", "image": "string" } ], "venues": [ { "id": 12903, "name": "Village Underground", "address": "54 Holywell Lane", "city": "London", "country_code": "GB", "latitude": 51.5266, "longitude": -0.078 } ]}{ "error": { "code": "invalid_api_key", "message": "The provided API key is invalid or has been revoked." }}{ "error": { "code": "invalid_api_key", "message": "The provided API key is invalid or has been revoked." }}{ "error": { "code": "invalid_api_key", "message": "The provided API key is invalid or has been revoked." }}{ "error": { "code": "invalid_api_key", "message": "The provided API key is invalid or has been revoked." }}{ "error": { "code": "invalid_api_key", "message": "The provided API key is invalid or has been revoked." }}{ "error": { "code": "invalid_api_key", "message": "The provided API key is invalid or has been revoked." }}{ "error": { "code": "invalid_api_key", "message": "The provided API key is invalid or has been revoked." }}