mocop
Browse · Docs · Guide · Analyze

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
About · Contact · Privacy