# Open Food Facts Scraper (`parseforge/openfoodfacts-product-scraper`) Actor Scrape 3M+ grocery products from Open Food Facts with barcodes, ingredients, allergens, nutrition facts, Nutri-Score, NOVA group, eco-score and brand data. Filter by category, country, or label. Perfect for food research, retail intelligence, and diet apps. - **URL**: https://apify.com/parseforge/openfoodfacts-product-scraper.md - **Developed by:** [ParseForge](https://apify.com/parseforge) (community) - **Categories:** E-commerce, Lead generation, Other - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ![ParseForge Banner](https://github.com/ParseForge/apify-assets/blob/ad35ccc13ddd068b9d6cba33f323962e39aed5b2/banner.jpg?raw=true) ## ๐Ÿฅซ Open Food Facts Scraper > ๐Ÿš€ **Export 3M+ grocery products with ingredients, NutriScore, allergens, and nutrition in seconds.** > ๐Ÿ•’ **Last updated:** 2026-05-26 ยท **๐Ÿ“Š 20 fields** per record ยท **3M+ products ยท 200+ countries ยท 20+ structured fields** This Apify Actor extracts structured data from Open Food Facts, returning clean JSON / CSV / Excel / XML datasets ready for analytics, integrations, or research workflows. Built by ParseForge for reliability and freshness. | ๐ŸŽฏ Target Audience | ๐Ÿ’ก Primary Use Cases | |---|---| | Data analysts, engineers, researchers | Analytics pipelines, BI dashboards, datasets | | SaaS, fintech, marketing, ops teams | Lead gen, enrichment, monitoring | | Hobbyists, journalists, indie devs | Side projects, content, exploration | ### ๐Ÿ“‹ What the Open Food Facts Scraper does - Queries the public Open Food Facts API / feed and structures the response - Returns one record per item with 20 normalized fields - Supports filters configurable from the input schema - Outputs to CSV, Excel, JSON, XML via Apify dataset - Auto-limits to 10 items on the free plan; up to 1,000,000 on paid > ๐Ÿ’ก **Why it matters:** clean, ready-to-query data without manual scraping, parsing, or babysitting an API client. ### ๐ŸŽฌ Full Demo (_๐Ÿšง Coming soon_) ### โš™๏ธ Input
FieldTypeRequiredDescription
maxItemsintegerNoMax items to return (free: 10, paid: 1,000,000)
```json { "maxItems": 50 } ```` ```json { "maxItems": 1000 } ``` > โš ๏ธ **Good to Know:** the free plan caps results at 10 items per run. Upgrade to a paid plan to unlock the full dataset. ### ๐Ÿ“Š Output | Field | Type | Description | |---|---|---| | ๐Ÿ”น code | string | Open Food Facts code field | | ๐Ÿ”น product\_name | string | Open Food Facts product\_name field | | ๐Ÿ”น brands | string | Open Food Facts brands field | | ๐Ÿ”น nutriscore\_grade | string | Open Food Facts nutriscore\_grade field | | ๐Ÿ”น categories | string | Open Food Facts categories field | | ๐Ÿ•’ scrapedAt | string | ISO timestamp of when the record was collected | | โŒ error | string | null | Error message if extraction failed | ```json { "code": "...", "product_name": "...", "scrapedAt": "2026-05-26T00:00:00.000Z", "error": null } ``` ### โœจ Why choose this Actor | Differentiator | Benefit | |---|---| | ๐ŸŸข Real-time public data | Always fresh, never cached | | ๐ŸŸข Structured output | Ready for BI, Excel, SQL imports | | ๐ŸŸข Pay-per-result pricing | Pay only for actual data collected | | ๐ŸŸข Apify-hosted runs | No servers, no maintenance | | ๐ŸŸข Free tier preview | Test with 10 items before scaling | ### ๐Ÿ“ˆ How it compares to alternatives | Method | Setup time | Reliability | Maintenance | Cost | |---|---|---|---|---| | Manual scripting | Hours | Medium | High | Dev time | | Generic web scrapers | Hours | Low | High | Variable | | **This Actor** | **30 seconds** | **High** | **None** | **Pay-per-result** | ### ๐Ÿš€ How to use 1. [Create a free Apify account with $5 credit](https://console.apify.com/sign-up?fpr=vmoqkp) 2. Open this Actor and click **Try for free** 3. Configure the input (`maxItems` and any filters) 4. Click **Start** 5. Download the dataset as CSV / Excel / JSON / XML ### ๐Ÿ’ผ Business use cases **๐Ÿ“Š Analytics & BI** โ€” feed Open Food Facts records into Looker, Tableau, Metabase for live dashboards. **๐Ÿง  Data enrichment** โ€” append Open Food Facts fields to your CRM / CDP records for better targeting. **๐Ÿ” Monitoring** โ€” schedule daily runs to detect new records, changes, or anomalies. **๐Ÿค– ML training data** โ€” use structured Open Food Facts data as features in models or test fixtures. ### ๐Ÿ”Œ Automating Open Food Facts Scraper Connect via [Apify integrations](https://apify.com/integrations): **Make**, **Zapier**, **n8n**, **Slack**, **Discord**, **Airbyte**, **Google Drive**, **Google Sheets**, **GitHub**, **Webhook**, **REST API**. ### ๐ŸŒŸ Beyond business use cases **๐Ÿ”ฌ Research** โ€” academics, journalists, policy researchers building public datasets. **๐ŸŽจ Personal** โ€” hobbyists tracking favorite topics, building personal projects, exploring data. **๐Ÿค Non-profit** โ€” NGOs, civic-tech, open-data initiatives needing structured Open Food Facts extracts. **๐Ÿงช Experimentation** โ€” students, builders, indie devs prototyping with real-world data. ### ๐Ÿค– Ask an AI assistant about this scraper Drop a link to this page into [ChatGPT](https://chat.openai.com), [Claude](https://claude.ai), [Perplexity](https://www.perplexity.ai), or [Copilot](https://copilot.microsoft.com) and ask: *"What can I do with the Open Food Facts Scraper?"* ### โ“ Frequently Asked Questions **โ“ Is the data fresh?** Yes. Every run queries Open Food Facts in real time. No cached responses. **๐Ÿ’ฐ How does pricing work?** Pay-per-result: charged once per record collected. Free plan: 10 items per run preview. **๐Ÿงพ What format is the output?** CSV, Excel, JSON, XML โ€” Apify dataset supports all four. **๐Ÿ” Do I need an API key?** No. Open Food Facts public data only, no login required. **๐Ÿ“ˆ What's the max I can scrape?** 1,000,000 items per run on paid plans. **โฑ๏ธ How long does a run take?** Typically seconds to minutes depending on `maxItems`. **๐ŸŒ Is this affiliated with Open Food Facts?** No. Independent tool. Only publicly accessible data collected. **๐Ÿ› ๏ธ What if a run fails?** You're never charged for failed records. Errors appear as `{error: "..."}` rows. **๐Ÿค Can I use this commercially?** Yes, under Apify's standard terms and Open Food Facts's public-data policies. **๐Ÿ“ž Where do I get help?** [Open our contact form](https://tally.so/r/BzdKgA). ### ๐Ÿ”Œ Integrate with any app Apify's full integration list: **Make** ยท **Zapier** ยท **n8n** ยท **Slack** ยท **Discord** ยท **Webhook** ยท **REST API** ยท **GitHub** ยท **Airbyte** ยท **Google Drive** ยท **Google Sheets** ยท **Gmail** ยท **HubSpot** ยท **Pipedream**. ### ๐Ÿ”— Recommended Actors | Actor | Description | |---|---| | [Wikipedia On This Day Scraper](https://apify.com/parseforge/wikipedia-on-this-day-scraper) | Daily Wikipedia historical events | | [Public Holidays Scraper](https://apify.com/parseforge/nager-public-holidays-scraper) | Holidays for 100+ countries | | [SPDX Software Licenses Scraper](https://apify.com/parseforge/spdx-software-licenses-scraper) | Open-source license metadata | | [ISO Country Codes Scraper](https://apify.com/parseforge/iban-com-bank-codes-scraper) | IBAN + ISO country codes | > ๐Ÿ’ก **Pro Tip:** browse the complete [ParseForge collection](https://apify.com/parseforge). **๐Ÿ†˜ Need Help?** [Open our contact form](https://tally.so/r/BzdKgA) > **โš ๏ธ Disclaimer:** independent tool, not affiliated with Open Food Facts. Only publicly available data collected. # Actor input Schema ## `maxItems` (type: `integer`): Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000 ## `mode` (type: `string`): Search by filters, or look up specific products by barcode. ## `categoryTag` (type: `string`): Open Food Facts category slug (e.g. breakfast-cereals, snacks, beverages, dairies, cheeses, chocolates). ## `brandTag` (type: `string`): Brand slug (e.g. nestle, kelloggs, quaker, danone). Lowercase, hyphen-separated. ## `country` (type: `string`): Country slug to limit products available in that market (e.g. united-states, france, germany, japan). ## `barcodes` (type: `array`): Used when Mode = Lookup. List of product barcodes (EAN/UPC codes), e.g. 3168930010265. ## Actor input object example ```json { "maxItems": 10, "mode": "search", "categoryTag": "breakfast-cereals" } ``` # Actor output Schema ## `overview` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "maxItems": 10, "mode": "search", "categoryTag": "breakfast-cereals" }; // Run the Actor and wait for it to finish const run = await client.actor("parseforge/openfoodfacts-product-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`๐Ÿ’พ Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // ๐Ÿ“š Want to learn more ๐Ÿ“–? Go to โ†’ https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "maxItems": 10, "mode": "search", "categoryTag": "breakfast-cereals", } # Run the Actor and wait for it to finish run = client.actor("parseforge/openfoodfacts-product-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("๐Ÿ’พ Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # ๐Ÿ“š Want to learn more ๐Ÿ“–? Go to โ†’ https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "maxItems": 10, "mode": "search", "categoryTag": "breakfast-cereals" }' | apify call parseforge/openfoodfacts-product-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=parseforge/openfoodfacts-product-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Open Food Facts Scraper", "description": "Scrape 3M+ grocery products from Open Food Facts with barcodes, ingredients, allergens, nutrition facts, Nutri-Score, NOVA group, eco-score and brand data. Filter by category, country, or label. Perfect for food research, retail intelligence, and diet apps.", "version": "1.0", "x-build-id": "9MBR4aQbhy1nMqdpX" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parseforge~openfoodfacts-product-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parseforge-openfoodfacts-product-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/parseforge~openfoodfacts-product-scraper/runs": { "post": { "operationId": "runs-sync-parseforge-openfoodfacts-product-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/parseforge~openfoodfacts-product-scraper/run-sync": { "post": { "operationId": "run-sync-parseforge-openfoodfacts-product-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000" }, "mode": { "title": "Mode", "enum": [ "search", "lookup" ], "type": "string", "description": "Search by filters, or look up specific products by barcode." }, "categoryTag": { "title": "Category Tag", "type": "string", "description": "Open Food Facts category slug (e.g. breakfast-cereals, snacks, beverages, dairies, cheeses, chocolates)." }, "brandTag": { "title": "Brand Tag", "type": "string", "description": "Brand slug (e.g. nestle, kelloggs, quaker, danone). Lowercase, hyphen-separated." }, "country": { "title": "Country", "type": "string", "description": "Country slug to limit products available in that market (e.g. united-states, france, germany, japan)." }, "barcodes": { "title": "Barcodes", "type": "array", "description": "Used when Mode = Lookup. List of product barcodes (EAN/UPC codes), e.g. 3168930010265.", "items": { "type": "string" } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```