An unofficial API for the parades commission of Northern Ireland
  • JavaScript 100%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Gary Moore 0c255753e6 Refactor fuzzy search functionality and update API routes
- Modified fuzzyMatchStreet function to accept an array of street names instead of a single string, enhancing the fuzzy matching capability.
- Updated API endpoint from '/parades' to '/upcoming-parades' to better reflect its purpose.
- Changed '/parades_by_street_belfast/:street' to '/parades-by-street-belfast/:street' for consistency in route naming.
- Adjusted parade parsing logic to extract proposed outward and return routes as arrays of street names, improving data handling.
- Updated compatibility date in wrangler.toml to reflect the latest deployment.
2025-10-13 23:00:54 +01:00
src Refactor fuzzy search functionality and update API routes 2025-10-13 23:00:54 +01:00
.gitignore initial commit 2023-05-13 19:06:25 +01:00
.prettierrc.json feat: initial implementation of Parades API 2023-05-14 00:54:57 +01:00
LICENSE Create LICENSE 2024-10-07 15:23:39 +01:00
package.json Refactor fuzzy search functionality and update API routes 2025-10-13 23:00:54 +01:00
pnpm-lock.yaml Refactor fuzzy search functionality and update API routes 2025-10-13 23:00:54 +01:00
README.md Refactor fuzzy search functionality and update API routes 2025-10-13 23:00:54 +01:00
wrangler.toml Refactor fuzzy search functionality and update API routes 2025-10-13 23:00:54 +01:00

Unofficial Parades Commission API

This doesn't do too much at the minute. Here's the routes available:

  • /upcoming-parades - lists all upcoming parades in the North
  • /parades-by-street-belfast/:street - List all the upcoming parades by street.

There's query params for /parades available as well.

  • ?location - Filter by town or city
  • ?start=some_start_date&end=some_end_date - Specify a start or end. This probably doesn't work yet.

For now, parades by street is Belfast only. I didn't want to bother dealing with geo APIs to figure out what city or town a street is in, so it just assumes Belfast.

Some unfortunate details

To search by street name, we need to visit the details page for each parade in Belfast to get the list of streets the parade is on. Not really great, so we're caching this in a Cloudflare KV store.