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 Standard and Developer tiers for expanded quotas, full historical datasets, and rich metadata.
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 & Use Cases
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.
Build a Deal Hunter
Combine the ?sort=price-asc parameter with specific roaster queries to programmatically track price changes and find the most budget-friendly specialty beans on the market.
Flavor Recommendation Engines
Utilize the ?tasting-tag= parameters to build discovery tools. Let users input "Berries" and "Floral", and instantly return a list of matching single-origin Ethiopian coffees.
Roaster Drop Tracker
Filter the endpoint by your favorite roasters and use ?sort=date-desc to surface their newest additions. You can build automated scripts to get notified the exact moment they drop a new coffee.
Pagination Best Practices
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.
Build Your Own Local Archive
The most efficient way to utilize the API is to regularly sync our data to your own database. Even on the Free tier, by routinely querying and saving the latest drops to your own system, you can build a complete, unrestricted historical archive over time to power your applications!