datawebotOnyx Coffee Lab coffee data: lots, roast and trade
A field guide to Onyx coffee origin and lot, roast and brew profile, retail options, subscriptions, and Onyx-published trade disclosures.
Updated · datawebot team
Extract Onyx Coffee Lab with its endpoints: predictive search and product details and catalogue. Extraction Jobs are open to every account with 200 free trial credits; connect your agent through MCP to run them.
Which Onyx catalog this guide covers
This guide describes coffee listings on onyxcoffeelab.com. Onyx’s site also links cafés, wholesale services, other brands, and a separate European storefront; those destinations should not be merged into one coffee catalog.
Scroll to compare →
| Entity | What belongs in its record | Why it stays separate |
|---|---|---|
| Packaged coffee | A named coffee product and its product-page URL. | This is the subject of the source guide. |
| Coffee lot or blend | The origin, producer, variety, process, and harvest details stated for a coffee. | A stable retail name may refer to a changing lot or blend composition. |
| Retail package | A selected bag size, grind option, retail price, and observed availability. | These are customer-facing options and can change independently of the coffee's trade record. |
| Cafés and wholesale | Location, café menu, or wholesale relationship when explicitly documented. | Onyx lists these as separate services and destinations. |
| Related brands and storefronts | The named brand or regional storefront shown by Onyx. | Doyenne, The Preserve, Well Met, and the EU storefront are distinct destinations. |
Read tasting, brew, and roast fields as different measurements
An Onyx product page can put descriptive and measured fields side by side. Keep their labels and units intact: a flavor description is not a lab measurement, and a roast category is not the same field as an Agtron reading.
Scroll to compare →
| Field group | What the page may report | How to preserve it |
|---|---|---|
| Sensory profile | Flavor descriptors and a written coffee abstract. | Store as source-attributed descriptive text, not a standardized score. |
| Brewing context | Preferred extraction methods and related brew guidance. | Keep method and recipe context attached to the product page. |
| Caffeine | An amount that may include a serving basis. | Record the amount, unit, and stated serving basis together. |
| Roast | A roast-level label and an Agtron reading. | Keep the category and measurement separate; retain the scale or basis when stated. |
| Production and drying | A named production roaster and drying method. | Treat these as coffee-specific fields, not a universal product template. |
| Batch profile | A dated roast record may include batch, technician, temperatures, duration, and machine. | Attach these to the observed roast batch, not permanently to the product. |
Origin and process can change beneath a product name
Onyx pages describe coffees at different levels: a blend may combine origins, while a single-origin offering may refer to a producer, cooperative, washing station, or a particular harvest lot. Product names alone are not enough to infer that provenance stays fixed.
Scroll to compare →
| Provenance field | Useful distinction | Record design |
|---|---|---|
| Origin | Country or region can describe a blend or a lot. | Allow more than one origin and keep the scope stated by the page. |
| Producer and site | A farm, producer, cooperative, or washing station is not interchangeable with a country. | Preserve the source's named entity and relationship. |
| Variety and harvest | A coffee may state one variety, mixed varieties, or a seasonal harvest. | Use null when absent; do not fill from a prior lot. |
| Process and drying | Processing and drying can appear as separate descriptions. | Keep each label as stated instead of combining them into one process field. |
| Lot and inventory state | Onyx explains that specialty lot terms are not uniform; a blend can also be described as evergreen while its components vary. | Link the lot to the product and observation date; do not treat 'microlot' as a quality grade. |
Onyx-published trade disclosures are not retail prices
Onyx says its product pages publish trade details such as what it paid, who it bought from, and a coffee score. Its Geometry page separates those disclosures from what customers pay for a retail package. Attribute the figures to Onyx and preserve the page's unit, currency, purchase basis, and date.
Scroll to compare →
| Onyx field label | Meaning described by Onyx | Interpretation boundary |
|---|---|---|
| Green Cost | A reported cost for green coffee, with payment terms relevant to what the amount represents. | Do not automatically describe it as the amount paid directly to the producer. |
| Pay Structure | Onyx's own traceability description for how payment relationships are documented. | Onyx says its grades describe available information, not an ethical grade. |
| Market Price | A commodity-market reference at the time of purchase. | Keep separate from Onyx's negotiated green-coffee cost and current retail price. |
| Transportation | A reported import or logistics cost for moving coffee toward the roastery. | Preserve the exact label and included cost basis. |
| Cup Score | Onyx's sensory score and quality reference for a coffee. | Attribute the score; do not treat it as an independent certification or a complete judgment of drinkability. |
| Lot Size and Production Cost | Additional context Onyx may publish about lot scale and its own production costs. | These describe different stages and are not the package's retail price. |
Model retail options as time-bound offers
Bag size, grind, price, and stock state belong to the selected retail option at an observation time. They do not define the green-coffee transaction or prove that an option is available across Onyx's range. Onyx Support describes grinding for selected core coffees; that boundary can change, so confirm the current product page.
Scroll to compare →
| Retail field | Store separately from | Evidence to retain |
|---|---|---|
| Package size and selected grind | Coffee lot size or green-coffee trade disclosures. | Exact option label and product URL. |
| Retail price and currency | Green Cost, Market Price, transportation, and production cost. | Displayed amount, currency, market/storefront, and observed_at. |
| Availability or archive state | A missing or unavailable value. | The exact displayed state and observation time; do not infer stock quantity. |
| Product identity | The selected retail variant or offer. | Stable product URL plus selected option, if present. |
| Ground-coffee option | A capability offered for every product. | Capture only when the selected product currently presents that option. |
A subscription plan is not the shipment coffee
Onyx presents subscription choices separately from the coffee selected for a particular shipment. Its Roaster’s Choice page describes a changing single-origin selection, while other subscription options may let a customer choose a coffee. Store a plan and each shipment as related but separate records.
Scroll to compare →
| Record | Fields that belong here | Do not merge with |
|---|---|---|
| Subscription plan | Plan identifier, selected option, frequency if displayed, and current terms. | The identity or provenance of a future coffee. |
| Shipment | Shipment reference and the coffee associated with that delivery, when documented. | The plan's stable name or an earlier shipment's coffee. |
| Selected coffee | Coffee product and lot details linked to one shipment. | A permanent promise that every future shipment contains the same origin or lot. |
| Customer account and order | Personal account, address, payment, and order history. | This public catalog guide; do not collect or reproduce customer data. |
Build an evidence record without guessing missing values
A useful specialty-coffee dataset keeps the source statement with each value. This is a field model for research and catalog analysis, not a sample Onyx record or a claim that data has been retrieved.
Scroll to compare →
| Record layer | Candidate fields | Evidence rule |
|---|---|---|
| Product | Name, canonical product URL, explicitly stated coffee type, observed status. | Do not infer a single-origin or blend classification when the page does not state it. |
| Lot and provenance | Producer/site, origin, variety, harvest, process, drying, elevation, lot identity. | Allow changing or multiple values; preserve the named source and observation date. |
| Profile and roast | Sensory text, extraction, caffeine with serving basis, roast label, Agtron scale, dated batch fields. | Keep descriptions, measurements, and dated batch facts distinct. |
| Trade disclosure | Onyx label, amount, currency/unit, Farm Gate/FOB/EXW or other stated basis, date. | Attribute to Onyx and keep each cost category separate. |
| Retail offer | Package, grind, displayed retail price/currency, availability, observed_at. | Treat as a time-bound customer offer, separate from producer-side economics. |
| Subscription | Plan, option, frequency, shipment, and linked coffee when documented. | Do not substitute a current shipment coffee for future deliveries. |
Related roaster guides
Content reviewed 2026-10-23.