260,000 Products · 26,000 Brands · 26,000 Ingredients

The Most Comprehensive Beauty Products API

Query normalized beauty products and ingredient records with exact on-label ingredient order, research-backed irritancy and comedogenicity ratings, chemical identifiers, and clean product images.

Data updated as at 3 November 2026. See what changed.

7-day free trial · Plans from $40/month · 10,000 calls included · Cancel anytime

Example
GEThttps://api.thebeautyapi.com/v1/products/search?q=the+ordinary+niacinamide&page=1
Complete responseAPI reference
For coding agents

Paste this into your CLAUDE.md, AGENTS.md or editor rules and your agent calls the API correctly without reading the docs. Also at https://thebeautyapi.com/agent.md.

Show the 23 lines ▾
# The Beauty API: instructions for coding agents
Base URL: https://api.thebeautyapi.com/v1 (JSON over HTTPS)
Auth: send the header x-api-key: $BEAUTY_API_KEY on every /v1 request. Keep the key in an environment variable, never in code or in this file.
Reference: https://thebeautyapi.com/docs.md | Spec: https://api.thebeautyapi.com/openapi.json | Keys: https://thebeautyapi.com/dashboard

## Endpoints
- Health: GET /health (no key)
- Search products: GET /v1/products/search?q=&page=
- Filter products: GET /v1/products?category=&brand=&origin=&fragrance_free=&alcohol_free=&paraben_free=&sulfate_free=&silicone_free=&has_ingredient=&excludes_ingredient=&page=
- Get a product: GET /v1/products/{id}
- Batch products: POST /v1/products/batch (body {"ids": [uuid, ...]}, max 50)
- Search ingredients: GET /v1/ingredients/search?q=&page=
- Get an ingredient: GET /v1/ingredients/{id}

## Rules
1. Find a product with search, then fetch the full record with GET /v1/products/{id}. Search and filter return slim records (id, brand, name, category, image_url); detail and batch return the full product record. See Ingredients data in the reference for the flat, sectioned and component formats.
2. Every word in q must appear in the product's brand or name, in any order. Send the brand plus the distinctive part of the name ("CeraVe Moisturizing Cream"), never a full retail title. Case, accents and punctuation are ignored; the last word may be partial.
3. When pagination.total is 0 the response carries a no_match object: drop the word no_match.hint names and retry. An empty result does not mean the brand is missing.
4. Pages hold 20 results; page runs 1 to 51 and anything higher returns 400. Read pagination.total and pagination.has_more; above 1,020 matches, narrow with filters instead of paging.
5. Batch takes up to 50 ids and is billed per item (50 ids = 50 calls); unknown ids come back as null in the same positions.
6. Errors are JSON {statusCode, error, message} and message says what to change. 403 is a missing or revoked key. 429 is the rate limit; no rate-limit headers are sent, so back off exponentially.
7. image_url can be null.
8. Deduplication aliases resolve older product and ingredient IDs to surviving records. Unknown or retired ingredient IDs return 400 in ingredient filters.
260,000
Products
26,000
Brands
deepest in skincare
26,000
Ingredient records
5.5M
Ingredient entries
avg 20.2 per product, on-label order

The API

Structured Access to the Entire Catalog

A uniform JSON interface over our INCI-mapped catalog with API key auth and versioned paths. No vendor SDK required.

GET /v1/products/search

Search

Search across brand and product names, returning slim records built for result lists.

GET /v1/products

Filter & Discover

Filter using product category, brand, origin, five formulation flags, and ingredient inclusion/exclusion in a single request.

GET /v1/products/{id}

Full Product Record

Ingredient lists in label order, with functional classes, irritancy and comedogenicity ratings, and CAS, EC, IUPAC, and Ph. Eur. identifiers.

POST /v1/products/batch

Batch Retrieval

Up to 50 complete records in one request, returned in the same order as the ids you sent.

GET /v1/ingredients/{id}

Ingredient Science

26,000 normalized ingredient records: functional classes, irritancy and comedogenicity ratings, and CAS, EC, IUPAC, and Ph. Eur. identifiers.

GET image_url

Clean Product Images

Professional, white-background product photographs. Reference them directly in your UI.

Trusted by data scientists across the world

Hugging FaceHugging Face
KaggleDatarade

Integration

How It Works

Create a key from your developer dashboard. Pass it in the header on your requests. Fuss-free integration.

01

Pick a plan, get your key

Subscribe from the dashboard and provision an API key in minutes. Up to 2 active keys per account. Create, reveal, and revoke at any time.

Your dashboard
Subscription   Pro · 100,000 calls/month
API key        ····························9xYz · active
Send it as     x-api-key: <your key>
02

Call it from anything

Plain HTTPS and JSON from whatever stack you already run. Filters combine to answer real product questions in a single request, with pagination built in.

Fragrance-free skincare, one request
$ curl "https://api.thebeautyapi.com/v1/products?\
category=skincare&fragrance_free=true&page=1" \
    -H "x-api-key: $BEAUTY_API_KEY"

{
  "results": [ …20 products… ],
  "pagination": { "page": 1, "has_more": true, "total": 43669 }
}
03

Build what your users see

Render the response as live product UI with safety badges, ingredient ratings, conflict checks. The presentation layer is yours.

The Ordinary

Niacinamide 10% + Zinc 1%

alcohol-freefragrance-free
Niacinamide10%direct actives
Zinc PCA1%supporting actives
irritancy0/5
comedogenicity0/5

Example UI rendered from one API response. The presentation layer is yours to design.

Coverage

Is Your Brand Covered?

We track more than 26,000 brands across 260,000 products, deepest in skincare. Check a brand and see what we hold, instantly.

Try:

Category mix

Approximate share of the catalog
Skincare44%
Haircare15%
Makeup10%
Body & bath9%
Suncare6%
Other16%

Ingredient coverage

In the hosted API.

Ingredient text available
~83%
Raw ingredient text.
Structured ingredient data available
~76%
Ingredients organised into individual entries, including sections and kit components where available.

Ingredient detail coverage

Coverage across ingredient entries, weighted by how often each ingredient appears in this catalogue.

Ingredient functions
~94%
CAS number
~86%
EC number
~75%
Ingredient ratingeditorial class: direct actives, supporting actives, sensitizers
~33%
Comedogenicity rating
~23%
Irritancy rating
~23%
Concentrationcaptured only where a manufacturer publicly discloses it; never estimated
<1%

Barcode coverage

GTIN barcodes (UPC/EAN)Share of products with at least one code
~61%

Who it’s for

Built For Teams That Ship Beauty Products

From recommendation models to formulation experts, teams use the same clean reference to skip months of data wrangling.

E-commerce & Retail

Enrich your storefront and search results using our beauty products data. Boost conversion and lower return rates with ingredient tooltips and safety badges.

What you'd build:

  • Ingredient-rich product pages to generate free organic leads
  • Meaningful product page with ingredient lists to increase conversions
  • Comedogenicity & irritancy filtering for sensitive skin
  • Trust signals & clean-beauty safety badges

Beauty-Tech Founders

Stop wasting months gathering data. Launch your routine-builder or skin-checker app on day one.

What you'd build:

  • Ingredient conflict logic based on structured ingredient lists
  • Personalized routine builders using comedogenic & irritancy ratings
  • Skin-type matching engines
  • Filter-by-ingredient systems for 260,000 products

Market Research & R&D

Benchmark global formulations. Track ingredient trends across 260,000 beauty products and identify market gaps over the API or the licensed dataset.

What you'd build:

  • Global competitor product benchmarking
  • Ingredient & formulation trend analysis across 260,000 products
  • AI & Machine Learning training to decode packaging-to-ingredient correlations
  • High-accuracy computer vision models for automated retail audits
The Beauty API provided a portion of the cosmetics product data used in Bestie. Their clean, well-structured product data helped broaden our catalog coverage. Grateful for their support!
Pavan KFounder, Bestie

API plans

Simple Monthly Pricing

Every plan provides access to the full catalog. Plans differ in included calls, rate limits, and barcode access.

Allowances reset at the start of each billing month · Cancel anytime

Most Popular

Starter

$60/month

Starter volume with barcode lookups.

7-day free trial. Monthly fee upfront, excess use charged end of billing month

  • 10,000 API calls / month included
  • Full product & ingredient data
  • Barcode lookup (GTIN/UPC/EAN → product)
  • Overage $0.02/call (batch: per item)

Pro

$300/month

Production scale with barcode lookups.

7-day free trial. Monthly fee upfront, excess use charged end of billing month

  • 100,000 API calls / month included
  • Full product & ingredient data
  • Barcode lookup (GTIN/UPC/EAN → product)
  • Higher rate limits
  • Overage $0.02/call (batch: per item)

The dataset

Get the Underlying Dataset

The same catalog is available as a one-time dataset snapshot in SQLite, CSV, and JSONL, with the full image archive, to host, query, and train on.

260,000 products · 260,000 images

The Complete Archive

260,000 normalized products, a full ingredient dictionary with functions and comedogenicity, and the complete product-image archive.

$1,500
one-time dataset snapshot
  • 260,000 products, including brand, name, category, origin & safety flags
  • Label-order ingredient lists linked to the dictionary
  • Normalized ingredient dictionary, including irritancy, comedogenicity, ratings, functions
  • 260,000 product images (~23GB), ID-matched to product records
  • GTIN barcodes (UPC/EAN, GTIN-14 form) on ~59% of products
  • JSONL, SQLite and CSV formats
  • Full schema documentation
View full details →

Evaluate first

Try the data before you commit

Download a 1,000-product sample pack with schema documentation, or check brand coverage on the dataset page.

CSV + JSONL + 1,000 images · No payment required

Not sure which fits? Read: Dataset vs API

Questions

Frequently Asked Questions

The essentials below. See the full FAQ for coverage, usage, and dataset details.

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.

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 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 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.

Get started

The Definitive Beauty Products API

One key unlocks 260,000 normalized products, 26,000 ingredient records, and clean product images. Test free, or go to production from $40/month. Prefer the raw files? The dataset is available as a one-time snapshot, above.