Smyths Toys Stock & Price Scraper

Get live stock and price for Smyths Toys UK products as clean JSON - the current price with was-price, RRP and discount, home delivery stock (in stock, out of stock, pre-order, expected stock date), click & collect stock and the delivery and collection messages, plus age suitability and delivery type. You get the same JSON Smyths' own store reads for its product pages, unchanged. Turn on product page details to also get each product's description, key features, safety warnings, brand, EAN and full image gallery. Give product codes or links, or find the products by search or by category - up to a whole Smyths department in one run. No Smyths account, no API key, no proxies to configure.

Features

• Any product input - a Smyths product code (156809), a product or bundle page link (https://www.smythstoys.com/uk/en-gb/.../p/156809) or a product-inventory API link.
• No codes needed - search Smyths (lego star wars) or list a category (SM0601 Toys, SM0602 Baby, SM0603 Outdoor, SM0604 Gaming & Tech, any deeper category, or a category link) and every product found is collected.
• Stock where it matters - home delivery and click & collect stock status, stock messages, pre-order flags and expected stock dates.
• Prices - current price, was-price, then-price, RRP and discount percentage, in GBP.
• Product page details - description (HTML and plain text), key features, safety warnings, brand, EAN, the full image gallery and videos, the category path and the review count; a bundle lists the products it holds.
• Unchanged JSON - the product-inventory response Smyths' store uses, so code written against Smyths' own data keeps working. Products found by search or category also get their name, link, image and rating.
• Bundles handled - bundle products (consoles with games and the like) are recognised and read as bundles.
• Deduplicated - the same product given twice, or found by two searches, is collected once.
• Not billed for misses - a code Smyths does not know or a category that does not exist goes to the ERRORS record with the reason, free.

Use cases

• Stock monitoring - check thousands of toys twice a day and act when one comes back in stock.
• Catalogue discovery - collect every product of a department or brand, with stock, without knowing a single code.
• Price tracking - follow current, was and RRP prices across a catalogue or against other retailers.
• Product content - descriptions, features, safety warnings and images for your own catalogue, feed or comparison site.
• Pre-order and launch watch - see pre-order status and expected stock dates for new releases.

Input

Field	Type	Default	Description
products	array	-	Smyths product codes, product or bundle page links or product-inventory API links.
searchQueries	array	-	Search terms; every product each search finds is collected. Smyths' search returns its best 240 matches at most.
categories	array	-	Category codes (SM0601, SM060101, ...) or category page links; every product of each category is collected.
maxProductsPerList	integer	60	Products taken from each search term and each category (1-10000).
sort	string	Smyths' default	Order products are taken from searches and categories in: bestsellers, price_asc, price_desc, rating_desc or newest.
includeStock	boolean	true	Check live stock for products found by searches and categories. Off: save them as listed (code, name, link, price, image, rating, bundle flag), faster.
includeDetails	boolean	false	Add what each product's page shows: brand, EAN, description, key features, safety warnings, images, videos, category path, review count and bundle contents. One more request per product; $0.50 per 1000 products more.
concurrency	integer	5	Products fetched at the same time (1-10).

With no input at all the actor reads the example product 156809.

Example input

{
  "products": [
    "156809",
    "https://www.smythstoys.com/uk/en-gb/brand/graco/graco-extend-lx-r129-car-seat-midnight/p/227867"
  ],
  "searchQueries": ["lego star wars"],
  "categories": ["https://www.smythstoys.com/uk/en-gb/toys/lego-and-bricks/adult-lego/c/adult-lego"],
  "maxProductsPerList": 100,
  "includeDetails": true
}

To collect a whole department, list its category with a high limit, for example {"categories": ["SM0602"], "maxProductsPerList": 1000} for every Baby product.

Output

One dataset item per product (some fields shortened):

{
  "code": "156809",
  "type": "REGULAR",
  "ageSuitabilities": ["5 Years +"],
  "hdSection": {
    "stockStatus": "INSTOCK",
    "stockMessage": "In Stock",
    "guestDeliveryMessage": "Free delivery on orders over £20",
    "isAvailableForDelivery": true,
    "isPreOrder": false,
    "expectedStockDate": null
  },
  "ccSection": {
    "stockStatus": "INSTOCK",
    "stockMessage": "In Stock",
    "deliveryMessage": "FREE collection within 2 hours",
    "isPreOrder": false,
    "expectedStockDate": null
  },
  "carrierType": {"name": "REGULAR"},
  "prices": {
    "price": "£9.99",
    "value": "9.99",
    "wasPrice": null,
    "thenPrice": null,
    "rrpPrice": null,
    "discountedPercentage": null
  },
  "name": "Marvel Avengers Thor Battle Hammer",
  "url": "https://www.smythstoys.com/uk/en-gb/toys/fashion-and-dolls/kids-costumes-dress-up-and-face-paint/character-and-super-hero-and-dress-up/marvel-avengers-thor-battle-hammer/p/156809",
  "image": "https://image.smythstoys.com/picture/desktop/156809",
  "averageRating": 5,
  "source": "search",
  "input": "thor hammer"
}

source says how the product was given or found (product, search or category) and input is the code, link, search term or category it came from. name, url, image and averageRating come with products found by searches and categories (and with a code you give that a search or category also lists); Smyths' stock JSON for a bare code does not carry them. With includeStock off, a found product is saved as listed: code, name, url, prices, currency, image, averageRating, productType (BUNDLE for bundles) and decals.

With includeDetails on, each product also gets (shortened):

{
  "brand": "Skateboards & Accessories",
  "ean": "0840148210097",
  "description": "<p>Dare to be different with 858 Drift Board. ...</p>",
  "descriptionText": "Dare to be different with 858 Drift Board. ...",
  "features": ["Easy pull hand brake", "Super soft knee pads", "360° rear caster wheels", "No assembly"],
  "safetyWarnings": ["SMALL PARTS - CHOKING HAZARD. Not suitable for children under 3 years"],
  "images": [
    "https://image.smythstoys.com/original/800/desktop/225095",
    "https://image.smythstoys.com/original/800/desktop/225095_1"
  ],
  "videos": ["https://www.youtube-nocookie.com/embed/S53iNeGt1-U?rel=0"],
  "breadcrumbs": ["Outdoor", "Skateboards"],
  "numberOfReviews": 12
}

A bundle also gets bundleItems (code, name, price of each product it holds). A product whose details cannot be read goes to the ERRORS record instead and is not billed.

The Products view shows one row per product with the name, price, both stock statuses, pre-order, expected date and rating; the Product details view shows the brand, EAN, features, safety warnings, images and videos. Inputs that could not be read are listed in the ERRORS record of the run's key-value store with the reason.

Pricing

$1.50 per 1000 products, and $0.50 per 1000 more for products with page details (includeDetails), $2.00 per 1000 in all. You pay only for products delivered; codes Smyths does not know, unknown categories and failed calls are not charged. Searching and listing categories costs nothing by itself - only the products saved are billed.

Notes

• stockStatus values come from Smyths as is (for example INSTOCK, OUTOFSTOCK); stockMessage is the text the store shows.
• For a product code it does not know, Smyths answers with an error ("Sorry, there was a problem. Retry shortly."). The same answer can come during an outage on Smyths' side, so retry a code that worked before.
• Smyths' search returns at most 240 products per term; categories have no such limit.
• Data is fetched through ScrapeUnblocker, which keeps the browser sessions Smyths' bot protection requires.