{ "openapi": "3.0.1", "info": { "title": "Open Food Facts Scraper — Nutrition, Barcode & Labels", "description": "Scrape Open Food Facts by category, brand, or barcode. Extract nutrition facts, Nutri-Score, NOVA group, ingredients, labels, and allergens for diet analysis, food research, and product databases. No API key, no login.", "version": "1.0", "x-build-id": "SoGegUvdt0zr1BX2R" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/logiover~open-food-facts-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-logiover-open-food-facts-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/logiover~open-food-facts-scraper/runs": { "post": { "operationId": "runs-sync-logiover-open-food-facts-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/logiover~open-food-facts-scraper/run-sync": { "post": { "operationId": "run-sync-logiover-open-food-facts-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": { "mode": { "title": "Mode", "enum": [ "search", "product", "category" ], "type": "string", "description": "Scraping mode: 'search' (main — search/filter products by category/brand/country), 'product' (fetch by barcode list), 'category' (browse a category JSON endpoint).", "default": "search" }, "categories": { "title": "Categories", "type": "array", "description": "Category slugs to search/browse (e.g. 'breakfast-cereals', 'cheeses', 'yogurts'). Used in 'search' and 'category' modes.", "items": { "type": "string" }, "default": [ "breakfast-cereals", "cheeses", "yogurts", "chocolates", "beverages" ] }, "brands": { "title": "Brands", "type": "array", "description": "Filter by brand names (e.g. 'Kellogg's', 'Nestlé'). Used in 'search' mode. Leave empty for all brands.", "items": { "type": "string" }, "default": [] }, "countries": { "title": "Countries", "type": "array", "description": "Filter by country. Used in 'search' mode. Leave empty for all countries.", "items": { "type": "string", "enum": [ "united-states", "united-kingdom", "france", "germany", "spain", "italy", "netherlands", "belgium", "switzerland", "austria", "portugal", "ireland", "poland", "sweden", "norway", "denmark", "finland", "greece", "canada", "mexico", "brazil", "argentina", "chile", "colombia", "australia", "new-zealand", "japan", "china", "south-korea", "india", "russia", "turkey", "morocco", "tunisia", "algeria", "egypt", "south-africa", "thailand", "vietnam", "indonesia", "malaysia", "singapore", "united-arab-emirates", "saudi-arabia", "israel", "romania", "hungary", "czech-republic", "ukraine", "croatia" ], "enumTitles": [ "United States", "United Kingdom", "France", "Germany", "Spain", "Italy", "Netherlands", "Belgium", "Switzerland", "Austria", "Portugal", "Ireland", "Poland", "Sweden", "Norway", "Denmark", "Finland", "Greece", "Canada", "Mexico", "Brazil", "Argentina", "Chile", "Colombia", "Australia", "New Zealand", "Japan", "China", "South Korea", "India", "Russia", "Turkey", "Morocco", "Tunisia", "Algeria", "Egypt", "South Africa", "Thailand", "Vietnam", "Indonesia", "Malaysia", "Singapore", "United Arab Emirates", "Saudi Arabia", "Israel", "Romania", "Hungary", "Czech Republic", "Ukraine", "Croatia" ] }, "default": [] }, "barcodes": { "title": "Barcodes", "type": "array", "description": "List of EAN/UPC barcodes to fetch (used in 'product' mode). Example: ['3017620422003', '5449000000996'].", "items": { "type": "string" }, "default": [] }, "sortBy": { "title": "Sort By", "enum": [ "popularity_key", "product_name", "created_t", "last_modified_t", "nutriscore_score", "nova_score", "unique_scans_n" ], "type": "string", "description": "Sort order for 'search' mode results.", "default": "popularity_key" }, "maxResults": { "title": "Max Results", "minimum": 1, "type": "integer", "description": "Maximum number of products to scrape per category/search. Set to 0 for unlimited.", "default": 500 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings (AUTO recommended). Open Food Facts is a public API; the actor also falls back to a direct connection on the final retry." } } }, "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 } } } } } } } } } }