Events API

Welcome! This is the developer-friendly API for ipswich.love – a handy way to access this week’s upcoming events across our vibrant town. Whether you’re building a community screen, local app, or just curious, this feed gives you a quick and simple snapshot of what’s happening in Ipswich.

We’ve kept it light and fast – no sign-up, no authentication, just pure JSON. Below, you’ll find everything you need to get started, including usage details, data format, and a few simple terms to keep things running smoothly for everyone.

Enjoy building – and thank you for supporting local events!

Endpoint

GET /api/events-this-week/

Description

Returns up to 10 random published events happening during the current calendar week. Each event includes:

id: WordPress post ID
title: Event title
permalink: URL of the event page
next_event_date: Unix timestamp of next occurrence
acf: All available ACF fields for the event

Response Format

{
  "readme": "Returns up to 10 random published events happening this week...",
  "success": true,
  "count": 10,
  "events": [
    {
      "id": 123,
      "title": "Ipswich Jazz Festival",
      "permalink": "http://ipswich.love/event/ipswich-jazz",
      "next_event_date": 1754304000,
      "acf": {
        "location": "Ipswich Corn Exchange",
        "organiser": "Jazz Suffolk"
      }
    }
  ]
}

Notes

The data is cached and refreshed hourly.
You do not need authentication to access this endpoint.
All times are Unix timestamps in UTC unless otherwise stated.

Terms of Use

By using the /api/events-this-week/ endpoint, you agree to the following terms:

Fair Use
This API is provided for personal or community use, including local apps, displays, and non-commercial projects. Please avoid excessive automated requests (e.g., more than once per minute).
Attribution
If you display event data publicly (e.g., on a website or screen), please include credit such as:
Event listings provided by Ipswich.Love
No Guarantee of Availability
We may change, pause, or remove this API at any time without notice. While we aim to provide accurate and up-to-date data, we cannot guarantee completeness or correctness.
No Resale or Redistribution
You must not sell or redistribute this data as part of a paid product or service without written permission.
Data Caching
Please respect the hourly cache — do not re-fetch the endpoint more often than once every 60 seconds unless explicitly allowed.
Abuse
Any misuse or abuse (e.g., scraping with high frequency, misrepresenting the data, or violating UK law) may result in access being blocked.
Privacy
This API does not collect or store personal data. However, the underlying website may use standard analytics tools.