{ "openapi": "3.0.1", "info": { "title": "Smyths Toys Scraper: Prices, EAN Codes, Stock & Product Data", "description": "Scrape Smyths Toys UK and Ireland by category, search or product URL. Get prices, was prices, discounts, EAN barcodes, brand, ratings, reviews, images and descriptions, plus delivery and click & collect stock. Track LEGO and toy prices. Proxies included on paid plans.", "version": "0.1", "x-build-id": "a9vgJYwQTa8IZgJAJ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fayoussef~smythstoys-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fayoussef-smythstoys-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/fayoussef~smythstoys-scraper/runs": { "post": { "operationId": "runs-sync-fayoussef-smythstoys-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/fayoussef~smythstoys-scraper/run-sync": { "post": { "operationId": "run-sync-fayoussef-smythstoys-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", "properties": { "startUrls": { "title": "Smyths Toys URLs", "type": "array", "description": "Paste any mix of Smyths Toys category, search or product URLs, for example https://www.smythstoys.com/uk/en-gb/baby/travel-systems/c/SM060231, https://www.smythstoys.com/uk/en-gb/search?text=lego or a product page ending in /p/235359. Every page of a category or search is collected (up to Max products), so page and count params in the URL do not matter. A sort in the URL is kept.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "searchTerms": { "title": "Search terms", "type": "array", "description": "Words to search on Smyths Toys, one per line, exactly as you would type them in the site's search box (for example lego technic or paw patrol). Each term runs as its own search in the market chosen below.", "items": { "type": "string" } }, "market": { "title": "Market for search terms", "enum": [ "uk/en-gb", "ie/en-ie" ], "type": "string", "description": "Which Smyths Toys store the search terms run against. URLs always use the store in their own address.", "default": "uk/en-gb" }, "sortBy": { "title": "Sort search terms by", "enum": [ "auto", "relevance", "bestsellers", "price_asc", "price_desc", "rating_desc", "newest" ], "type": "string", "description": "Order for search-term results. Matters when Max products is lower than the number of results, since the first products in this order are the ones collected.", "default": "auto" }, "maxItems": { "title": "Max products", "minimum": 1, "type": "integer", "description": "Stop after this many products across all URLs and search terms. Products found by more than one input are saved once.", "default": 1000 }, "includeDetails": { "title": "Full product details", "type": "boolean", "description": "Open every product for its EAN, description, features, age range, all images, category path, safety warning and supplier contact. Turn off for a faster price-only run that keeps name, prices, rating and main image.", "default": true }, "includeStock": { "title": "Stock status", "type": "boolean", "description": "Add home delivery and click & collect stock status for every product (in stock, out of stock, pre-order, expected date). Adds one request per product.", "default": false }, "maxConcurrency": { "title": "Parallel workers", "minimum": 1, "maximum": 6, "type": "integer", "description": "How many workers fetch at once. More workers finish large categories faster but need more memory: 3 fits the default 2 GB. Free plan runs use 1.", "default": 3 } } }, "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 } } } } } } } } } }