🥗 Open Food Facts Nutrition Data Scraper

Search the Open Food Facts database — the world's largest open food product database with 3M+ products — for detailed nutritional information, health scores, allergens, ingredients, and more.

No API key required. All data is freely available under the Open Database License (ODbL).

✨ Features

• Text Search — Find products by name, brand, or keyword
• Barcode Lookup — Get detailed info for specific products using EAN-13 / UPC-A barcodes
• Category Browse — Explore products by food category (e.g., "breakfast-cereals", "beverages")
• Country Filter — Filter results by country of sale
• Rich Nutritional Data — Energy, fat, sugars, proteins, salt, fiber per 100g
• Health Scores — Nutri-Score (A–E), Eco-Score (A–E), NOVA processing level (1–4)
• Allergen Detection — Full allergen tag information
• Ingredients & Labels — Ingredient lists, organic/vegan/fair-trade labels

🔍 How It Works

1. Choose a search type: text search, barcode lookup, or category browse
2. Enter your search query, barcode numbers, or category name
3. Optionally filter by country and sort order
4. The Actor queries the Open Food Facts API and returns flattened, clean product data

📦 Input Parameters

Parameter	Type	Description	Default
search_type	Select	text_search, barcode_lookup, or category_browse	text_search
query	String	Search keywords (for text search)	chocolate
barcodes	String	Comma-separated barcodes (for barcode lookup)	3017620422003,5449000000996
category	String	Category tag (for category browse)	breakfast-cereals
country	String	Country code (us, fr, de, etc.) or world	world
sort_by	Select	Sort order: popularity, name, date, nutriscore, ecoscore	unique_scans_n
max_results	Integer	Maximum products to return (1–10,000)	100
page_size	Integer	Products per API page (1–100)	50

📊 Sample Output

{
    "barcode": "3017620422003",
    "product_name": "Nutella",
    "brands": "Ferrero",
    "quantity": "400 g",
    "categories": "Spreads, Sweet spreads, Hazelnut spreads, Chocolate spreads",
    "labels": "",
    "countries": "france, germany, united-kingdom, united-states",
    "stores": "Carrefour, Auchan, Lidl",
    "nutriscore_grade": "e",
    "ecoscore_grade": "d",
    "nova_group": 4,
    "energy_kcal_100g": 539,
    "fat_100g": 30.9,
    "saturated_fat_100g": 10.6,
    "carbohydrates_100g": 57.5,
    "sugars_100g": 56.3,
    "fiber_100g": 0,
    "proteins_100g": 6.3,
    "salt_100g": 0.107,
    "sodium_100g": 0.0428,
    "allergens": "milk, soybeans",
    "ingredients_text": "Sugar, palm oil, hazelnuts 13%, skimmed milk powder...",
    "image_url": "https://images.openfoodfacts.org/images/products/301/762/042/2003/front_en.572.400.jpg",
    "fetched_at": "2026-03-22T00:30:00.000000"
}

📝 Score Reference

Score	Description	Scale
Nutri-Score	Overall nutritional quality	A (best) → E (worst)
Eco-Score	Environmental impact	A (best) → E (worst)
NOVA Group	Food processing level	1 (unprocessed) → 4 (ultra-processed)

🌍 Common Categories

Category Tag	Description
breakfast-cereals	Breakfast cereals and granola
chocolates	Chocolate bars and confections
beverages	Drinks (soft drinks, juices, water)
dairy	Milk, cheese, yogurt
snacks	Chips, crackers, nuts
breads	Bread and bakery products
frozen-foods	Frozen meals and ingredients
baby-foods	Baby food and formula
plant-based-foods	Vegan and vegetarian products
organic-foods	Certified organic products

⚠️ Notes

• Rate limiting: The Actor includes built-in delays (0.4–0.5s between requests) to respect Open Food Facts' fair usage policy
• Data completeness: Not all products have complete nutritional data — some fields may be empty
• Community data: Open Food Facts is crowd-sourced; data accuracy varies by product
• Memory: Default 256 MB is sufficient for most queries