{ "openapi": "3.0.1", "info": { "title": "BigBadToyStore Scraper", "description": "Scrape BigBadToyStore.com - search collectibles by keyword, browse by department or toy line/brand, or look up product URLs directly. Get price, brand, manufacturer, pre-order status, release date, SKU, packaging variation, images, and product URLs.", "version": "1.0", "x-build-id": "xf5orcvgN8yelkkaX" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~bigbadtoystore-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-bigbadtoystore-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~bigbadtoystore-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-bigbadtoystore-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~bigbadtoystore-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-bigbadtoystore-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", "byDepartment", "byBrand", "byUrl" ], "type": "string", "description": "What to fetch.", "default": "search" }, "searchQuery": { "title": "Search query (mode=search)", "type": "string", "description": "Free-text keyword search, e.g. a toy line, character, or product name.", "default": "Transformers" }, "departmentId": { "title": "Department (mode=byDepartment; optional filter otherwise)", "enum": [ "", "43623", "7391", "7399", "45790", "45792", "7392", "45794", "7388", "7394", "45793", "44078", "126", "7395", "7390", "7398" ], "type": "string", "description": "Required for mode=byDepartment. Also usable as an extra narrowing filter on `search` / `byBrand`.", "default": "" }, "brandId": { "title": "Toy line / brand (mode=byBrand; optional filter otherwise)", "enum": [ "", "2085", "2149", "2308", "2891", "11481", "872", "4863", "1971", "1786", "26112", "2431", "614", "1103", "16675", "2603", "1170", "856", "2363", "3234", "10043", "1385", "924", "1847", "3218", "46976", "47002", "2525", "3215", "1670", "16136", "2782", "27077", "4829", "15232", "1833", "1366" ], "type": "string", "description": "Curated list of popular toy lines/brands. Required for mode=byBrand unless `customBrandName` is set. Also usable as an extra narrowing filter on `search` / `byDepartment`.", "default": "" }, "customBrandName": { "title": "Custom brand / line name (mode=byBrand fallback)", "type": "string", "description": "Free-text toy line/brand name not in the curated `brandId` list, e.g. `Diaclone` or `Robotech`. Falls back to a keyword search scoped to this term (BigBadToyStore's brand filter only accepts internal numeric IDs, which the curated list covers for the ~35 most popular lines)." }, "companyId": { "title": "Manufacturer / company (optional filter, all modes)", "enum": [ "", "1475", "62", "165", "5", "1", "10", "279", "126", "2", "51", "904", "11", "388", "124", "1363", "1143", "421", "28", "583", "981", "609", "3", "232", "332", "299", "23", "424", "14", "13", "261", "256", "365", "55", "25", "826", "139", "777" ], "type": "string", "description": "Narrow results to a specific manufacturer/publisher, e.g. Hasbro, Hot Toys, Good Smile Company.", "default": "" }, "productUrls": { "title": "Product URLs (mode=byUrl)", "type": "array", "description": "Required for mode=byUrl. One or more BigBadToyStore product URLs, e.g. `https://www.bigbadtoystore.com/product/transformers-kuro-kara-kuri-skywarp-action-figure-192744`. Useful for price/stock monitoring on specific SKUs you already know.", "default": [], "items": { "type": "string" } }, "sortOrder": { "title": "Sort order", "enum": [ "Relevance", "New", "PriceHighToLow", "PriceLowToHigh", "Discount" ], "type": "string", "description": "Result ordering, matches the site's own sort dropdown.", "default": "Relevance" }, "availabilityStatuses": { "title": "Availability statuses", "type": "array", "description": "Which stock statuses to include. Sold Out / Waitlist mostly surface BigBadWorkshop crowdfunding project pages rather than standard retail products in the current catalog.", "items": { "type": "string", "enum": [ "InStock", "PreOrder", "SoldOut", "Waitlist" ], "enumTitles": [ "In Stock", "Pre-Order", "Sold Out", "Waitlist" ] }, "default": [ "InStock", "PreOrder" ] }, "minPrice": { "title": "Min price (USD)", "minimum": 0, "maximum": 100000, "type": "number", "description": "Drop products cheaper than this." }, "maxPrice": { "title": "Max price (USD)", "minimum": 0, "maximum": 100000, "type": "number", "description": "Drop products more expensive than this." }, "preorderOnly": { "title": "Pre-order items only", "type": "boolean", "description": "Keep only products currently listed as Pre-Order (drops In Stock / Sold Out / Waitlist items regardless of `availabilityStatuses`).", "default": false }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Hard cap on emitted product records. Kept modest by default — each product may require a slower anti-bot fallback fetch (see README).", "default": 15 } } }, "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 } } } } } } } } } }