currys.co.uk APIcurrys.co.uk ↗
Access Currys.co.uk product data via API. Search electronics, get pricing, stock availability, full technical specs, and promotional offers across all categories.
curl -X GET 'https://api.parse.bot/scraper/8d2033de-f0a2-40c7-a815-1925c4b445eb/list_mobile_phones?limit=5&start=0' \ -H 'X-API-Key: $PARSE_API_KEY'
List products available in the mobile phones category on Currys.co.uk. Returns paginated results with full product data including pricing, availability, and offers.
| Param | Type | Description |
|---|---|---|
| limit | integer | Number of products to return per page. |
| start | integer | The starting index (offset) for pagination. |
{
"type": "object",
"fields": {
"limit": "integer - number of products requested per page",
"start": "integer - current pagination offset",
"products": "array of product objects with id, name, brand, price, availability, payment options, offers, and URLs",
"total_items": "integer - total number of products matching"
},
"sample": {
"data": {
"limit": 5,
"start": 0,
"products": [
{
"id": "10289330",
"url": "https://www.currys.co.uk/products/google-pixel-10-pro-128-gb-moonstone-10289330.html",
"name": "GOOGLE Pixel 10 Pro - 128 GB, Moonstone",
"brand": "GOOGLE",
"price": [
{
"revenue": 799,
"currency": "GBP",
"baseRevenue": 999
}
],
"image_url": "https://media.currys.biz/i/currysprod/M10289328_silver-grey?$g-small$&fmt=auto",
"availability": [
{
"stockStatus": "IN_STOCK",
"availabilityStatus": "shipping"
}
]
}
],
"total_items": 20
},
"status": "success"
}
}About the currys.co.uk API
The Currys.co.uk API provides 4 endpoints for retrieving product listings, search results, and detailed specifications from one of the UK's largest electronics retailers. Use search_products to query across all categories by keyword, get_product_details to retrieve grouped technical specifications and promotions for a specific product ID, or list_mobile_phones to paginate through the full mobile handset catalogue with pricing and availability data.
Endpoints and Data Coverage
The API exposes four endpoints. list_mobile_phones and search_products both return paginated arrays of product objects controlled by limit and start parameters. Each product object includes an id, name, brand, price data, payment options, availability status, active offers, and product URLs. total_items in every response tells you the full result count so you can calculate how many pages remain. search_products accepts a required query string — terms like samsung, iphone, or laptop — and spans all product categories, not just mobile phones.
Product Detail and Specifications
get_product_details takes a required product_id (for example, 10290129) and optionally a direct url to skip the search step. It returns the same price and availability fields as the list endpoints, plus a full_specifications object grouped by category headings such as OVERVIEW, CAMERA, and SCREEN, and a promotions array of current promotional text strings. This makes it the right endpoint when you need the full spec sheet rather than summary data.
list_mini_pc_products Behaviour
list_mini_pc_products accepts an optional query string and a max_pages integer (set to 0 to fetch all pages, 20 products per page). It returns a products array with product_id, name, url, price, savings, specs, and image_url fields, plus total_items and products_returned counts. Note the endpoint documentation flags that some specific product-name queries may be redirected to category pages that return errors; using general search terms produces the most reliable results.
Source and Freshness
All data reflects the current state of Currys.co.uk listings for the UK market. Pricing includes baseRevenue, revenue, tax, and currency fields, which allows you to distinguish the pre-tax and post-tax amounts. Stock status comes through the availability array, which includes shipping information alongside stock status strings.
- Track UK retail prices for specific phone models using
get_product_detailsand thepricearray fields. - Monitor stock availability changes for electronics by polling
search_productswith a product name and inspecting theavailabilityfield. - Build a UK electronics price comparison tool using
search_productsacross multiple keyword queries. - Extract full technical specification sheets for laptops or phones via
get_product_detailsand thefull_specificationsobject. - Aggregate current promotional offers across the mobile phone catalogue using
list_mobile_phonesand theoffersfield. - Build a product database seeded from the Currys catalogue by paginating
list_mini_pc_productswithmax_pagesset to0. - Identify savings on electronics by reading the
savingsfield returned bylist_mini_pc_products.
| 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 Currys have an official public developer API?+
What does the `get_product_details` endpoint return beyond what the list endpoints provide?+
get_product_details adds a full_specifications object with specs grouped by category headings (e.g. OVERVIEW, CAMERA, SCREEN) and a promotions array of active promotional text strings. The list endpoints return summary price and availability data but do not include grouped technical specifications.Are customer reviews or ratings included in the product responses?+
Does the API cover Currys product categories beyond mobile phones and mini PCs?+
search_products spans all product categories on the site when given a relevant keyword, so you can retrieve data for laptops, TVs, audio equipment, and other electronics. Dedicated category-browse endpoints currently exist only for mobile phones. You can fork the API on Parse and revise it to add list endpoints for specific categories like televisions or laptops.Are there any query types that produce unreliable results with `list_mini_pc_products`?+
laptop or headphones returns reliable results. If you need to look up a specific model, search_products or get_product_details with a known product ID are more dependable options.