# Boots Stock Checker & API: Store Stock & Restock Alerts (`s_actors/boots-stock-checker`) Actor

Boots stock checker and API: which Boots stores near any UK postcode or town have a product in stock, for the 10 nearest stores: status, address, phone, opening hours, distance, price. Search, links or numbers. Restock alerts.

- **URL**: https://apify.com/s_actors/boots-stock-checker.md
- **Developed by:** [Superior Actors](https://apify.com/s_actors) (community)
- **Categories:** E-commerce, Automation, Developer tools
- **Features:** Limited permissions
- **Stats:** 1 total users, 1 monthly users, 93.9% 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

### Boots Stock Checker & API: Store Stock & Restock Alerts

**See which Boots stores near you have a product in stock right now.** For every product you get the nearest Boots stores that have it, for any UK postcode or town, nearest first: the **stock status**, store name, address, postcode, **phone**, **opening hours** (and pharmacy hours), distance, plus the live price, was price, offer and rating. Search by keyword (`pokemon`, `vitamin d`, `no7 serum`, `ozempic`), by **product link** or **product number**; check as many postcodes and towns as you like to cover a region.

Scheduled runs with **Only report changes** become **Boots restock alerts**: a row only when a store gets a product back, **sells out**, the price changes, or a **new product appears in your search** (a new Pokemon set, a new Christmas range).

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

#### What makes it different

| | |
| --- | --- |
| 🏬 **Stores that have it, near any place** | One call per product and place returns the nearest Boots stores with the product; add several postcodes or towns to cover a city or region |
| 🔭 **Search further away** | When nothing is in stock nearby, ask Boots for stores further away (the "Search stores further away" link), up to 3 times |
| 📞 **Phone and hours** | Store phone, today's hours, the whole week and pharmacy hours in every row |
| 💷 **Price, was price, offer** | The live price, the old price, price per unit and the promotion (for example "3 for 2") |
| 🔔 **Restock alerts** | `back_in_stock`, `out_of_stock` (the store no longer has it), `price_drop`, `new_item` |
| ✅ **Works on the free Apify plan** | No proxy setup, no cookies to paste: the Boots session is handled for you |

#### Example

Input: product `Pokemon Lip Balm Collection` (number `10385121`), place `Manchester`. Real run, 4 Nov 2026:

| Product | Price | Store | Miles | Stock | Open today |
| --- | --- | --- | --- | --- | --- |
| Pokemon Lip Balm Collection | £8.00 | Manchester Market Street | 0.29 | In Stock | 08:00-20:00 |
| Pokemon Lip Balm Collection | £8.00 | Manchester The Trafford Centre | 4.36 | In Stock | 10:00-22:00 |
| Pokemon Lip Balm Collection | £8.00 | Stockport Merseyway | 5.89 | In Stock | 09:00-17:30 |
| Pokemon Lip Balm Collection | £8.00 | Oldham Town Square Shopping Centre | 6.94 | In Stock | 09:00-17:30 |

#### Input

| Field | What it does |
| --- | --- |
| **What to do** | *Search products* (keywords) or *Check products* (links or numbers) |
| **Keywords** | e.g. `pokemon`, `vitamin d`, `no7 serum` |
| **Product links or numbers** | boots.com product links (`…-10292903`) or product numbers (`10292903`) |
| **Postcodes or towns** | `M1 1AE`, `Manchester`, `Glasgow` |
| **Radius**, **Stores per location** | 30 miles and the 10 nearest stores by default (Boots shows at most 10 per place) |
| **Search further away** | 0-3 extra rounds when no store nearby has the product |
| **Max products per search** | Up to 600 products per keyword |
| **Only in stock**, **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`, `category`, `url`, `image` | Pokemon Lip Balm Collection, 10385121, Pokemon, toiletries > skincare, product page, image |
| `price`, `wasPrice`, `pricePerUnit`, `currency`, `offer` | 8.0, null, null, GBP, 3 for 2 on selected Christmas Mix and Match |
| `rating`, `reviewCount`, `inStockOnline` | 4.65, 97, true |
| `inStockAtStore`, `stockLabel` | true, In Stock |
| `storeName`, `address`, `city`, `postalCode`, `phone`, `latitude`, `longitude` | Manchester Market Street, 32 Market St, Manchester, M1 1PL, 01618326533 |
| `openToday`, `openingHours`, `pharmacyToday`, `pharmacyHours` | 08:00-20:00, Mon 08:00-20:00; ... |
| `distanceMiles`, `distanceKm`, `near`, `query`, `queryType` | 0.29, 0.5, Manchester, the search or product the row came from |
| `change`, `changes`, `previousPrice` | back_in_stock, price_drop from 9.0 (monitoring) |

Boots shows a stock status ("In Stock") for each store, not a unit count. A bad product link, an unknown place, or a product that no store near the place has 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.

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

| Example | Cost |
| --- | --- |
| 5 Pokemon products near one postcode (up to 10 stores each) | ~$0.18 (about 50 rows + 1 session) |
| 1 product near 10 towns (up to 100 stores) | ~$0.30 (100 rows + 1 session) |
| Restock alert: 5 products near 2 postcodes every hour, nothing changed | ~$0.05 per run (1 session) |

#### FAQ

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

**Does it show how many units?** No: Boots shows only a status ("In Stock") per store. Shelves move during the day, so call the store (the phone is in every row) before a long trip for the last item.

**A store is missing from the results.** Boots lists only the stores that have the product. If none of the nearest stores has it, the Actor returns an `error` row; turn on **Search further away** to look at more stores.

**Can I check Pokemon cards, toys and gifts at Boots?** Yes: search `pokemon` or any product name to get every matching product with the stores that have it.

**How do I get Boots 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 Boots stock checker on the site is not working. Is this the same data?** It is the same "check stock in store" data the product page uses, without clicking store by store.

**Where do I find the product number?** At the end of the product link (`…-10292903`) or in the `productId` 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.
- To cover a region, list several towns: each place returns its 10 nearest stores and stores that repeat are returned once per place.
- Use a separate **Monitor name** for each scheduled task.

#### Limits

- UK stores only. Boots shows up to 10 stores per place.
- Up to 30 postcodes or towns per run.
- Boots 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

- [Smyths Stock Checker](https://apify.com/s_actors/smyths-stock-checker)
- [Big W Stock Checker](https://apify.com/s_actors/bigw-stock-checker)
- [Barnes & Noble Stock Checker](https://apify.com/s_actors/barnes-noble-stock-checker)
- [IKEA Stock Checker](https://apify.com/s_actors/ikea-stock-checker)
- [Walgreens Stock Checker](https://apify.com/s_actors/walgreens-stock-checker)

#### For AI agents and API

```json
{
    "mode": "products",
    "products": ["https://www.boots.com/boots-high-strength-vitamin-d-25-ug-food-supplement-90-tablets-10292903", "10385121"],
    "locations": ["M1 1AE", "Leeds"],
    "maxStoresPerLocation": 10,
    "onlyChanges": true,
    "monitorName": "boots-restock"
}
```

Each row is one product at one store with `stockLabel`, `inStockAtStore`, `distanceMiles`, the store address, phone and opening hours.

# Actor input Schema

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

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

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

Search mode: what to search on Boots, one per line (e.g. "pokemon", "no7 serum", "vitamin d").

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

Check products mode: boots.com product links or product numbers (the number at the end of the link, e.g. 10292903), one per line.

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

Where to check, one per line: a UK postcode ("M1 1AE") or a town / city ("Manchester", "Glasgow"). Boots returns the 10 stores nearest to each place that have the product; 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 (Boots shows at most 10).

## `searchFurther` (type: `integer`):

When no store near a place has the product, ask Boots for stores further away, this many times (like the "Search stores further away" link). 0 = only the nearest area.

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

Search mode: how many products to take from each keyword, in the order Boots shows them.

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

Return only rows where the store has the product now.

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

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

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

For scheduled runs. The first run saves the stock and prices; later runs return only what changed: back in stock at a store, sold out (the store no longer has it), price changes, 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`):

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

## Actor input object example

```json
{
  "mode": "search",
  "keywords": [
    "pokemon"
  ],
  "products": [
    "https://www.boots.com/boots-high-strength-vitamin-d-25-ug-food-supplement-90-tablets-10292903"
  ],
  "locations": [
    "Manchester"
  ],
  "radius": 30,
  "maxStoresPerLocation": 10,
  "searchFurther": 0,
  "maxProductsPerSearch": 5,
  "onlyInStock": false,
  "onlyChanges": false,
  "monitorName": "default",
  "maxConcurrency": 3
}
```

# Actor output Schema

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

One row per product and store: store stock, store, distance, opening hours, price.

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

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

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

Number, brand, price, was price, offer, rating and online stock.

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

Store address, postcode, phone, opening hours, pharmacy 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.boots.com/boots-high-strength-vitamin-d-25-ug-food-supplement-90-tablets-10292903"
    ],
    "locations": [
        "Manchester"
    ],
    "maxProductsPerSearch": 5
};

// Run the Actor and wait for it to finish
const run = await client.actor("s_actors/boots-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.boots.com/boots-high-strength-vitamin-d-25-ug-food-supplement-90-tablets-10292903"],
    "locations": ["Manchester"],
    "maxProductsPerSearch": 5,
}

# Run the Actor and wait for it to finish
run = client.actor("s_actors/boots-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.boots.com/boots-high-strength-vitamin-d-25-ug-food-supplement-90-tablets-10292903"
  ],
  "locations": [
    "Manchester"
  ],
  "maxProductsPerSearch": 5
}' |
apify call s_actors/boots-stock-checker --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,s_actors/boots-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/59nJaMQOXXYgloBt4/builds/0uvGzOff2uByyEfc2/openapi.json
