{ "openapi": "3.0.1", "info": { "title": "Australia Product Safety Recalls Scraper", "description": "Search Australia's official product recall register (ACCC Product Safety Australia). Find recalled products by keyword, category, brand, or date. Get hazard details, affected batches/SKUs, supplier, and consumer instructions.", "version": "1.0", "x-build-id": "f9RBLRyNg71OQ3hVc" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~australia-product-safety-recalls-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-australia-product-safety-recalls-scraper", "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/crawlerbros~australia-product-safety-recalls-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-australia-product-safety-recalls-scraper", "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/crawlerbros~australia-product-safety-recalls-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-australia-product-safety-recalls-scraper", "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": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "search", "byUrl" ], "type": "string", "description": "What to fetch.", "default": "search" }, "searchQuery": { "title": "Search query", "type": "string", "description": "Free-text keyword search across recall titles, descriptions, and hazards (mode=search). Leave empty to browse by filters only.", "default": "battery" }, "recallUrls": { "title": "Recall URLs (mode=byUrl)", "type": "array", "description": "Exact recall page URLs from productsafety.gov.au, e.g. `https://www.productsafety.gov.au/search-consumer-product-recalls/findon-light-up-sensory-plush`.", "default": [], "items": { "type": "string" } }, "category": { "title": "Category", "enum": [ "", "Baby and toddler products", "Chemicals and poisons", "Clothing and fashion accessories", "Compulsory recall", "Cosmetic and health products", "Electronics and technology", "Food and grocery packaging", "Gas products and appliances", "General product safety", "Home and garden", "Industry, tools and machinery", "Kids' toys", "Sports and recreation", "Vehicle accessories (registered)", "Vehicles (unregistered or off-road)" ], "type": "string", "description": "Filter to a top-level product category.", "default": "" }, "brand": { "title": "Brand contains", "type": "string", "description": "Filter to recalls whose brand name contains this text (case-insensitive). Brand is a detail-page field, so setting this automatically enables 'Fetch full details'; recalls with no brand on file are excluded." }, "publishedDateFrom": { "title": "Published on/after (YYYY-MM-DD)", "type": "string", "description": "Only include recalls published on or after this date." }, "publishedDateTo": { "title": "Published on/before (YYYY-MM-DD)", "type": "string", "description": "Only include recalls published on or before this date." }, "sortBy": { "title": "Sort by", "enum": [ "relevance", "date" ], "type": "string", "description": "Sort order for results (mode=search).", "default": "relevance" }, "fetchFullDetails": { "title": "Fetch full details", "type": "boolean", "description": "Fetch each recall's detail page for brand, supplier, barcodes/SKU, sale dates, and locations sold. Uses 1 extra request per recall; disable for a faster, lighter run (mode=search only — mode=byUrl always fetches the detail page).", "default": true }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Hard cap on emitted records. In mode=search, productsafety.gov.au's own feed returns at most ~100 matches for a single search/filter combination (no deeper pagination is available upstream) -- to collect more, run multiple searches with narrower filters (e.g. split by `publishedDateFrom`/`publishedDateTo` or `category`). In mode=byUrl, this caps how many of the supplied `recallUrls` are processed.", "default": 50 } } }, "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 } } } } } } } } } }