Open Beauty Facts Scraper

Scrape Open Beauty Facts — the world's largest open database of cosmetics and personal care products, contributed by volunteers worldwide. Search by product name, browse by category (shampoos, moisturizers, lipsticks, etc.), or look up products by barcode. Extracts ingredients, brands, categories, countries, and product images.

What you can do

• Search by keyword — find beauty products by name or brand (e.g. "shampoo", "face cream")
• Browse by category — paginate through specific categories like shampoos, mascaras, foundations, sunscreens, and 16+ more
• Look up by barcode — retrieve exact product details using EAN/UPC barcode numbers

Output fields

Field	Description
barcode	EAN/UPC product barcode
productName	Product name
brand	Brand name
quantity	Product quantity/size (e.g. "250 ml")
categories	Raw category string from Open Beauty Facts
categoryTags	Cleaned list of category tags
ingredients	Full ingredients text list
packaging	Packaging type description
origins	Declared origin of the product/ingredients, when reported
labels	Certifications/labels (e.g. "Vegan", "Organic")
labelTags	Cleaned list of label tags
countries	Countries where the product is sold
countryTags	Cleaned list of country tags
language	Primary language of the product label
imageUrl	Front product image URL
productUrl	Link to the product on openbeautyfacts.org
ecoscore	Eco-score grade (a–e) if available
allergens	Declared allergens/irritants (e.g. "sesame seeds"), when reported
veganStatus	vegan / non-vegan / maybe-vegan / unknown, from Open Beauty Facts' ingredient analysis
vegetarianStatus	vegetarian / non-vegetarian / maybe-vegetarian / unknown
palmOilStatus	palm-oil-free / palm-oil / may-contain-palm-oil / unknown
completeness	Database completeness score (0–1)
createdAt	Date first added to Open Beauty Facts
lastModifiedAt	Date last updated
scansCount	Number of times the barcode was scanned in the mobile apps (popularity)
uniqueScansCount	Number of unique users who scanned the barcode
sourceUrl	URL of the API request
scrapedAt	UTC timestamp when scraped
recordType	Always "beauty_product"

Input options

Mode: search (default)

Search for beauty products by keyword.

{
  "mode": "search",
  "searchQuery": "shampoo",
  "brand": "dove",
  "maxItems": 50
}

Mode: byCategory

Browse all products in a specific category.

{
  "mode": "byCategory",
  "category": "moisturizers",
  "country": "france",
  "maxItems": 100
}

Mode: byBarcode

Look up specific products by EAN/UPC barcode.

{
  "mode": "byBarcode",
  "barcodes": ["3600551020419", "8718114642871"]
}

Filters

Filter	Type	Description
brand	string	Filter by brand (case-insensitive partial match)
country	string	Filter by country of sale (e.g. "france", "australia")
hasIngredients	boolean	Only include products with ingredients listed
hasImage	boolean	Only include products with a product image
maxItems	integer	Maximum number of records (1–1000)

Available categories

shampoos, conditioners, foundations, mascaras, lipsticks, moisturizers, sunscreens, perfumes, nail-polishes, eye-shadows, blushes, concealers, serums, toners, cleansers, body-lotions, deodorants, hair-dyes, face-masks, bb-creams

Example output

{
  "barcode": "8718114642871",
  "productName": "Cocoa Butter Lip Therapy",
  "brand": "Vaseline",
  "quantity": "20g",
  "categories": "non-food-products, open-beauty-facts",
  "categoryTags": ["non food products", "open beauty facts"],
  "ingredients": "PETROLATUM, THEOBROMA CACAO SEED BUTTER, AROMA, BENZYL ALCOHOL, BENZYL BENZOATE, BENZYL CINNAMATE, LIMONENE.",
  "packaging": "steel-tin,",
  "countries": "France, Morocco, United Kingdom",
  "countryTags": ["france", "morocco", "united kingdom"],
  "language": "en",
  "imageUrl": "https://images.openbeautyfacts.org/images/products/871/811/464/2871/front_en.15.400.jpg",
  "productUrl": "https://world.openbeautyfacts.org/product/8718114642871",
  "completeness": 0.8,
  "palmOilStatus": "unknown",
  "scansCount": 27,
  "uniqueScansCount": 24,
  "createdAt": "2021-01-18T12:28:11+00:00",
  "lastModifiedAt": "2026-02-16T19:36:52+00:00",
  "sourceUrl": "https://world.openbeautyfacts.org/api/v2/product/8718114642871.json",
  "scrapedAt": "2026-07-02T07:30:43+00:00",
  "recordType": "beauty_product"
}

Use cases

• Cosmetics research — analyze ingredient lists across product categories for regulatory compliance or competitor intelligence
• Beauty brand monitoring — track which products a brand offers across countries
• Ingredient analysis — find all products containing specific ingredients (search by ingredient name)
• E-commerce enrichment — enrich product listings with ingredients, categories, and images
• Sustainability research — filter by eco-score to find eco-friendly products

FAQ

Is this free to use? Yes. Open Beauty Facts is an open, volunteer-driven database. This actor uses their public API with no authentication required.

How many products are in the database? Open Beauty Facts contains hundreds of thousands of cosmetics and personal care products contributed by volunteers worldwide.

Is the data reliable? Open Beauty Facts data is crowd-sourced. Product completeness varies — the completeness field (0–1) indicates how complete each record is.

Can I search for products by ingredient? Yes — use mode=search with searchQuery set to the ingredient name (e.g. "retinol", "hyaluronic acid").

Are prices included? No. Open Beauty Facts is a product database, not a shopping platform. Pricing data is not available.

Which countries are covered? Open Beauty Facts has global coverage with particularly strong data for France, the United States, the United Kingdom, and Germany.

Data source: Open Beauty Facts — open database of beauty and cosmetics products, available under the Open Database License (ODbL).