For developers · free API key

What’s On events, in your app.

The events guests see in What’s On by FreeGuides, as JSON: a city’s gigs, markets, nights out and weekly socials, by country, city and category. Ask for a key and build with it.

Request an API key

Free. We read every request and email the key.

How many requests a day, roughly?

We’ll email your key to this address once it’s approved.

What you get

  • Events by city and categoryWhat’s on this week in a city, filtered by category, date range or keywords.
  • Times that are rightStart and end in the venue’s own time zone, and every night of a weekly event.
  • Ready to showVenue, price, image, the What’s On page and the organiser’s booking link.
  • Any language, any stackJSON over GET or POST, from a server or a browser (CORS open).

How it works

  1. 1Request a keyTell us who you are and what you’re building.
  2. 2We approve itThe team reads every request and emails your key.
  3. 3Send it with each requestIn an X-API-Key header. Keep it private, like a password.

A request

curl -H "X-API-Key: YOUR_KEY" \
  "https://explore.freeguides.com/api/v1/events?country=Australia&city=Sydney&category=nightlife"

Leave out category for every event, or add date, from and to, limit and q. https://explore.freeguides.com/api/v1/categories lists the categories and countries covered. Link to events with the bookingUrl we send, as it is.

Questions? hello@freeguides.com