Open listings tools

Build with Jazz Live UK.

Machine-readable feeds are rebuilt from the same published catalogue as the website. They contain upcoming, non-draft events and require no API key for reasonable public use.

application/json

JSON API

Structured upcoming events for integrations and prototypes.

Open resource →

text/csv

CSV feed

Spreadsheet-ready export with one row per upcoming event.

Open resource →

application/rss+xml

National RSS

Subscribe to all new and upcoming UK listings.

Open resource →

HTML + JSONP

Embeddable widget

A hosted venue, musician or city calendar with attribution.

Open resource →

Quick start

fetch('https://clubgre2jazz.com/uk/api/v1/events.json')
  .then((response) => response.json())
  .then(({ events, attribution }) => {
    const list = document.querySelector('#shows');
    list.innerHTML = events.slice(0, 10)
      .map((event) => `<li>${event.attribution_html}</li>`)
      .join('');
    list.insertAdjacentHTML('afterend', `<p>${attribution.html}</p>`);
  });

Usage notes

CC BY 4.0 licence, with a link back

The listings data (date, venue, city, artist, style and the link to each show page) is published under Creative Commons Attribution 4.0. You can reuse it, commercially too, as long as you credit Jazz Live UK with a visible link to the show page or to our listings.

Not covered by the licence: photos (they belong to their photographers, venues or artists), ticket links (they belong to each ticketing site) and third-party text. Ask whoever published them for permission.

How to credit us

Every show in the JSON comes with event_url and a ready-made attribution_html, and the JSON root carries attribution and license. The CSV adds attribution_url to every row.

As text

Data: Jazz Live UK (clubgre2jazz.com)

As HTML, for each show

<a href="https://clubgre2jazz.com/uk/gigs/{id}/">Show title</a> · Data: <a href="https://clubgre2jazz.com/uk/whats-on/">Jazz Live UK</a>

Badge

Jazz Live UK listings

<a href="https://clubgre2jazz.com/uk/whats-on/" style="display:inline-block;padding:6px 10px;border:1px solid #d4a85a;border-radius:6px;color:#d4a85a;font:600 12px/1 system-ui,sans-serif;text-decoration:none">Jazz Live UK listings</a>