Developer access
A JSON API for coffeeDB.
Every roaster, coffee lot, variety, producer, farm, and certification in coffeeDB is available via a public, read-only REST API. Use it to power barista apps, menus, analytics, or anything else specialty coffee can imagine.
Base URL
https://api.coffeedb.proAll endpoints return JSON. CORS is open for GET requests. Authentication is via an API key passed in the X-API-Key header (or as a Bearer token).
Endpoints
| Method | Path | Description |
|---|---|---|
| GET | /health | Service heartbeat. No auth required. |
| GET | /v1/roasters | Paginated list of roasters. Filter by country, macro region, top-100 status, price. |
| GET | /v1/roasters/:slug | Full roaster profile with certifications. |
| GET | /v1/coffee-lots | Paginated list of coffee lots. Filter by roaster, country, availability. |
| GET | /v1/countries | All seeded countries with macro region. |
| GET | /v1/varieties | Cultivar reference list. |
| GET | /v1/processing-methods | Processing-method reference list. |
| GET | /v1/certifications | All certifications referenced by roasters. |
Example request
curl "https://api.coffeedb.pro/v1/roasters?country=de&limit=5" \
-H "X-API-Key: cdb_live_xxxxxxxxxxxx"Rate limits & pricing
Each API key has a sliding 1-hour quota (default 1 000 calls/hour). The public tier is free for non-commercial use. Higher quotas and commercial use are available on request — reach out below.
Request API access
Tell us a little about your project and we’ll reply with an API key and a quota that fits.