{ "openapi": "3.0.1", "info": { "title": "Product Recalls Scraper — CPSC + FDA Food, Drug & Device Feed", "description": "US product recall feed: CPSC recalls back to 1973, openFDA food, drug & device recalls since 2012, opt-in NHTSA vehicle recalls, one schema. Filter by date & keyword. onlyNew mode: scheduled runs return only new recalls, no repeat charges.", "version": "0.1", "x-build-id": "cAQt5lYxqHr8bRz9W" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parallelstudio~us-product-recalls-unified/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parallelstudio-us-product-recalls-unified", "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/parallelstudio~us-product-recalls-unified/runs": { "post": { "operationId": "runs-sync-parallelstudio-us-product-recalls-unified", "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/parallelstudio~us-product-recalls-unified/run-sync": { "post": { "operationId": "run-sync-parallelstudio-us-product-recalls-unified", "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": { "sources": { "title": "Recall sources", "type": "array", "description": "Which recall feeds to include. Allowed values: \"cpsc\" (Consumer Product Safety Commission: toys, furniture, bikes, appliances, batteries, clothing), \"fda-food\" (FDA food and dietary supplement recalls), \"fda-drug\" (FDA drug recalls), \"fda-device\" (FDA medical device recalls) and the opt-in \"nhtsa\" (NHTSA vehicle, equipment, tire and child-seat recalls, one row per recall campaign, matched on the Part 573 report received date; this feed has history since 2010 and the file is refreshed daily). The default is the four CPSC/FDA feeds; add \"nhtsa\" to include vehicle recalls.", "default": [ "cpsc", "fda-food", "fda-drug", "fda-device" ], "items": { "type": "string" } }, "daysBack": { "title": "Days back", "type": "integer", "description": "How many days back to look. CPSC is matched on recall date and FDA on report (publication) date. CPSC posts recalls on Thursdays and FDA publishes its enforcement report weekly on Wednesdays, often weeks after the recall started, so use 7 or more. CPSC history reaches back to 1973, FDA to June 2012.", "default": 30 }, "keyword": { "title": "Keyword (brand, firm, product or hazard)", "type": "string", "description": "Optional. Case-insensitive text matched against every field of each recall: brand, firm, product name, lot code, retailer or reason, e.g. \"salmonella\", \"Amazon\", \"lithium battery\". Leave empty to get all recalls in the window." }, "maxItemsPerSource": { "title": "Max recalls per source", "type": "integer", "description": "Maximum recalls returned for each source, newest first. Also caps your cost: you pay $0.003 per recall, so 4 sources x 100 = at most 400 recalls ($1.20). A typical week has 45 to 167 recalls across all four sources.", "default": 200 }, "onlyNew": { "title": "Only new recalls (skip already delivered)", "type": "boolean", "description": "For scheduled runs: skip recalls delivered by earlier runs with the same sources and keyword, so you are not charged for them again. You can change Days back or Max recalls per source between runs. Status updates to a recall that was already delivered are not re-sent. Leave off to get every matching recall each run.", "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 } } } } } } } } } }