# Meduso

> UK health-system intelligence built entirely from official NHS open data:
> every community pharmacy, GP practice, NHS trust and dental contract, plus
> dispensing volumes, drug spend and market changes. Refreshed daily.

## Directories
- /search — full UK pharmacy register (12,935 records): search, filter by nation/type/region, map, CSV export
- /gp — GP surgery directory (13,843 practices across all four nations, with patient list sizes for England and CQC ratings for England)
- /hospitals — NHS trusts & foundation trusts (247, from the ODS register, with CQC provider ratings)
- /dental — NHS dental contracts in England (7,211): UDA delivery vs target, patients, contract values, CQC inspection status
- /concessions — Drug Tariff price concessions tracker: current month, rolled-over items, premium vs Category M tariff
- /prices — NHS Drug Tariff Part VIIIA basic prices: ~3,300 products with pack size, price and tariff category, parsed fresh from each monthly edition, plus per-product price history back to 2010 (click any row), YoY deltas, sparklines, 12-month/5-year mover tables, live supplier counts from dm+d, and a supply-risk watchlist scoring products for discontinuation, single-source supply and fresh price concessions (filter with ?risk=1)
- /access — pharmacy access map: distance-to-nearest-pharmacy per postcode district, pharmacy deserts, worst-served GP surgeries
- /flows — prescription flow estimates: modelled GP-to-pharmacy prescription shares, largest estimated catchments, at-risk catchments (CQC overlay), practice prescribing totals (NHS BSA EPD)
- /nominations — EPS nominations leaderboard: weekly active nominations per contractor, biggest gains/losses (NHS England Digital)
- /changes — register watch: every detected pharmacy opening, closure and relocation from the daily snapshot diff
- /cqc-changes — CQC rating change tracker: upgrades, downgrades and newly rated GP practices and trusts, diffed at every monthly CQC republication, plus recently inspected practices
- /survey — GP Patient Survey league: national scorecard with year-on-year deltas, highest-rated / most-improved / biggest-decline practice and PCN rankings per survey measure, response-weighted ICB breakdown (GPPS, Ipsos for NHS England)
- /guide — user guide and FAQ: plain-English explainers for every section (search, maps, profiles, survey league, analytics, exports, API) with FAQPage structured data
- /pcn — Primary Care Network directory: all England PCNs with member practices, list sizes, prescribing volumes and CQC rating mix (NHS ODS)
- /services — NHS services dashboard: Pharmacy First by pathway, NMS, vaccinations, BP, contraception, league tables, LPC benchmarking, services gap finder
- /alerts — MHRA drug safety alerts, refreshed daily from GOV.UK
- /companies — pharmacy chain/group breakdown (Boots, LloydsPharmacy, Well, ASDA, Tesco…)
- /compare — side-by-side pharmacy comparison (activity, services, percentile)
- /analytics — dashboards: volumes, chains, Pharmacy First, ICB league, movers, drug spend, openings/closures
- /pricing — Free vs Pro (£24/yr) vs Business (£48/yr)
- /towns — 1,400+ post-town location hubs, one page per town listing its pharmacies
- /district/U99971 — postcode district pages (e.g. /district/me2): every pharmacy in the district, chain mix, neighbouring districts
- /areas and /area/york — commissioning area pages (England ICBs, Scottish NHS boards, Welsh LHBs, NI LCGs): pharmacy counts, dispensing trend, chain share, deprivation profile, monthly brief
- /report — annual State of UK Pharmacy report generated from the live register
- /data/areas.json — per-area aggregates; /data/deprivation.json — per-pharmacy deprivation decile (IoD 2025 / WIMD 2025); /data/report.json — annual headline stats
- /feed.xml — Atom feed of register openings/closures and MHRA drug safety alerts

## Data files (JSON, same origin)
- /data/pharmacies.json — the unified register
- /data/gps.json — GP practices
- /data/trusts.json — NHS trusts
- /data/dental.json — dental contracts with 12-month UDA metrics
- /data/concessions.json — Drug Tariff price concessions by month with Category M tariff comparison
- /data/drug_prices.json — Drug Tariff Part VIIIA basic prices: ~3,300 products with pack size, price (pence), tariff category, BNF code, YoY delta and sparkline points; /data/drug_prices_history.json — full monthly price series per VMPP back to 2010 (OpenPrescribing tariff mirror); /data/dmd_packs.json — dm+d dictionary detail per pack: suppliers, legal category (POM/P/GSL), reimbursement status, discontinuation flags, SNOMED ids (NHSBSA dm+d via NHS TRUD, weekly)
- /data/access.json — distance-to-nearest-pharmacy for every postcode district + worst-served GP surgeries
- /data/nominations.json — weekly EPS nominations per contractor with week-on-week change, leaderboards and national history
- /data/dispensing.json — 13 months of per-contractor dispensing + 30 service measures (England)
- /data/pca.json — national drug spend: totals, BNF chapters, top drugs, ICB league
- /data/changes.json — weekly register openings/closures/moves
- /data/services.json — per-contractor NHS service activity (Pharmacy First pathways, NMS, vaccinations, BP, contraception), national and LPC aggregates
- /data/alerts.json — MHRA Drug Safety Updates and drug & device alerts
- /data/dispensing_docs.json — dispensing GP practices in England with GP counts
- /data/gp_listsize.json — registered patient list sizes per practice (NHS Digital)
- /data/cqc_gp.json — CQC latest ratings per England GP practice (overall + five domains + inspection date)
- /data/cqc_trusts.json — CQC ratings per NHS trust; /data/cqc_dental.json — CQC inspection status per dental contract (CQC does not rate dentists)
- /data/cqc_changes.json — CQC rating changes between snapshots + recently inspected practices
- /data/cqc_history.json — per-practice CQC rating history (rating, date) pairs, oldest first
- /data/pcns.json — Primary Care Network register: GP practice to PCN mapping plus per-PCN member list, list size, prescribing items and CQC rating mix (NHS ODS)
- /data/gp_survey.json — GP Patient Survey 2026 official summary measures per practice and PCN (overall experience, phone/website/NHS App access, reception, confidence, needs met, care, next steps, pharmacy experience) with England benchmarks (Ipsos for NHS England)
- /data/gp_prescribing.json — practice-level prescribing totals, latest month (NHS BSA EPD with SNOMED)
- /data/gp_prescribing_history.json — 13 months of practice-level prescribing (items + NIC) for trends and movers
- /data/flows.json — prescription flow model: totals + largest estimated pharmacy catchments
- /data/flows_gp.json — per-surgery estimated prescription shares to its 5 nearest pharmacies
- /data/flows_pharmacy.json — per-pharmacy estimated catchment volume, top feeder surgeries, and at-risk catchment (volume from CQC Requires improvement / Inadequate feeders)

## API
- /api — docs. Base path /api/v1, demo key ps_demo_2026 (header x-api-key, 100 req/min).
- Key endpoints: /api/v1/pharmacies, /api/v1/pharmacies/{nation}/{code}, /api/v1/gps,
  /api/v1/trusts, /api/v1/dental, /api/v1/pca, /api/v1/concessions, /api/v1/access, /api/v1/nominations, /nominations/history,
  /api/v1/changes, /api/v1/analytics/icb, /api/v1/flows, /api/v1/flows/gp/{code}, /api/v1/flows/pharmacy/{code}, /api/v1/flows/prescribing[/{code}[/history]]

## Site interactions (browser-local, no account needed)
- Search box drop-down: recent searches + recently viewed pharmacy profiles
- Open-now button shows a live count of results open at this moment
- Map: crosshair geolocate button (top-right), camera position remembered between visits,
  cluster popups with per-town/chain breakdowns, area circle with CSV export of contents
- Profiles: private notes per pharmacy (amber dot in result rows when a note exists),
  favourites, comparison tray, print/PDF report
- Helper widget (bottom-left): on-device Q&A about every feature; answers with real counts
- Structured data: Organization+WebSite+SearchAction, Dataset, FAQPage, BreadcrumbList on
  profile/town/report pages, Report schema on /report, Atom feed at /feed.xml

## Licensing
Source data is Crown copyright, Open Government Licence v3.0 — attribution required.
Directory data is for information purposes; always confirm details with the pharmacy.