## Open Food Facts Products Scraper
**💰 $2.20 / 1 000 results** · pay only for results · no credit card to try
*We do the dirty work so your dataset stays clean.* 😈
Export curated Open Food Facts product data — barcode, name, brand, quantity, category/label/country tags, nutriscore, ecoscore, NOVA group and ingredients — filtered by brand, category, country or search term, as clean JSON, CSV or Excel.
nutella, coca-cola. Leave blank… |
| `categoriesTag` | `string` | no | '—' | Filter to a category facet tag, e.g. en:sodas. Leave blank to skip this filter. |
| `countriesTag` | `string` | no | '—' | Filter to a country facet tag, e.g. en:france. Leave blank to skip this filter. |
| `searchTerms` | `string` | no | '—' | Free-text search across product name and brand. Leave blank to skip this filter. |
| `maxResults` | `integer` | no | 100 | Stop after this many products. Each product is one billed result row. |
| `proxyConfiguration` | `object` | no | {'useApifyProxy': False} | Open Food Facts is a public, keyless API and does not fingerprint clients — a proxy is optional. Leave this off unless… |
#### Example input
```json
{
"brandsTag": "nutella",
"maxResults": 3,
"proxyConfiguration": {
"useApifyProxy": false
}
}
```
### 📤 Output
Every row is one dataset item.
| Field | Type | Notes |
|---|---|---|
| `code` | `string` | Barcode / product code. |
| `product_name` | `string` | Product display name. |
| `brands` | `string` | Comma-separated brand names as OFF stores them. |
| `quantity` | `string` | Free-text pack size, e.g. '1 kg'. |
| `categories_tags` | `array` | OFF category taxonomy tags. |
| `labels_tags` | `array` | OFF label taxonomy tags (organic, fair-trade, etc.). |
| `countries_tags` | `array` | Countries the product is sold in. |
| `nutriscore_grade` | `string` | a-e or unknown/not-applicable. |
| `ecoscore_grade` | `string` | a-e or unknown/not-applicable. |
| `nova_group` | `integer` | 1-4 processing-level classification. |
| `ingredients_text` | `string` | Raw ingredients list as published. |
| `packaging_tags` | `array` | Packaging material/type tags. |
| `stores` | `string` | Comma-separated store names where reported sold. |
| `image_url` | `string` | Front product image URL. |
| `product_url` | `string` | Built as https://world.openfoodfacts.org/product/. |
| `scraped_at` | `string` | ISO 8601 UTC at row creation. |
#### Example output
```json
{
"code": "3017620422003",
"product_name": "Nutella",
"brands": "Nutella, Ferrero, Yum yum",
"quantity": null,
"categories_tags": [
"en:breakfasts",
"en:spreads",
"en:sweet-spreads"
],
"labels_tags": [],
"countries_tags": [
"en:france"
],
"nutriscore_grade": "e",
"ecoscore_grade": "unknown",
"nova_group": 4,
"ingredients_text": "Sucre, huile de palme, NOISETTES 13%, cacao maigre 7,4%, LAIT \u00e9cr\u00e9m\u00e9 en poudre 6,6%, LACTOSERUM en poudre, \u00e9mulsifiants: l\u00e9cithines [SOJA), vanilline. Sans gluten.",
"packaging_tags": [],
"stores": null,
"image_url": "https://images.openfoodfacts.org/images/products/301/762/042/2003/front_en.879.400.jpg",
"product_url": "https://world.openfoodfacts.org/product/3017620422003",
"scraped_at": "2026-08-20T12:00:00+00:00"
}
```
### 💰 Pricing
Pay-Per-Event — you pay only when these events fire:
| Event | USD | What it is |
|---|---:|---|
| `actor-start` | $0.20 | One-off warm-up charge per run |
| `result` | $0.002 | Per dataset item |
Example: 1 000 results at the rates above ≈ **$2.20**. No subscription, no minimum, no card to start — Apify gives every new account $5 of free credit.
### 🚧 Limitations
- Open Food Facts is a crowdsourced database — coverage and field completeness vary by product and region; a product missing from Open Food Facts simply won't appear.
- The Actor requires at least one filter (brand, category, country or search term) — an unfiltered full-database pull is out of scope.
- Nutrient-value-by-100g numeric breakdowns and single-barcode lookup are not included in v1.
### ❓ FAQ
**Do I need to filter by something?**
Yes — set at least one of Brand tag, Category tag, Country tag or Search terms. Open Food Facts holds 3M+ products; an unfiltered pull isn't supported.
**Why don't I see every field for every product?**
Open Food Facts is community-maintained — not every product has a filled-in nutriscore, ecoscore, or ingredients list. Missing fields come back as `null`, never a crash.
**Is this legal?**
We only fetch data Open Food Facts already publishes through its own public search API. Respect Open Food Facts' own terms before reusing the data commercially.
**How do I export to Sheets?**
After the run finishes, click *Storage → Dataset → Export* and pick CSV — Google Sheets imports it directly.
### 💬 Your feedback
Spotted a bug, hit a weird edge case, or need a new field? Open an
issue on the Actor's **Issues** tab on Apify Console — we ship
fixes weekly and we read every report.
***
Built by **[Devil Scrapes](https://apify.com/DevilScrapes)** 😈 — a small fleet of
opinionated public-data Actors. Honest pricing, real engineering, zero fine print.
# Actor input Schema
## `brandsTag` (type: `string`):
Filter to products whose brand facet matches this tag, e.g. nutella, coca-cola. Leave blank to skip this filter.
## `categoriesTag` (type: `string`):
Filter to a category facet tag, e.g. en:sodas. Leave blank to skip this filter.
## `countriesTag` (type: `string`):
Filter to a country facet tag, e.g. en:france. Leave blank to skip this filter.
## `searchTerms` (type: `string`):
Free-text search across product name and brand. Leave blank to skip this filter.
## `maxResults` (type: `integer`):
Stop after this many products. Each product is one billed result row.
## `proxyConfiguration` (type: `object`):
Open Food Facts is a public, keyless API and does not fingerprint clients — a proxy is optional. Leave this off unless your account requires egress through Apify Proxy.
## Actor input object example
```json
{
"brandsTag": "nutella",
"maxResults": 100,
"proxyConfiguration": {
"useApifyProxy": false
}
}
```
# Actor output Schema
## `datasetItems` (type: `string`):
All dataset items as JSON.
## `datasetItemsCsv` (type: `string`):
Same data exported to CSV.
## `datasetView` (type: `string`):
Open the run dataset in the Console.
# 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 = {
"brandsTag": "nutella",
"proxyConfiguration": {
"useApifyProxy": false
}
};
// Run the Actor and wait for it to finish
const run = await client.actor("devilscrapes/open-food-facts-products-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 = {
"brandsTag": "nutella",
"proxyConfiguration": { "useApifyProxy": False },
}
# Run the Actor and wait for it to finish
run = client.actor("devilscrapes/open-food-facts-products-scraper").call(run_input=run_input)
# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
print(item)
# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start
```
## CLI example
```bash
echo '{
"brandsTag": "nutella",
"proxyConfiguration": {
"useApifyProxy": false
}
}' |
apify call devilscrapes/open-food-facts-products-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"type": "http",
"url": "https://mcp.apify.com/?tools=fetch-actor-details,devilscrapes/open-food-facts-products-scraper"
}
}
}
```
The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer ` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).
## OpenAPI specification
Download the OpenAPI definition: https://api.apify.com/v2/actors/FQlxRqdUGdyDpBbpW/builds/7w8vT6Hp35ih4bdTF/openapi.json