smythstoys.com APIsmythstoys.com ↗
Access the Smyths Toys product catalog via API. Search products by keyword and retrieve pricing, stock, and specs across UK, Ireland, Germany, and Netherlands.
curl -X GET 'https://api.parse.bot/scraper/14f94093-2f34-4248-a287-e5c61542fced/search_products' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products by keyword query across different locales.
| Param | Type | Description |
|---|---|---|
| page | integer | Current page number |
| queryrequired | string | Search keyword |
| locale | string | Region/Locale (uk, ie, de, nl) |
| page_size | integer | Number of results per page |
{
"type": "object",
"fields": {
"products": "array"
},
"sample": {
"products": [
{
"code": "123456",
"name": "LEGO Star Wars Millennium Falcon",
"price": {
"value": 149.99
}
}
]
}
}About the smythstoys.com API
The Smyths Toys API provides 2 endpoints for querying the Smyths Toys product catalog across four regional locales: UK, Ireland, Germany, and the Netherlands. The search_products endpoint accepts a keyword query and returns a paginated array of matching products, while get_product_details returns structured data including name, price, and stock status for a specific product by its SKU code.
Search Products
The search_products endpoint accepts a required query string and optional parameters for locale (uk, ie, de, nl), page, and page_size. This lets you paginate through result sets and scope searches to a specific regional market. The response is an array of products, making it suitable for building catalog browsers, comparison tools, or monitoring keyword-based product availability across regions.
Product Details
The get_product_details endpoint takes a required product_code (the Smyths SKU, e.g. 123456) and an optional locale parameter. The response includes a name string, a price object reflecting the regional pricing, and a stock object indicating availability. Running the same product_code against different locales lets you compare pricing and stock status across the UK, Irish, German, and Dutch storefronts for the same item.
Regional Coverage
Both endpoints support the same four locales: uk, ie, de, and nl. Locale selection affects both the currency and stock data returned — the UK and Ireland return GBP and EUR pricing respectively, while Germany and the Netherlands return Euro-denominated results. If no locale is specified, the endpoint falls back to a default region.
- Track price differences for the same toy SKU across UK, Irish, German, and Dutch storefronts using
get_product_detailswith different locale values. - Monitor stock availability for specific product codes ahead of peak shopping seasons like Christmas.
- Build a toy search interface that surfaces Smyths Toys results by keyword and locale for a regional audience.
- Alert users when a previously out-of-stock product (from the
stockobject) becomes available in their preferred locale. - Aggregate and compare product names and prices across European markets for competitive pricing analysis.
- Feed a product catalog database by paginating through
search_productsresults using thepageandpage_sizeparameters. - Validate that a list of product codes from internal systems returns valid entries on Smyths Toys across all supported regions.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Smyths Toys have an official developer API?+
What does the `get_product_details` endpoint return beyond price?+
price object (regional pricing), the response includes a name string and a stock object indicating availability for the given locale. The level of detail in the price and stock objects — such as sale prices, click-and-collect availability, or store-level stock — depends on what the product record exposes.Does the API cover customer reviews or product ratings for Smyths Toys items?+
get_product_details, and keyword-based product search via search_products. Reviews and ratings are not part of the current response shape. You can fork this API on Parse and revise it to add an endpoint targeting review data for a specific product.Are there any limitations on which locales are supported?+
uk (United Kingdom), ie (Ireland), de (Germany), and nl (Netherlands). Other countries where Smyths Toys operates — such as Austria or Switzerland — are not currently included. You can fork this API on Parse and revise it to add support for additional locale values if Smyths Toys expands their storefront coverage.How does pagination work in `search_products`?+
search_products endpoint accepts integer page and page_size parameters. Increment page while keeping page_size consistent to walk through result sets. If neither parameter is supplied, the endpoint returns a default page of results.