{ "openapi": "3.0.1", "info": { "title": "FDA Food Recalls Scraper - openFDA Enforcement API", "description": "Scrape FDA food recalls and enforcement reports from the official openFDA API, no API key needed. Filter food recall data by hazard class, product, recalling firm, state, status and date range. Get recall reasons, distribution, firm contact address and dates. Export to JSON, CSV or Excel.", "version": "0.2", "x-build-id": "mcqfAdcD6L6vQ7LDb" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapers_lat~openfda-food-recalls-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapers_lat-openfda-food-recalls-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/scrapers_lat~openfda-food-recalls-scraper/runs": { "post": { "operationId": "runs-sync-scrapers_lat-openfda-food-recalls-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/scrapers_lat~openfda-food-recalls-scraper/run-sync": { "post": { "operationId": "run-sync-scrapers_lat-openfda-food-recalls-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": { "maxRecalls": { "title": "Max Recalls", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Maximum number of food recall records to collect. Optional. openFDA paginates with skip up to 25000, so for very large pulls narrow the filters or date range." }, "searchQuery": { "title": "Search Query", "type": "string", "description": "A simple keyword (matched to the recall reason, for example listeria, salmonella, undeclared allergen), or a raw openFDA search expression containing a field, for example product_description:cheese or recalling_firm:Tyson. Leave empty to pull the most recent food recalls." }, "classification": { "title": "Classification", "enum": [ "", "Class I", "Class II", "Class III" ], "type": "string", "description": "Recall hazard class. Class I is the most serious (reasonable probability of serious health consequences or death).", "default": "" }, "status": { "title": "Status", "enum": [ "", "Ongoing", "Completed", "Terminated", "Pending" ], "type": "string", "description": "Recall status.", "default": "" }, "state": { "title": "State", "enum": [ "", "AL", "AK", "AZ", "AR", "CA", "CO", "CT", "DE", "DC", "FL", "GA", "HI", "ID", "IL", "IN", "IA", "KS", "KY", "LA", "ME", "MD", "MA", "MI", "MN", "MS", "MO", "MT", "NE", "NV", "NH", "NJ", "NM", "NY", "NC", "ND", "OH", "OK", "OR", "PA", "RI", "SC", "SD", "TN", "TX", "UT", "VT", "VA", "WA", "WV", "WI", "WY", "PR" ], "type": "string", "description": "Two-letter US state code of the recalling firm, for example CA, NY, TX.", "default": "" }, "recallingFirm": { "title": "Recalling Firm", "type": "string", "description": "Filter by the recalling firm or manufacturer name, for example Tyson, Dole, Nestle. Matches firms whose name contains this phrase." }, "productDescription": { "title": "Product Keyword", "type": "string", "description": "Filter by a word or phrase in the product description, for example cheese, spinach, ice cream, peanut butter." }, "city": { "title": "City", "type": "string", "description": "Filter by the city of the recalling firm, for example Los Angeles, Chicago." }, "country": { "title": "Country", "type": "string", "description": "Filter by the recalling firm country, for example United States, Canada, Mexico. Leave empty for all countries." }, "voluntaryMandated": { "title": "Voluntary or Mandated", "enum": [ "", "Voluntary", "Mandated" ], "type": "string", "description": "Whether the recall was firm-initiated (voluntary) or ordered by the FDA (mandated).", "default": "" }, "dateFrom": { "title": "Date From", "type": "string", "description": "Only include recalls with a date on or after this date (YYYY-MM-DD). Applies to the Date Field selected below." }, "dateTo": { "title": "Date To", "type": "string", "description": "Only include recalls with a date on or before this date (YYYY-MM-DD). Applies to the Date Field selected below." }, "dateField": { "title": "Date Field", "enum": [ "report_date", "recall_initiation_date", "center_classification_date", "termination_date" ], "type": "string", "description": "Which recall date the Date From / Date To range applies to.", "default": "report_date" }, "sortOrder": { "title": "Sort Order", "enum": [ "", "Newest first", "Oldest first" ], "type": "string", "description": "Order results by the selected Date Field. Leave as default to use the openFDA relevance order.", "default": "" }, "recallNumber": { "title": "Recall Number", "type": "string", "description": "Look up one exact FDA recall number, for example F-0609-2015." }, "eventId": { "title": "Event ID", "type": "string", "description": "Pull every recall that belongs to one FDA recall event, for example 69516. A single event often groups many related product recalls." }, "includeFirmHistory": { "title": "Add firm recall history (paid add-on)", "type": "boolean", "description": "Paid add-on for paying plans. For each recalling firm, add a firmRecallHistory object with the firm's full FDA food-recall track record: total recalls, Class I/II/III breakdown, status breakdown, and earliest and latest report dates. Charged as the details event only for rows that actually receive firm-history data. Off by default.", "default": false }, "productKeywords": { "title": "Product Keywords (any match)", "type": "array", "description": "One or more keywords. A recall matches when any keyword appears in the product description or the recall reason, for example [\"cheese\", \"spinach\", \"peanut butter\"].", "items": { "type": "string" } }, "classifications": { "title": "Classifications (any match)", "type": "array", "description": "Match any of these hazard classes, for example [\"Class I\", \"Class II\"]. Combine with, or use instead of, the single Classification filter.", "items": { "type": "string" } }, "statuses": { "title": "Statuses (any match)", "type": "array", "description": "Match any of these recall statuses, for example [\"Ongoing\", \"Completed\"].", "items": { "type": "string" } }, "states": { "title": "States (any match)", "type": "array", "description": "Match any of these two-letter US state codes of the recalling firm, for example [\"CA\", \"NY\", \"TX\"].", "items": { "type": "string" } }, "countries": { "title": "Countries (any match)", "type": "array", "description": "Match any of these recalling-firm countries, for example [\"United States\", \"Canada\"].", "items": { "type": "string" } }, "reportDateFrom": { "title": "Report Date From", "type": "string", "description": "Only include recalls with an FDA report date on or after this date (YYYY-MM-DD). Independent of the Date Field selector." }, "reportDateTo": { "title": "Report Date To", "type": "string", "description": "Only include recalls with an FDA report date on or before this date (YYYY-MM-DD)." }, "initiationDateFrom": { "title": "Initiation Date From", "type": "string", "description": "Only include recalls with a recall initiation date on or after this date (YYYY-MM-DD)." }, "initiationDateTo": { "title": "Initiation Date To", "type": "string", "description": "Only include recalls with a recall initiation date on or before this date (YYYY-MM-DD)." } } }, "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 } } } } } } } } } }