{ "openapi": "3.0.1", "info": { "title": "US Product Recall Monitoring & Risk Scorer", "description": "Collect and prioritize public US consumer-product and medical-device recall records from the CPSC Recall API and openFDA. Filter by product or brand, receive normalized risk scores, confidence, reasons, recommended actions, and source links, then export via datasets, API, schedules, or webhooks.", "version": "1.0", "x-build-id": "sJhbknsFOWiB4UMch" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/zentrafoundry~product-recall-risk-scorer/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-zentrafoundry-product-recall-risk-scorer", "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/zentrafoundry~product-recall-risk-scorer/runs": { "post": { "operationId": "runs-sync-zentrafoundry-product-recall-risk-scorer", "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/zentrafoundry~product-recall-risk-scorer/run-sync": { "post": { "operationId": "run-sync-zentrafoundry-product-recall-risk-scorer", "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", "required": [ "sourceMode" ], "properties": { "buyerQuery": { "title": "Buyer query", "type": "string", "description": "Buyer-visible description of the recall-monitoring task.", "default": "all public product and medical-device recall records" }, "taskIntent": { "title": "Task intent", "type": "string", "description": "Stable product-specific purpose for a saved Apify task.", "default": "buyer-ready-product-recall-run" }, "sourceMode": { "title": "Run mode", "enum": [ "startUrls", "sample" ], "type": "string", "description": "Production retrieves the complete official recall sources. Sample emits one public-safe, non-billable schema check.", "default": "sample" }, "outputMode": { "title": "Output mode", "enum": [ "buyer-ready-records", "sample-records" ], "type": "string", "description": "Buyer-ready mode charges one recall-alert event per delivered record. Sample mode is non-billable.", "default": "sample-records" }, "watchlistTerms": { "title": "Optional product or brand filters", "type": "array", "description": "When empty, every available CPSC and openFDA recall is delivered. Add terms only when the buyer wants a narrower watchlist.", "default": [], "items": { "type": "string" } }, "startUrls": { "title": "Additional recall JSON URLs", "type": "array", "description": "Optional public or user-authorized JSON endpoints. Official CPSC and openFDA sources are always included in production.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "title": "URL", "type": "string", "description": "Public or user-authorized recall JSON URL." } } }, "default": [] }, "requestTimeoutSecs": { "title": "Source request timeout seconds", "minimum": 5, "maximum": 120, "type": "integer", "description": "Timeout for each individual source request; it is not an overall run or result limit.", "default": 30 }, "maxRequestRetries": { "title": "Maximum transient request retries", "minimum": 0, "maximum": 5, "type": "integer", "description": "Retries failed source requests without limiting the number of recall records.", "default": 2 }, "sinceLastRun": { "title": "Only emit previously unseen recalls", "type": "boolean", "description": "Optional recurring-task mode. Disabled by default so normal buyer runs receive the complete source result set.", "default": false }, "deltaMode": { "title": "Stable deduplication keys", "type": "boolean", "description": "Preserves stable record keys for recurring buyer workflows without reducing a normal full run.", "default": true } } }, "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 } } } } } } } } } }