Bean Base API
To further our mission of driving coffee innovation, we created the Bean Base API — a powerful tool designed to make accessing our coffee datasets faster, easier, and highly flexible.
By generating an API key or querying the Bean Base endpoints, you acknowledge that you agree to the Terms of Use found at the bottom of the Documentation page.
Fuel Your Ideas
LoffeeLabs provides a powerful REST API for developers. Start building instantly with our Free Access tier featuring 2,000 daily queries and the latest 1,000 beans, or link your Patreon to unlock the Developer tier for expanded quotas.
Commercial & Research Access: Researchers and commercial companies with interest in the full historical payload or a one-time database snapshot can contact keith@loffeelabs.com directly to inquire.
Custom Queries
Enjoy complete control over your queries. Use powerful filtering to extract exactly the coffee data you need based on origin, variety, processing, flavor profiles, and much more.
Public Dictionaries
Access open, public endpoints to fetch continuously updated standardized lists of coffee roasters, origins, varieties, and processing methods.
Data Science Ready
Extract payloads instantly in structured JSON format, or append ?format=csv to instantly generate spreadsheets for offline modeling.
API Tips & Best Practices
Authentication Setup
Generate a unique API key from your Developer Dashboard. Pass this key in your request headers as an Authorization: Bearer token to securely authenticate your requests.
Advanced Query Structuring
Chain parameters to narrow down results. Want all washed coffees from Colombia? Just append ?origin=Colombia&process=Washed to your endpoint URL to tightly filter the returned JSON payload.
Live Spreadsheet Syncing
Append &format=csv to any query URL. You can paste this directly into Google Sheets using =IMPORTDATA("url") to automatically sync live bean data to your personal tracker.
Optimizing Payloads
Reduce bandwidth and speed up responses by requesting only the fields you need. Append ?fields=id,name,roaster to strip out large text fields like tasting notes or URLs.
Pagination Limits
Data payloads can get extremely large. Use ?limit=50&page=2 to effectively chunk your data requests, keeping your application lightning fast and respectful of the global API rate limits.