# Currys Stock Checker & API: Store Stock, Pokemon & Restocks (`s_actors/currys-stock-checker`) Actor

Currys stock checker and API: exact units in stock at the 9 nearest Currys stores to any UK postcode or town, plus delivery stock, price, was price and collection date. Search, links or ids. Restock and price alerts.

- **URL**: https://apify.com/s_actors/currys-stock-checker.md
- **Developed by:** [Superior Actors](https://apify.com/s_actors) (community)
- **Categories:** E-commerce, Automation, Developer tools
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.99 / 1,000 product at a stores

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

### Currys Stock Checker & API: Store Stock, Pokemon & Restock Alerts

**See exactly how many units of a product the Currys stores near you have right now.** For every product you get the 9 stores nearest to any UK postcode or town, nearest first: **exact units in stock** (0, 2, 17, 40), store name, address, postcode, opening hours, distance and the **collection date**, plus the **delivery stock**, the live price, **was price** and saving. Search by keyword (`pokemon`, `ps5`, `iphone 17`, `dyson`), a currys.co.uk category or listing link, a **product link** or **product id**; check as many postcodes and towns as you like to cover a region.

Scheduled runs with **Only report changes** become **Currys restock alerts**: a row only when a store gets a product back, **gets a delivery (units went up)**, sells out, the price changes, or a **new product appears in your search** (a new Pokemon set, a new console bundle).

Use cases: track products & prices, get deal & restock alerts, build market datasets of Currys store stock. No login, no app: a **Currys stock checker online**, **Currys scraper** and **Currys API** that returns clean JSON, CSV or Excel.

#### What makes it different

| | |
| --- | --- |
| 🔢 **Exact units per store** | `unitsInStock` is the real count (2, 17, 40), not the site's "3+ in stock" label (kept in `stockLabel`) |
| 🏬 **9 nearest stores per place** | One call per product and place; add several postcodes or towns to cover a city or region |
| 📅 **Collection date** | When an out-of-stock item can be collected at the store (`collectionDate`, `canOrderToStore`) |
| 💷 **Price, was price, saving** | The live price, the old price and the saving, plus the delivery stock status |
| 🔔 **Restock alerts with deliveries** | `back_in_stock`, `restocked` (units went up), `out_of_stock`, `price_drop`, `new_item`, with restock history and the usual restock weekday of each store |
| ✅ **Works on the free Apify plan** | No proxy setup, no cookies to paste: the Currys session is handled for you |

#### Example

Input: product `HASBRO Monopoly Pokemon Edition Board Game` from the search `pokemon cards`, place `Manchester`. Real run, 4 Nov 2026:

| Product | Price | Store | Miles | Units | Delivery |
| --- | --- | --- | --- | --- | --- |
| HASBRO Monopoly Pokemon Edition Board Game | £22.99 (was £34.99) | Manchester Arndale | 0.3 | 0 (collect Fri 06 Nov) | In stock |
| HASBRO Monopoly Pokemon Edition Board Game | £22.99 | Manchester White City | 2.3 | 2 | In stock |
| HASBRO Monopoly Pokemon Edition Board Game | £22.99 | Stockport | 6.0 | 3 | In stock |
| HASBRO Monopoly Pokemon Edition Board Game | £22.99 | Oldham | 7.0 | 3 | In stock |

#### Input

| Field | What it does |
| --- | --- |
| **What to do** | *Search products* (keywords or listing links) or *Check products* (links or ids) |
| **Keywords or listing links** | e.g. `pokemon`, `ps5`, `iphone 17`, or a currys.co.uk category link |
| **Product links or ids** | currys.co.uk product links (`…-10306415.html`) or product ids (`10306415`) |
| **Postcodes or towns** | `M1 1AE`, `M1`, `Manchester`, `Glasgow` or `latitude, longitude` |
| **Radius**, **Stores per location** | 30 miles and the 9 nearest stores by default (Currys shows at most 9 per place) |
| **Max products per search** | Up to 600 products per keyword, in Currys' order |
| **Only in stock**, **Minimum units**, **Maximum price** | Filters: you pay only for returned rows |
| **Only report changes**, **Monitor name** | Restock and drop alerts for scheduled runs |

#### Output

| Field | Example |
| --- | --- |
| `title`, `productId`, `brand`, `ean`, `sku`, `category`, `url`, `image` | HASBRO Monopoly Pokemon Edition Board Game, 10303337, HASBRO, 5010996298546, 679063, Home & Outdoor, product page, image |
| `price`, `wasPrice`, `discount`, `currency`, `deliveryStock` | 22.99, 34.99, 12, GBP, IN_STOCK |
| `inStockAtStore`, `unitsInStock`, `stockLabel` | true, 2, 2 in stock ("3+ in stock" on the site while `unitsInStock` shows the real count) |
| `collectionDate`, `collectionDay`, `canOrderToStore` | 2026-11-06, Fri 06 Nov, true |
| `storeName`, `storeId`, `address`, `city`, `postalCode`, `openToday`, `storeUrl`, `latitude`, `longitude` | Manchester Arndale, 5214, 93 Arndale Centre, Manchester, M4 2HU, Open 09:00 to 20:00 |
| `distanceMiles`, `distanceKm`, `near`, `query`, `queryType` | 0.3, 0.6, Manchester, the search or product the row came from |
| `change`, `changes`, `previousUnits`, `previousPrice` | restocked from 2 to 12 units, price_drop from 34.99 (monitoring) |
| `restocksSeen`, `lastRestockAt`, `usualRestockDay` | 3, 2026-11-09T08:10:00Z, Friday (2 of 3) (monitoring) |

A bad product link, an unknown place, or a product Currys shows no stores for returns a row with `error` (free).

#### Pricing

Pay per event: **$0.001** per run and **$0.00249** per returned row: a product at a store ($2.49 per 1 000 rows). Apify Scale plan: 10% less on rows, Business plan and above: 20% less.

currys.co.uk is protected against bots: the Actor opens it in a real browser through a residential UK proxy (**$0.06**, "Currys session"). One session checks about 12 product-place pairs in two minutes (Currys limits how fast one IP may ask), so a small run pays one.

| Example | Cost |
| --- | --- |
| 5 Pokemon products at the 9 stores nearest to one postcode | ~$0.17 (45 rows + 1 session) |
| 1 product near 10 towns (90 stores) | ~$0.29 (90 rows + 1 session) |
| Restock alert: 5 products near 2 postcodes every hour, nothing changed | ~$0.07 per run (1 session) |

#### FAQ

**How do I check Currys stock near me?** Put your postcode or town into **Postcodes or towns** and the product into **Keywords** (or its link or id into *Check products*). Each row is one nearby store with its stock.

**Is the number of units exact?** It is the stock count Currys holds for that store (the site shows only "3+ in stock" above 3). Shelves move during the day, so a store with 1-2 units may be sold out when you arrive.

**Can I check Pokemon cards and toys at Currys?** Yes: search `pokemon`, `pokemon cards` or a console name to get every matching product with its stock at each store near you.

**How do I get Currys restock alerts?** Add the products (or a search) and your postcode, turn on **Only report changes**, save it as a task and schedule it every 30-60 minutes. Connect email, Slack or [Google Sheets](https://apify.com/s_actors/google-sheets-import-export) in Integrations.

**The Currys stock checker on the site is not working. Is this the same data?** It is the same collection-stock data the site's "check stock in store" uses, without clicking store by store.

**Where do I find the product id?** At the end of the product link (`…-10306415.html`) or in the `productId` column of any run.

#### Tips

- Rows = products × stores, so start with one or two places and **Only in stock** or **Minimum units**.
- For a watchlist, use *Check products* with product links: the same products every run, no search noise.
- To cover a region, list several towns: each place returns its 9 nearest stores and stores that repeat are returned once.
- Use a separate **Monitor name** for each scheduled task.

#### Limits

- UK stores only. Currys shows 9 stores per place, so a place far from any store may return fewer.
- Up to 30 postcodes or towns per run.
- Currys limits how fast one IP may ask for stock (about 6 calls a minute), so a big run takes a few minutes and opens extra sessions.

#### Related

- [The Entertainer Stock Checker: UK toy stock by store](https://apify.com/s_actors/the-entertainer-stock-checker)
- [Smyths Stock Checker](https://apify.com/s_actors/smyths-stock-checker)
- [IKEA Stock Checker](https://apify.com/s_actors/ikea-stock-checker)
- [GameStop Inventory Checker](https://apify.com/s_actors/gamestop-inventory-checker)
- [Best Buy Stock Checker: in-store inventory by ZIP](https://apify.com/s_actors/best-buy-stock-checker)
- [Target Scraper: store stock with units](https://apify.com/s_actors/target-scraper)
- [Walmart Restock Tracker](https://apify.com/s_actors/walmart-restock-tracker)
- [Barnes & Noble Stock Checker](https://apify.com/s_actors/barnes-noble-stock-checker)

#### For AI agents and API

```json
{
    "mode": "products",
    "products": ["https://www.currys.co.uk/products/acer-swift-air-14-14-laptop-intel-core-5-512-gb-ssd-sage-green-10306415.html", "10303337"],
    "locations": ["M1 1AE", "Leeds"],
    "maxStoresPerLocation": 9,
    "onlyInStock": true,
    "onlyChanges": true,
    "monitorName": "currys-restock"
}
```

Each row is one product at one store with `unitsInStock`, `stockLabel`, `collectionDate`, `deliveryStock`, `distanceMiles` and the store address.

# Actor input Schema

## `mode` (type: `string`):

Search: keywords or a Currys listing link, every product found with its stock at your stores. Check products: exact products by link or id (best for a back-in-stock watchlist).

## `keywords` (type: `array`):

Search mode: what to search on Currys, one per line (e.g. "pokemon", "ps5", "iphone 17", "dyson airwrap"), or a currys.co.uk category / listing link.

## `products` (type: `array`):

Check products mode: currys.co.uk product links or product ids (the number at the end of the link, e.g. 10306415), one per line.

## `locations` (type: `array`):

Where to check, one per line: a UK postcode ("M1 1AE"), its first part ("M1"), a town ("Manchester", "Glasgow") or "latitude, longitude". Currys returns the 9 stores nearest to each place; add several places to cover a region.

## `radius` (type: `integer`):

Only stores within this distance of a location are returned.

## `maxStoresPerLocation` (type: `integer`):

How many of the nearest stores to return for each postcode or town (Currys shows at most 9).

## `maxProductsPerSearch` (type: `integer`):

Search mode: how many products to take from each keyword, in Currys' order.

## `onlyInStock` (type: `boolean`):

Return only rows where the store has the product now.

## `minUnits` (type: `integer`):

Return only stores with at least this many units. Empty = any.

## `maxPrice` (type: `integer`):

Return only products at or below this price. Empty = any price.

## `onlyChanges` (type: `boolean`):

For scheduled runs. The first run saves units and prices; later runs return only what changed: back in stock at a store, restocked (units went up: a delivery), sold out, price changes, and new products or stores in your searches. Each row also carries the restocks this monitor has seen and the usual restock weekday. You pay only for the changes returned.

## `monitorName` (type: `string`):

Separate monitors keep separate memory. Use a different name for each scheduled task.

## `maxConcurrency` (type: `integer`):

Most you may open at once: each session checks about 12 product-place pairs in two minutes (Currys limits calls per IP). Only large runs open more than one.

## Actor input object example

```json
{
  "mode": "search",
  "keywords": [
    "pokemon"
  ],
  "products": [
    "https://www.currys.co.uk/products/acer-swift-air-14-14-laptop-intel-core-5-512-gb-ssd-sage-green-10306415.html"
  ],
  "locations": [
    "Manchester"
  ],
  "radius": 30,
  "maxStoresPerLocation": 9,
  "maxProductsPerSearch": 5,
  "onlyInStock": false,
  "onlyChanges": false,
  "monitorName": "default",
  "maxConcurrency": 3
}
```

# Actor output Schema

## `overview` (type: `string`):

One row per product and store: store stock, units, delivery stock, distance.

## `changes` (type: `string`):

Monitoring: back in stock, restocked, sold out, price changes, new products and stores.

## `details` (type: `string`):

Id, EAN, brand, price, was price, saving and delivery stock.

## `stores` (type: `string`):

Store address, postcode, opening hours, collection date and distance for each row.

## `all` (type: `string`):

Every field of every row.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "keywords": [
        "pokemon"
    ],
    "products": [
        "https://www.currys.co.uk/products/acer-swift-air-14-14-laptop-intel-core-5-512-gb-ssd-sage-green-10306415.html"
    ],
    "locations": [
        "Manchester"
    ],
    "maxProductsPerSearch": 5
};

// Run the Actor and wait for it to finish
const run = await client.actor("s_actors/currys-stock-checker").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "keywords": ["pokemon"],
    "products": ["https://www.currys.co.uk/products/acer-swift-air-14-14-laptop-intel-core-5-512-gb-ssd-sage-green-10306415.html"],
    "locations": ["Manchester"],
    "maxProductsPerSearch": 5,
}

# Run the Actor and wait for it to finish
run = client.actor("s_actors/currys-stock-checker").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "keywords": [
    "pokemon"
  ],
  "products": [
    "https://www.currys.co.uk/products/acer-swift-air-14-14-laptop-intel-core-5-512-gb-ssd-sage-green-10306415.html"
  ],
  "locations": [
    "Manchester"
  ],
  "maxProductsPerSearch": 5
}' |
apify call s_actors/currys-stock-checker --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,s_actors/currys-stock-checker"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/LNUUGdXKnkChIcKeG/builds/wWWLQ9HQcFVyzvyiN/openapi.json
