{ "openapi": "3.0.1", "info": { "title": "Open Food Facts Product Scraper (Nutrition Data JSON)", "description": "Official Open Food Facts product data: 4,888,333 products, 360,968 from Spain (7.4%). Search by barcode, brand, category or country; the Store example defaults to Spain. Monitor new or modified products and keep a daily Spain change history. Public ODbL data, pay per row.", "version": "0.1", "x-build-id": "hhsgOmdbNLISSiLOZ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/steadfetch~open-food-facts-extractor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-steadfetch-open-food-facts-extractor", "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/steadfetch~open-food-facts-extractor/runs": { "post": { "operationId": "runs-sync-steadfetch-open-food-facts-extractor", "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/steadfetch~open-food-facts-extractor/run-sync": { "post": { "operationId": "run-sync-steadfetch-open-food-facts-extractor", "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": [ "extract", "monitor" ], "type": "string", "description": "extract: emit every matching product. monitor: emit only products that are new or modified since the previous run with the same query (deduplicated by code).", "default": "extract" }, "codes": { "title": "Barcodes", "type": "array", "description": "Open Food Facts barcodes (for example 0737628064502). Bulk lookups are deduplicated by code.", "items": { "type": "string" } }, "categories_tags": { "title": "Categories", "type": "array", "description": "Category tags such as en:yogurts or en:breakfast-cereals. Multiple values are combined with OR.", "items": { "type": "string" } }, "brands": { "title": "Brand", "type": "string", "description": "Brand tag or name, for example danone. Passed to the official brands_tags filter." }, "countries": { "title": "Country", "type": "string", "description": "Country tag or name. The Store example defaults to Spain (en:spain, 360,968 products); other valid values are en:united-states, en:france, etc. Comma-separated values are combined with AND by the API." }, "search": { "title": "Name or brand filter", "type": "string", "description": "Optional case-insensitive substring filter applied to product_name and brands of the structured results. Open Food Facts API v2 has no full-text search, so this cannot be used alone." }, "maxResults": { "title": "Max results", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum number of products to save to the dataset. Default 100, maximum 5000.", "default": 100 }, "strictSchema": { "title": "Strict output schema", "type": "boolean", "description": "Fail the run when an item does not match the OUTPUT schema. Keep enabled: Steadfetch never publishes Actors without output-schema validation.", "default": true }, "saveSnapshot": { "title": "Save daily Spain snapshot to Steadfetch storage", "type": "boolean", "description": "Internal use: scheduled Spain series only. When enabled on a run started by the Steadfetch account, the run also writes the day's Spain change snapshot and change report to Steadfetch object storage. Customer runs never write, even with this flag on; QA runs of our account do not pass it.", "default": false } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }