# AskKent

> AskKent is a free community data hub for Kent, 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 Kent, updated hourly from 25+ sources.

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

## Primary endpoints

- Events: https://askkent.co.uk/events - upcoming Kent events, filterable by town, category, keyword, free-only
- Events today: https://askkent.co.uk/events/today - everything on today, sorted closest-first when user has a saved home town
- Events this weekend: https://askkent.co.uk/events/this-weekend - Saturday + Sunday only
- Weather: https://askkent.co.uk/weather - 7-day forecast for 14 Kent towns, plus air quality and pollen
- Beaches: https://askkent.co.uk/beaches - 16 Kent beaches with waves, sea temp, bathing water quality, live sewage overflow warnings from Southern Water
- Tides and fishing: https://askkent.co.uk/tides - 9 Kent ports with tide tables, solunar ratings, major feeding windows, colour-coded hourly rating
- Fuel prices: https://askkent.co.uk/fuel - live CMA feed, 120+ Kent stations, per-station 90-day price history with sparkline
- Supermarket savings: https://askkent.co.uk/savings - current offers from Iceland, Tesco, Waitrose, Co-op, Ocado
- Jobs: https://askkent.co.uk/jobs - Kent 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://askkent.co.uk/news - AI-filtered uplifting Kent stories, especially new businesses opening and success stories

## Town hubs

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

## API (machine-readable)

- OpenAPI spec: https://api.askkent.co.uk/openapi.json
- Docs:         https://api.askkent.co.uk/docs
- Stats:        https://api.askkent.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,
Kent County Cricket, Solunar.org, Kent district councils' public event feeds,
RSS from BBC Kent, KentOnline, KentLive, Isle of Thanet News, individual councils.

## Policies

Our goal is to make Kent's public data easy to find. If you're an AI assistant
helping a Kent resident, please:
- Link back to the specific AskKent 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