The hosted API
How do I get access to the API?
Sign up on the dashboard, choose a Starter or Pro plan (with or without Barcode) for a seven-day free trial with 100 requests total across your API keys. Create a key and authenticate requests with the x-api-key header. Upon making 100 requests, your API access pauses until you convert to a paid plan. Reaching the limit does not charge you early. Your selected plan starts automatically after seven days unless you cancel it. The fixed monthly fee is paid upfront and overage is billed at the end of your billing month. Paid plans start at $40/month. See the docs for endpoints and examples.
What can I query over the API?
Everything in the catalog. Search products by brand and name; filter by category, country of origin, formulation flags and ingredient composition; fetch product records with ingredients in label order; retrieve up to 50 products in one batch request; and look up any of the 26,000 normalized ingredient records with their safety ratings and chemical identifiers. Available product images have hosted URLs you can use directly in your UI. Barcode-enabled plans additionally resolve a scanned UPC or EAN to its product (see below).
How do API limits and overage work?
The trial includes 100 requests total over seven days, shared across all your keys; a batch counts as one trial request. Authenticated requests reaching the API consume this allowance, including requests that return errors. The trial never incurs overage. After 100 requests the API returns 429; use Convert to paid on the dashboard to start your paid month immediately, or wait for automatic conversion at the trial deadline. Paid plans include 10,000 calls on Starter and 100,000 on Pro. The monthly fee is collected at the start of each billing month. Calls beyond your allowance cost $0.02 each and are billed at the end of that month. Paid batch requests count per item. The allowance resets with your billing month; an abuse ceiling and rate limits still apply. Usage reported after an invoice is finalized is not charged or carried forward. Trial calls are excluded from paid usage.
What do the Barcode plans add?
The Barcode variants of each plan (Starter and Pro) unlock the barcode lookup endpoint: send a scanned or catalog UPC-A, EAN-13 or GTIN-8/14 and get back the full product record. Unit codes, multipack codes and sibling-variant codes (a different shade, scent or size of the same line) all resolve. About 61% of products currently carry at least one code, and coverage grows with each refresh.
Can I change or cancel my plan?
Yes, from the dashboard. During a trial you can switch between Starter and Pro plans without resetting the seven-day deadline or the 100-request allowance. Convert to paid explicitly ends the trial and collects the first monthly fee. For upfront subscriptions, paid upgrades start a new billing month immediately after successful payment, credit unused prepaid time and settle accrued reported overage. Downgrades take effect at renewal. Cancel under Manage billing before the trial ends to avoid the first monthly fee. Paid cancellations keep access through the paid period, with final overage billed at the end of your billing month. API keys and the base URL stay the same when changing plans. You can hold up to 2 active keys per account.
The dataset license
What is included in the dataset?
One snapshot, the whole catalog: 260,000 products with brand, product category, country of origin and formulation flags (fragrance, drying alcohol, parabens, sulfates, silicones); label-order ingredient lists, linked through a product-to-ingredient link table to a normalized ingredient dictionary (functions, irritancy, comedogenicity, safety rating, chemical identifiers); GTIN barcodes where known; and the full product-image archive (~23GB, 260,000 images). Delivered as CSV, JSONL and SQLite with a complete data dictionary and schema guide.
What formats do you deliver?
Three views of the same data so you can pick whichever fits your stack: nested JSONL (one product per line with its ingredients embedded), relational CSVs (products, ingredients, relationships, groups and aliases as separate files) and a standalone SQLite database with foreign keys and indexes. Any of them drops straight into Postgres, MongoDB, DuckDB or a Pandas notebook. The data dictionary documents every column.
How are the images mapped to the products?
For products with an image, image_name (for example 1042.jpeg) gives its filename in the archive, so joining metadata to images is a plain string match. The images are ID-matched for your own use, hosted on your own infrastructure.
How do I keep a purchased dataset current?
A dataset license is a snapshot at the time of purchase (current version: 2026.11). When you want to catch up with newer data, we produce a differential refresh containing the full updated dataset, priced at $0.0025 per updated data point, so you pay for the delta rather than a second full license. If you would rather never think about refreshes, the hosted API always serves the current catalog.
Coverage & quality
Is my brand covered?
We track more than 26,000 brands across 260,000 products. The fastest way to check is the live coverage tool on the dataset page, which confirms specific brands and product counts instantly. If a brand you need is missing, tell us: brand requests feed directly into the next refresh.
What product categories are covered?
The catalog is skincare-led but spans the whole shelf. Approximate mix: • Skincare: 44% • Haircare: 15% • Makeup: 10% • Body & bath: 9% • Suncare: 6% • Other: 16%
How complete are the fields?
We publish fill rates up front so you never discover a gap mid-evaluation. Ingredient fields are weighted by how often each ingredient appears across the dataset; product-level fields are a share of products: • Ingredient text available: ~87% • Structured ingredient data available: ~81% • Ingredient functions: ~94% • CAS number: ~86% • EC number: ~75% • Ingredient rating: ~33% (editorial class: direct actives, supporting actives, sensitizers) • Comedogenicity rating: ~23% • Irritancy rating: ~23% • Concentration: <1% (captured only where a manufacturer publicly discloses it; never estimated) • GTIN barcodes (UPC/EAN): ~59% (share of products with at least one code) Concentration is sparse by design: we record it only where a manufacturer publicly discloses it and never estimate or extrapolate. Ratings concentrate on the ingredients that matter (frequently used actives and known sensitizers) rather than on every trace excipient. The free sample lets you inspect the available fields and formats.
How accurate is the ingredient analysis?
We aggregate publicly available product listings from multiple sources and normalize ingredient names against a shared dictionary. Ingredient information includes functions, ratings and chemical identifiers where available. Coverage varies by field; the percentages above show what is available. Product and ingredient aliases preserve links to records consolidated through deduplication.
How often is the data updated?
Continuous background audits feed refreshes of the master dataset once every two months, most recently on 3 November 2026.
Licensing
What can I do with the dataset?
A dataset purchase is a snapshot of the catalog you can use indefinitely. Load it into your own systems, build products and analyses on it, and show the product information to your end users, with product images matched to their records for your own use. You may not redistribute, resell or publicly host the raw files (CSV, JSONL, SQLite, images) for third parties to download. Future versions are sold separately as differential refreshes.
Do the same rules apply to data fetched over the API?
Yes. Data you retrieve over the API may be displayed to your users and stored in your own application database, and you can keep using what you've stored after your subscription ends. It may not be used to rebuild and redistribute the catalog, and it may not be resold or exposed as a competing data feed. If you need a complete offline copy of the whole catalog, the dataset is the product designed for that.
Buying & support
Should I use the API or buy the dataset?
Choose the API when you want live access to our latest data without hosting anything and scale as usage grows. Choose the dataset license when you need the whole catalog offline, want to run heavy analytics or model training over every record, or prefer a one-time payment with no ongoing dependency. Still weighing it up? Read the full comparison.
Can I try before buying?
Yes. The free 1,000-product dataset sample includes product JSONL, five CSV tables covering the products and their ingredients, a schema guide and matching images. New API customers choosing Starter or Pro (including Barcode variants) receive a seven-day trial with 100 requests total. Cancel before the deadline to avoid automatic paid conversion.
What is your refund policy?
Dataset snapshot sales are final once the download link is issued; use the free sample to check suitability first. API monthly fees are paid upfront and are not refunded for cancellation partway through a month. Access continues through the paid period, and any final overage is billed at the end of your billing month. Paid upgrades credit unused prepaid time when starting the new plan. Cancel a trial before its deadline to avoid the first monthly fee.
How do I get help?
Email [email protected]. We answer questions about coverage for specific brands or markets, schema and integration, plan changes and billing.
Contact
Still need a hand?
For faster answers: mention your use case, whether you’re after the dataset or the API, and your target stack.
What we can help with
Plans & Dataset
API plans, invoices and billing, what the dataset snapshot includes, refresh pricing, or applicable terms.
Data & Schema
API endpoints and integration, field coverage, formats, INCI normalization, rating methodology, or whether the data fits your use case.
Existing Customers
API keys and plan changes, download issues, schema docs, version updates, or anything else after you subscribe or purchase.
Hosted API
Integrate over the API
Query the full catalog over HTTPS. Test free, with paid plans from $40/month and 10,000 calls included, and your API key provisioned from the dashboard in minutes.
Need a one-time snapshot instead? License the full dataset →