{ "openapi": "3.0.1", "info": { "title": "Product Recalls API - CPSC, NHTSA, USDA, EU, UK", "description": "Search product recalls from US CPSC, NHTSA, USDA FSIS, EU Safety Gate and UK FSA in one unified JSON schema, with an only-new mode for monitoring.", "version": "0.1", "x-build-id": "MgRaTbeWanyn6s86x" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/whitel1ght~unified-product-recalls/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-whitel1ght-unified-product-recalls", "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/whitel1ght~unified-product-recalls/runs": { "post": { "operationId": "runs-sync-whitel1ght-unified-product-recalls", "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/whitel1ght~unified-product-recalls/run-sync": { "post": { "operationId": "run-sync-whitel1ght-unified-product-recalls", "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": "Sources", "type": "array", "description": "Which recall sources to query. cpsc = US Consumer Product Safety Commission (consumer products), nhtsa = US vehicle recalls, fsis = US USDA meat/poultry/egg food recalls and public health alerts, safety-gate = EU Safety Gate (RAPEX) non-food product alerts from the official weekly reports (beta; alerts appear once their weekly report is published), fsa = UK Food Standards Agency food alerts. Defaults to all five.", "items": { "type": "string", "enum": [ "cpsc", "nhtsa", "fsis", "safety-gate", "fsa" ], "enumTitles": [ "US CPSC - consumer products", "US NHTSA - vehicles", "US USDA FSIS - meat, poultry, eggs", "EU Safety Gate - non-food products (beta)", "UK FSA - food alerts" ] }, "default": [ "cpsc", "nhtsa", "fsis", "safety-gate", "fsa" ] }, "searchText": { "title": "Search text", "type": "string", "description": "Keywords matched case-insensitively against title, product, hazard, company and brand. Multiple words must ALL appear, e.g. \"peanut\" or \"lithium battery fire\". Leave empty for no keyword filter." }, "dateFrom": { "title": "Date from", "type": "string", "description": "Earliest recall date to include, format YYYY-MM-DD (inclusive). Defaults to 30 days before dateTo. Dates are UTC calendar dates." }, "dateTo": { "title": "Date to", "type": "string", "description": "Latest recall date to include, format YYYY-MM-DD (inclusive). Defaults to today." }, "maxResults": { "title": "Max results", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum number of recalls returned in total across all sources, split fairly between the selected sources and sorted newest first. Each returned recall is billed, so keep this small for tests.", "default": 20 }, "onlyNew": { "title": "Only new since last run", "type": "boolean", "description": "Return only recalls not delivered by earlier runs that used the same Monitor ID. Requires monitorId. The first run is the baseline and returns everything matching. Only-new runs look back at most 180 days.", "default": false }, "monitorId": { "title": "Monitor ID", "type": "string", "description": "Short name of this monitoring job, e.g. \"peanut-watch\". Recalls already delivered are remembered per Monitor ID in a named key-value store in your account. Used only when onlyNew is on." }, "includeRaw": { "title": "Include raw source record", "type": "boolean", "description": "Add the unmodified source record under \"raw\" (larger output).", "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 } } } } } } } } } }