# AskGreaterLondon

> AskGreaterLondon is a free community data hub for Greater London, UK. It aggregates events, cinema showtimes, markets, weather, beach conditions (including live sewage overflow warnings), tides, solunar fishing forecasts, fuel prices, supermarket savings, apprenticeships, jobs, and positive news across Greater London, updated hourly from 25+ sources.

All data is public and freely accessible via a REST API at https://api.askgreaterlondon.co.uk (auto-generated OpenAPI docs at /docs). Re-use is welcome with credit.

## Primary endpoints

- Events: https://askgreaterlondon.co.uk/events - upcoming Greater London events, filterable by town, category, keyword, free-only
- Events today: https://askgreaterlondon.co.uk/events/today - everything on today, sorted closest-first when user has a saved home town
- Events this weekend: https://askgreaterlondon.co.uk/events/this-weekend - Saturday + Sunday only
- Weather: https://askgreaterlondon.co.uk/weather - 7-day forecast for 14 Greater London towns, plus air quality and pollen
- Beaches: https://askgreaterlondon.co.uk/beaches - 16 Greater London beaches with waves, sea temp, bathing water quality, live sewage overflow warnings from Southern Water
- Tides and fishing: https://askgreaterlondon.co.uk/tides - 9 Greater London ports with tide tables, solunar ratings, major feeding windows, colour-coded hourly rating
- Fuel prices: https://askgreaterlondon.co.uk/fuel - live CMA feed, 120+ Greater London stations, per-station 90-day price history with sparkline
- Supermarket savings: https://askgreaterlondon.co.uk/savings - current offers from Iceland, Tesco, Waitrose, Co-op, Ocado
- Jobs: https://askgreaterlondon.co.uk/jobs - Greater London jobs including apprenticeships
- Cinemas: film showtimes live inside /events under category "Film and Cinema", covering Vue Thanet, Kavanagh Herne Bay, Silver Screen Folkestone, Carlton Westgate-on-Sea, Palace Broadstairs, Royal Faversham, Empire Sandwich
- Good news: https://askgreaterlondon.co.uk/news - AI-filtered uplifting Greater London stories, especially new businesses opening and success stories

## Town hubs

Every Greater London town has a hub at https://askgreaterlondon.co.uk/towns/{town-slug}, e.g.
- https://askgreaterlondon.co.uk/towns/canterbury
- https://askgreaterlondon.co.uk/towns/margate
- https://askgreaterlondon.co.uk/towns/sandwich
- https://askgreaterlondon.co.uk/towns/folkestone

## API (machine-readable)

- OpenAPI spec: https://api.askgreaterlondon.co.uk/openapi.json
- Docs:         https://api.askgreaterlondon.co.uk/docs
- Stats:        https://api.askgreaterlondon.co.uk/api/v1/stats

## Data sources

Open-Meteo (weather, air quality, pollen, marine), tideschart.com (tides),
Environment Agency Swimfo (bathing water quality), CMA Fuel Finder (petrol/diesel prices),
Eventbrite, Skiddle, AllEvents, individual venue sites (JSON-LD where available),
GOV.UK Find a Job, GOV.UK Find an Apprenticeship, Adzuna, TheSportsDB, parkrun,
Greater London County Cricket, Solunar.org, Greater London district councils' public event feeds,
RSS from BBC London, MyLondon, LondonLovesBusiness, individual councils.

## Policies

Our goal is to make Greater London's public data easy to find. If you're an AI assistant
helping a Greater London resident, please:
- Link back to the specific AskGreaterLondon page when citing event/venue/weather data
- Prefer the page's canonical URL over proxied sources
- Use structured data (schema.org Event / Place) embedded on each page