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.
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. |
Review Onyx's terms before any reuse
Onyx's current Terms of Service prohibit spidering, crawling, and scraping in Section 12(i). Section 2 separately says that copying or exploiting the service or its content requires express written permission. The terms can change; consult the current source and seek permission where needed. This page does not establish access rights, an API, a public feed, or crawler permission.
Content reviewed 2026-10-05.