{ "openapi": "3.0.1", "info": { "title": "CPSC Recall API", "description": "Unofficial CPSC recall API: search US consumer product recalls from the Consumer Product Safety Commission by product keyword, date and manufacturer country. Returns recall title, hazards, remedies, manufacturers, importers and countries as clean JSON.", "version": "0.1", "x-build-id": "ZR0yyxuhv3w0t1hdH" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sourcing-data-studio~cpsc-recall-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sourcing-data-studio-cpsc-recall-api", "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/sourcing-data-studio~cpsc-recall-api/runs": { "post": { "operationId": "runs-sync-sourcing-data-studio-cpsc-recall-api", "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/sourcing-data-studio~cpsc-recall-api/run-sync": { "post": { "operationId": "run-sync-sourcing-data-studio-cpsc-recall-api", "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": { "searchQueries": { "title": "Product search terms", "maxItems": 20, "type": "array", "description": "Product or brand keywords, for example charger, stroller, power bank or a brand name. Each term is looked up in the recalled product names and in the recall titles, and the results are merged without duplicates. Leave empty if you set a date range instead. At most 20 terms.", "items": { "type": "string" } }, "manufacturerCountry": { "title": "Manufacturer country", "type": "string", "description": "Optional. Keep only recalls whose product was made in this country. Give one English country name, for example China or Vietnam. Names are matched after normalising, so USA, U.S. and United States are the same country. A name the Actor does not know stops the run before it starts. Leave empty for all countries." }, "dateFrom": { "title": "Recalled on or after", "type": "string", "description": "Optional. Earliest recall date to include, as an ISO date (YYYY-MM-DD), for example 2025-01-01. The first CPSC notices date from 1973; an earlier date is treated as 1973-01-01." }, "dateTo": { "title": "Recalled on or before", "type": "string", "description": "Optional. Latest recall date to include, as an ISO date (YYYY-MM-DD). Leave empty for up to today. A date in the future is treated as today." }, "maxItems": { "title": "Maximum recalls", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of recall notices to save and pay for in this run, across all search terms. The newest recalls are kept first.", "default": 100 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional. The source is an official open API, so no proxy is needed and none is used by default. A proxy is never used to get around a refusal: after the source refuses a request, the Actor does not ask again from another address.", "default": { "useApifyProxy": false } }, "maxRequestRetries": { "title": "Retries per request", "minimum": 0, "maximum": 6, "type": "integer", "description": "How many times a failed request is retried with exponential backoff. A refusal by the source (HTTP 401, 403 or 407) is never retried; after HTTP 429 the Actor waits as long as the source asks (at most 60 seconds) and asks again from the same address. A connection error is retried through a new connection. Failed requests are never charged.", "default": 3 }, "debugLog": { "title": "Debug log", "type": "boolean", "description": "Print detailed debug messages to the run log.", "default": false }, "feedback": { "title": "Feedback for the developer", "maxLength": 1000, "type": "string", "description": "Optional. Tell us which field, filter or data you need next, or what went wrong. It is saved with the run summary. Do not include personal data. AI agents may also use this field to report problems." } } }, "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 } } } } } } } } } }