# The Entertainer Stock Checker & API: Store Stock & Restocks (`s_actors/the-entertainer-stock-checker`) Actor

The Entertainer stock checker and toy scraper: how many units are in stock at each The Entertainer store near a UK postcode or town, with price, was-price, store address and hours. Search by keyword, link or code. Scheduled runs = restock and price-drop alerts.

- **URL**: https://apify.com/s_actors/the-entertainer-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

### The Entertainer Stock Checker & API: Store Stock & Restocks

**See how many units of a toy The Entertainer stores near you have right now.** For any UK postcode or town you get the nearest The Entertainer stores, nearest first, and for every product at every store the **exact units in stock**, the stock status (in stock, low stock, out of stock), the live **price**, was price and saving, the store address, postcode, opening hours, coordinates and distance. Search by keyword (`pokemon cards`, `lego`, `barbie`, `paw patrol`) or by **product link / code**; check as many postcodes and towns as you like to cover a region.

Scheduled runs with **Only report changes** become **The Entertainer restock alerts**: a row only when a store gets a product back, **sells out**, **restocks** (more units than last time), the price changes, or a **new product appears in your search**.

Use cases: find a store that has a hard-to-find Pokemon set or LEGO box, restock alerts for collectables, price and deal tracking, market datasets of toy store stock. No login, no app: a **The Entertainer stock checker online**, **The Entertainer scraper** and **The Entertainer API** that returns clean JSON, CSV or Excel.

#### What makes it different

| | |
| --- | --- |
| 🔢 **Exact units per store** | Not just "in stock": the number of units each store holds (e.g. 7 in Nottingham, 2 in Bexleyheath) |
| 🏬 **Stock at every store near you** | One row per product and store, nearest first: add several postcodes or towns to cover a city or region |
| 🔎 **Search or watchlist** | Search any keyword (up to 1 000 products per keyword) or check exact products by link or code |
| 🕒 **Store details** | Address, postcode, coordinates, map link and opening hours in every row |
| 💷 **Price, was price, saving** | Live price, old price and the saving in pounds, plus rating and reviews |
| 🔔 **Restock alerts** | `back_in_stock`, `out_of_stock`, `restocked`, `price_drop`, `price_increase`, `new_item` |
| ✅ **Works on the free Apify plan** | No proxy setup, no cookies to paste |

#### Example

Input: product `586590` (Pokemon Poke Ball card binder), place `Nottingham`, 5 stores. Real data, 7 Nov 2026:

| Product | Price | Store | Miles | Stock | Units |
| --- | --- | --- | --- | --- | --- |
| Pokemon Poke Ball Collectible Card Binder 9 Pocket | £12.00 | Nottingham | 0.4 | low_stock | 7 |
| Pokemon Poke Ball Collectible Card Binder 9 Pocket | £12.00 | Leicester | 21.9 | low_stock | 8 |
| Pokemon Poke Ball Collectible Card Binder 9 Pocket | £12.00 | Chesterfield | 22.5 | low_stock | 5 |

#### Input

| Field | What it does |
| --- | --- |
| **What to do** | *Search products* (keywords) or *Check products* (links or codes) |
| **Keywords** | e.g. `pokemon cards`, `lego`, `barbie` |
| **Product links or codes** | thetoyshop.com product links (`…/p/586590`) or product codes |
| **Postcodes or towns** | `SW1A 1AA`, `Manchester`, `Leeds`, or `53.48, -2.24` |
| **Store names** | exact stores: `Nottingham`, `Leeds-Trinity`, `Glasgow-Silverburn` |
| **Radius**, **Stores per place** | 20 miles and the 5 nearest stores by default (up to 60) |
| **Max products per search** | up to 1 000 products per keyword |
| **Only in stock**, **Maximum price** | Filters: you pay only for returned rows |
| **Include online-only products** | products sold only online are in no store; skipped unless you ask |
| **Only report changes**, **Monitor name** | Restock and drop alerts for scheduled runs |

#### Output

| Field | Example |
| --- | --- |
| `title`, `productCode`, `brand`, `category`, `url`, `image` | Pokemon Poke Ball Collectible Card Binder…, 586590, Pokemon, Trading Cards, product page, image |
| `price`, `wasPrice`, `savingGbp` | 12.0, 15.0, 3.0 |
| `rating`, `reviews`, `ageRange` | 4.5, 12, 13 - 16 years |
| `stockStatus`, `stockUnits`, `inStockAtStore` | in_stock / low_stock / out_of_stock / online_only, 7, true |
| `clickCollect`, `homeDelivery`, `deliveryOptions`, `storesWithStock` | true, true, Click & Collect / Express Delivery, 91 |
| `storeId`, `storeName`, `storeAddress`, `storePostcode`, `storeTown` | Nottingham, Nottingham, Unit 302B, Victoria Centre, NG1 3QN |
| `openingHours`, `storeLatitude`, `storeLongitude`, `storeMapUrl` | Mon-Sun hours, 52.958, -1.148, map link |
| `distanceMiles`, `near`, `query`, `queryType` | 0.4, Nottingham, the search or product the row came from |
| `change`, `changes`, `previousPrice`, `previousUnits` | restocked, price_drop from 15.0 (monitoring) |

A store that does not have the product gets a row with `out_of_stock` and `stockUnits` 0. A bad product link, an unknown place or a search with no products 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.

| Example | Cost |
| --- | --- |
| 10 Pokemon products near one postcode (5 stores, 50 rows) | ~$0.13 |
| 3 keywords × 100 products near two cities, 10 stores (about 3 000 rows) | ~$7.5 |
| Restock alert: 20 products near 2 postcodes every hour, nothing changed | $0.001 per run |

#### FAQ

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

**Does it show how many units?** Yes: `stockUnits` is the number the store reports. `low_stock` is the shop's own "low stock" flag (a handful left): call the store before a long trip.

**Does The Entertainer restock Pokemon cards?** Stock changes by store and day. Schedule a task with **Only report changes** for your postcode and you get a row the moment a store gets Pokemon products back (`back_in_stock`) or more units arrive (`restocked`).

**Why are some products missing?** Products sold online only are in no store and are skipped. Turn on **Include online-only products** to get them as rows.

**How do I get 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.

**Where do I find the product code?** At the end of the product link (`…/p/586590`) or in the `productCode` column of any run.

#### Tips

- Rows = products × stores, so start with one or two places and **Only in stock**.
- For a watchlist, use *Check products* with product links: the same products every run, no search noise.
- Use a separate **Monitor name** for each scheduled task.

#### Limits

- The Entertainer UK stores (about 150 including Northern Ireland and the Channel Islands), as listed on thetoyshop.com.
- Up to 30 places and stores per run, up to 60 stores in total.
- The shop slows down an IP that asks too fast: the Actor keeps a gentle pace and switches IP by itself, so very large runs take a few minutes.

#### Related

- [Smyths Stock Checker](https://apify.com/s_actors/smyths-stock-checker)
- [Currys Stock Checker](https://apify.com/s_actors/currys-stock-checker)
- [IKEA Stock Checker](https://apify.com/s_actors/ikea-stock-checker)
- [Big W Stock Checker](https://apify.com/s_actors/bigw-stock-checker)

#### For AI agents and API

```json
{
    "mode": "products",
    "products": ["https://www.thetoyshop.com/pocket-money/trading-cards/Pokemon-Poke-Ball-Collectible-Card-Binder-9-Pocket/p/586590", "577941_SQUIRT"],
    "places": ["SW1A 1AA", "Leeds"],
    "maxStoresPerPlace": 5,
    "onlyChanges": true,
    "monitorName": "toys-restock"
}
```

Each row is one product at one store with `stockStatus`, `stockUnits`, `inStockAtStore`, `distanceMiles` and the store name and location.

# Actor input Schema

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

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

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

Search mode: what to search on The Entertainer, one per line (e.g. "pokemon", "lego", "barbie", "paw patrol").

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

Check products mode: thetoyshop.com product links (…/p/586590) or product codes (586590), one per line.

## `places` (type: `array`):

UK postcodes, towns or "latitude, longitude" to check stores around, one per line: the nearest stores within "Radius" (up to "Stores per place"). A town that is a store name also works (e.g. Leicester).

## `storeIds` (type: `array`):

Exact stores, one per line: the store name (e.g. Nottingham, Leeds-Trinity, Glasgow-Silverburn). A word lists all stores with it in the name.

## `radiusMiles` (type: `integer`):

How far from each place to look for stores.

## `maxStoresPerPlace` (type: `integer`):

For each postcode or town: how many of the nearest stores to check.

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

Search mode: how many products to take from each keyword (the shop returns up to 1 000).

## `includeOnlineOnly` (type: `boolean`):

Some products are sold online only and are in no store. They are skipped. Turn on to get them as rows too (stock status "online_only").

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

Return only rows where the store has the product now.

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

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

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

For scheduled runs. The first run saves stock and prices; later runs return only what changed: back in stock at a store, sold out, more units (restock), price drops and increases, and new products or stores in your searches. 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`):

How many requests run at the same time. The shop drops connections when several share one IP, so 1 is the safe default.

## Actor input object example

```json
{
  "mode": "search",
  "keywords": [
    "pokemon"
  ],
  "products": [
    "https://www.thetoyshop.com/pocket-money/trading-cards/Pokemon-Poke-Ball-Collectible-Card-Binder-9-Pocket/p/586590"
  ],
  "places": [
    "SW1A 1AA"
  ],
  "radiusMiles": 20,
  "maxStoresPerPlace": 5,
  "maxProductsPerSearch": 10,
  "includeOnlineOnly": false,
  "onlyInStock": false,
  "onlyChanges": false,
  "monitorName": "default",
  "maxConcurrency": 1
}
```

# Actor output Schema

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

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

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

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

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

Code, brand, category, prices, rating, age range and delivery options.

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

Store name, address, postcode, coordinates, hours 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.thetoyshop.com/pocket-money/trading-cards/Pokemon-Poke-Ball-Collectible-Card-Binder-9-Pocket/p/586590"
    ],
    "places": [
        "SW1A 1AA"
    ],
    "maxProductsPerSearch": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("s_actors/the-entertainer-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.thetoyshop.com/pocket-money/trading-cards/Pokemon-Poke-Ball-Collectible-Card-Binder-9-Pocket/p/586590"],
    "places": ["SW1A 1AA"],
    "maxProductsPerSearch": 10,
}

# Run the Actor and wait for it to finish
run = client.actor("s_actors/the-entertainer-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.thetoyshop.com/pocket-money/trading-cards/Pokemon-Poke-Ball-Collectible-Card-Binder-9-Pocket/p/586590"
  ],
  "places": [
    "SW1A 1AA"
  ],
  "maxProductsPerSearch": 10
}' |
apify call s_actors/the-entertainer-stock-checker --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,s_actors/the-entertainer-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/5z1MTdZ8iD4VcqosB/builds/4VksbtoWxrbxMMZXk/openapi.json
