API Documentation
Live Music Locator - API Documentation
Introduction
If you are using this dataset, please acknowledge it with the following:
Data courtesy of Live Music Locator: https://lml.live
The base URL for the API is:
https://api.lml.live
A note about timezones: dates do not have a time component, and times are stored as minutes since midnight in the local timezone of the gig. The API will show gigs for a specified date and location - it’s up to the client to decide what “today” means.
Authentication
All API endpoints are open and do not require authentication.
Endpoints
Gigs
GET /gigs
A signpost to this documentation. It does not return gigs - use /gigs/query below.
Params: None
Example:
curl https://api.lml.live/gigs | jq
{
"name": "Live Music Locator API",
"documentation": "https://api.lml.live/docs",
"attribution": "Data courtesy of Live Music Locator: https://lml.live"
}
GET /gigs/query
Query all gigs by date range and location.
Params:
date_from: Date in format `YYYY-MM-DD` (required)
date_to: Date in format `YYYY-MM-DD` (required)
location: String (required)
token: An API token
If no location, date_from, and date_to are provided, returns an empty array. The location parameter is a string representing the gig location, for example melbourne or goldfields. Only fetches gigs for up to 7 days from date_from unless a valid token is supplied.
The special value anywhere returns gigs across every location the gig guide publishes, which is not necessarily every location we hold gigs for - a location can be kept out of the guide while it is being worked on. Name such a location explicitly and you will still get its gigs.
Example:
curl https://api.lml.live/gigs/query \
--url-query location=melbourne \
--url-query date_from=2025-01-06 \
--url-query date_to=2025-01-06 | jq '.[:1]'
[
{
"id": "cf7e468c-be2f-4ef3-b392-79583f89d436",
"name": "DNB Mondays Hello 2025",
"date": "2025-01-06",
"ticketing_url": null,
"start_time": "17:55",
"start_timestamp": "2025-01-06T17:55:00.000+11:00",
"duration": null,
"finish_time": null,
"finish_timestamp": null,
"description": null,
"status": "confirmed",
"ticket_status": null,
"series": null,
"category": null,
"information_tags": [
"Free"
],
"genre_tags": [
"DNB"
],
"venue": {
"id": "1799e48d-d69b-447e-b021-bde1e3fce9e4",
"name": "Radio Bar and Cafe",
"address": "357 Brunswick Street Fitzroy",
"capacity": 90,
"website": "https://www.instagram.com/radio_bar/",
"postcode": "3065",
"vibe": null,
"tags": [],
"location_url": null,
"latitude": -37.796438,
"longitude": 144.978574
},
"sets": [
{
"start_time": null,
"start_timestamp": null,
"duration": null,
"finish_time": null,
"finish_timestamp": null,
"act": {
"id": "8fba6235-6cc2-4e8f-8889-e73735d1d678",
"name": "DNB Mondays Hello 2025",
"genres": null
}
},
{
"start_time": null,
"start_timestamp": null,
"duration": null,
"finish_time": null,
"finish_timestamp": null,
"act": {
"id": "e48bd2b5-4310-4db7-9654-ce9056414515",
"name": "Radio Bar",
"genres": null
}
}
],
"prices": []
}
]
GET /gigs/:id
Find a gig by id.
Params:
id: UUID (required)
Example:
curl https://api.lml.live/gigs/0a4427bc-8968-4253-9cb5-b906ec121b42 | jq
{
"id": "0a4427bc-8968-4253-9cb5-b906ec121b42",
"name": "Black Jesus Experience",
"date": "2025-02-23",
"ticketing_url": null,
"start_time": "18:30",
"start_timestamp": "2025-02-23T18:30:00.000+11:00",
"duration": null,
"finish_time": null,
"finish_timestamp": null,
"description": null,
"status": "confirmed",
"ticket_status": null,
"series": null,
"category": null,
"information_tags": [
"free"
],
"genre_tags": [
"Funk",
"Hip-Hop",
"Azmari"
],
"venue": {
"id": "0e9591fc-2b76-4735-8f63-5b105b657eae",
"name": "the Horn African Cafe",
"address": "20 Johnston Street Collingwood",
"capacity": null,
"website": "http://thehorncafe.com.au/",
"postcode": "3066",
"vibe": "African groove",
"tags": [],
"location_url": "37.7989764,144.985427",
"latitude": -37.798948,
"longitude": 144.985472
},
"sets": [],
"prices": []
}
GET /gigs/for/:location/:date
List gigs at specified location and date.
Params:
location: String (required)
date: Date in format `YYYY-MM-DD` (required)
If no location and date are provided, returns an empty array. The location parameter is a string representing the gig location, for example melbourne or goldfields.
Example:
curl https://api.lml.live/gigs/for/melbourne/2025-01-06 | jq '.[:1]'
[
{
"id": "cf7e468c-be2f-4ef3-b392-79583f89d436",
"name": "DNB Mondays Hello 2025",
"date": "2025-01-06",
"ticketing_url": null,
"start_time": "17:55",
"start_timestamp": "2025-01-06T17:55:00.000+11:00",
"duration": null,
"finish_time": null,
"finish_timestamp": null,
"description": null,
"status": "confirmed",
"ticket_status": null,
"series": null,
"category": null,
"information_tags": [
"Free"
],
"genre_tags": [
"DNB"
],
"venue": {
"id": "1799e48d-d69b-447e-b021-bde1e3fce9e4",
"name": "Radio Bar and Cafe",
"address": "357 Brunswick Street Fitzroy",
"capacity": 90,
"website": "https://www.instagram.com/radio_bar/",
"postcode": "3065",
"vibe": null,
"tags": [],
"location_url": null,
"latitude": -37.796438,
"longitude": 144.978574
},
"sets": [
{
"start_time": null,
"start_timestamp": null,
"duration": null,
"finish_time": null,
"finish_timestamp": null,
"act": {
"id": "8fba6235-6cc2-4e8f-8889-e73735d1d678",
"name": "DNB Mondays Hello 2025",
"genres": null
}
},
{
"start_time": null,
"start_timestamp": null,
"duration": null,
"finish_time": null,
"finish_timestamp": null,
"act": {
"id": "e48bd2b5-4310-4db7-9654-ce9056414515",
"name": "Radio Bar",
"genres": null
}
}
],
"prices": []
}
]
GET /gigs/feed
An RSS 2.0 feed of every gig from today to seven days out, across all locations. Not JSON, and takes no parameters - it is the feed the “How To Use” page points subscribers at.
Params: None
Example:
curl https://api.lml.live/gigs/feed
<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0">
<channel>
<title>Live Music Locator - gig feed</title>
<description>Discover all live music events in the City of Yarra.</description>
<link>https://lml.live</link>
<language>en</language>
<item>
<title>ITRI of the Sands – August Residency Night 4 - The Workers Club (Melbourne) - Tue, 25 Aug 2026</title>
<description>ITRI of the Sands – August Residency Night 4 - The Workers Club (Melbourne) - Tue, 25 Aug 2026</description>
<author>LML</author>
<pubDate>Wed, 18 Mar 2026 18:28:56 +1000</pubDate>
<link>https://lml.live/gigs/1c0dd490-2fb4-4f63-97cc-a1573cfa2f95</link>
<guid>https://lml.live/gigs/1c0dd490-2fb4-4f63-97cc-a1573cfa2f95</guid>
</item>
</channel>
</rss>
Acts
GET /acts/:id
Find an act by id, with the gigs it is playing from today onwards. Each upcoming gig carries the venue it is at.
Params:
id: UUID (required)
Example:
curl https://api.lml.live/acts/cc3207f3-8ad3-4b16-8bfd-48a6c9df99c9 | jq
{
"id": "cc3207f3-8ad3-4b16-8bfd-48a6c9df99c9",
"name": "Stevenson's Rockets",
"genres": null,
"upcoming_gigs": [
{
"id": "fa574b83-c3fd-4705-aa15-816c6e09c37a",
"name": "Jazz on Wednesday Nights - Stevenson's Rockets (Live)",
"date": "2026-08-26",
"start_time": "18:00",
"start_timestamp": "2026-08-26T18:00:00.000+10:00",
"ticketing_url": "https://bookings.nowbookit.com/?accountid=451752fd-fa6a-4a9f-8adc-3bcee1635ff4&venueid=7232",
"status": "confirmed",
"ticket_status": null,
"venue": {
"id": "fa92ec27-baf8-4353-b57b-adaeedfba807",
"name": "The Emerald",
"address": "415 Clarendon St, South Melbourne VIC 3205",
"capacity": null,
"website": "http://www.theemeraldhotel.com.au/",
"postcode": "3205",
"vibe": "",
"tags": [],
"location_url": "https://maps.app.goo.gl/rJJzEnSBEzFVwX2y7",
"latitude": -37.8372641,
"longitude": 144.9627459
}
}
]
}
Venues
GET /venues/:id
Find a venue by id, with the gigs it is hosting from today onwards. This is the mirror of /acts/:id: each upcoming gig carries its sets and the acts playing them, rather than the venue.
Params:
id: UUID (required)
Example:
curl https://api.lml.live/venues/fa92ec27-baf8-4353-b57b-adaeedfba807 | jq
{
"id": "fa92ec27-baf8-4353-b57b-adaeedfba807",
"name": "The Emerald",
"address": "415 Clarendon St, South Melbourne VIC 3205",
"capacity": null,
"website": "http://www.theemeraldhotel.com.au/",
"postcode": "3205",
"vibe": "",
"tags": [],
"location_url": "https://maps.app.goo.gl/rJJzEnSBEzFVwX2y7",
"latitude": -37.8372641,
"longitude": 144.9627459,
"upcoming_gigs": [
{
"id": "fa574b83-c3fd-4705-aa15-816c6e09c37a",
"name": "Jazz on Wednesday Nights - Stevenson's Rockets (Live)",
"date": "2026-08-26",
"start_time": "18:00",
"start_timestamp": "2026-08-26T18:00:00.000+10:00",
"ticketing_url": "https://bookings.nowbookit.com/?accountid=451752fd-fa6a-4a9f-8adc-3bcee1635ff4&venueid=7232",
"status": "confirmed",
"ticket_status": null,
"sets": [
{
"start_time": "18:00",
"start_timestamp": "2026-08-26T18:00:00.000+10:00",
"duration": null,
"finish_time": null,
"finish_timestamp": null,
"act": {
"id": "cc3207f3-8ad3-4b16-8bfd-48a6c9df99c9",
"name": "Stevenson's Rockets",
"genres": null
}
}
]
}
]
}