LouVue API

A public, read-only JSON API over Louisville, KY restaurant health-inspection data. No authentication required. CORS is open. Data is served through Cloudflare's edge network with short cache TTLs.

Base URL

https://louvue.com/api/v1

Discovery

/openapi.json — OpenAPI 3.1 spec
/.well-known/api-catalog — RFC 9727 link set
/.well-known/agent-skills/index.json — Agent Skills index
/.well-known/mcp/server-card.json — MCP Server Card

Endpoints

`GET /restaurants`

Search restaurants. Returns a paginated list with the most recent inspection grade.

Param	Type	Notes
`q`	string	Matches name, address, city, or ZIP.
`grade`	string	Comma-separated (e.g., `A,B`).
`city`	string	Exact city match.
`page`	integer	Default 1.
`pageSize`	integer	1–100, default 20.
`sort`	string	`name-asc` (default), `date-desc`, `grade-asc`, `score-desc`, etc.

curl "https://louvue.com/api/v1/restaurants?q=pizza&grade=A&pageSize=5"

`GET /restaurants/{id}`

Full detail for one restaurant, including complete inspection and violation history.

curl https://louvue.com/api/v1/restaurants/1234

`GET /stats`

City-wide inspection stats: total restaurants, total inspections, grade distribution.

curl https://louvue.com/api/v1/stats

`GET /health`

Status probe. Returns {"status":"ok"} when the service is up.

License & usage

Underlying inspection records come from Louisville Metro Public Health & Wellness and are treated as public-record open data. Please attribute louvue.com when redistributing, and be mindful that inspection records are snapshots in time — conditions at a restaurant may have changed.

Content negotiation

Any HTML page on the site will respond with Markdown when a client sends Accept: text/markdown. Useful for AI agents that prefer plain-text context.

curl -H "Accept: text/markdown" https://louvue.com/restaurant/1234