bag.coffee API
API by bag.coffee · rest
<img src="https://bag.coffee/icon-192.png" alt="bag.coffee" width="96" height="96" /> Read access to bag.coffee's catalog of specialty coffee: what's in stock at the roasters we follow, what each coffee is, what it costs, and what dropped this week. Read-only. Authentication: an API key, from https://bag.coffee/account once signed in, in every request: Authorization: Bearer bag_your_key_here (x-api-key: bag_… works too.) A missing or unknown key gets 401. Rate limits (a key's are the free plan's unless it's on another): 60 requests a minute per API key; 60 coffee list reads (GET /api/coffees, the MCP search_coffees tool) an hour per API key; 2,000 coffees from those list reads a day per API key; 300 requests a minute per IP address; 300 coffee list reads (GET /api/coffees, the MCP search_coffees tool) an hour per IP address; 120 pages after the first of sold-out history an hour per IP address; 50 requests per 10 seconds per IP address at the edge. Over…
Endpoint: https://api.bag.coffee/
Verification: observed. Source: crawl.
Capabilities (21)
- Get browse index
- Get the drop calendar
- Get the price index
- Get the process guide
- Get a week's drops
- List coffees
- Get coffee by slug
- Similar coffees from other roasters by slug
- Catalog changes since a cursor
- Get coffee by ID
- A coffee's price and availability history
- Similar coffees from other roasters
- Get counts
- Get filter options
- List producers
- Get producer by slug
- List roasters
- Get roaster by slug
- List your webhooks
- Register a webhook
- Delete a webhook