{ "openapi": "3.0.1", "info": { "title": "CPSC product recalls - search by product, hazard, date (API)", "description": "Search U.S. Consumer Product Safety Commission recalls (saferproducts.gov API) by title, product, hazard, manufacturer and date range. One row per recall: number, date, title, description, products, hazards, remedies, manufacturers, retailers, units, image count, URL. Default: last 180 days.", "version": "0.1", "x-build-id": "fLcu3DjvtOiaPG9sV" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/retrainmap~cpsc-recalls/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-retrainmap-cpsc-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/retrainmap~cpsc-recalls/runs": { "post": { "operationId": "runs-sync-retrainmap-cpsc-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/retrainmap~cpsc-recalls/run-sync": { "post": { "operationId": "run-sync-retrainmap-cpsc-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": { "title_contains": { "title": "Recall title contains", "type": "string", "description": "Optional substring of the recall title (the API's RecallTitle parameter, case-insensitive). Empty = any title." }, "product_contains": { "title": "Product name contains", "type": "string", "description": "Optional substring of a recalled product's name (the API's ProductName parameter). Empty = any product." }, "hazard_contains": { "title": "Hazard text contains", "type": "string", "description": "Optional substring of the hazard description, e.g. fire, laceration, choking. Applied by the Actor to the hazard texts of the recalls the API returned for the other filters (the API's own Hazard parameter matched nothing in testing on 2026-09-04). Empty = any hazard." }, "manufacturer_contains": { "title": "Manufacturer contains", "type": "string", "description": "Optional substring of a manufacturer name (the API's Manufacturer parameter). Note many recalls list importers or retailers instead of manufacturers. Empty = any." }, "date_from": { "title": "Recall date from (YYYY-MM-DD)", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Optional, inclusive (the API's RecallDateStart). When both dates are empty the Actor uses the last 180 days (today minus 180 days through today, UTC); if only date_to is given, date_from becomes date_to minus 180 days." }, "date_to": { "title": "Recall date to (YYYY-MM-DD)", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Optional, inclusive (the API's RecallDateEnd). If only date_from is given, date_to becomes today (UTC)." }, "max_records": { "title": "Maximum records", "minimum": 1, "maximum": 20000, "type": "integer", "description": "Stop after this many recalls have been written (newest first). The API returns every matching recall in one answer; a year holds roughly 550 recalls.", "default": 300 }, "request_interval_ms": { "title": "Minimum interval between requests (ms)", "minimum": 250, "maximum": 10000, "type": "integer", "description": "Politeness delay towards saferproducts.gov (one request per run plus retries); the floor is 250 ms.", "default": 1000 }, "contact_email": { "title": "Contact e-mail (From: header)", "type": "string", "description": "Sent in the standard From: request header so the data owner can reach the operator (RFC 9110 s10.1.2).", "default": "info@steelyardclinical.com" } } }, "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 } } } } } } } } } }