# Costco Stock Checker & API: Warehouse Inventory & Prices (`s_actors/costco-scraper`) Actor

Costco stock checker and API: in stock, low stock or out of stock at every Costco warehouse near a ZIP or postal code (US and Canada), with the warehouse price, online price and online stock. Search, item numbers, Pokemon restock and price drop alerts.

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

## Pricing

from $1.43 / 1,000 product at a warehouses

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

### Costco Stock Checker & API: Warehouse Inventory, Prices & Restock Alerts

**See which Costco warehouses near you have a product right now, and at what price.** For every product you get the nearby Costco warehouses, nearest first: **in stock, low stock or out of stock** at the warehouse, the **warehouse price** (often lower than costco.com), the **online price** and **online stock**, warehouse name, address, phone, member hours, services (gas, pharmacy, tire center) and distance. Search by keyword (`pokemon`, `lego`, `kirkland olive oil`, `tv`), costco.com / costco.ca product link or **item number** from the shelf tag or receipt; check warehouses by **ZIP code**, **Canadian postal code**, **city**, or by **warehouse number or name**.

Scheduled runs with **Only report changes** become **Costco restock and price drop alerts**: a row only when a warehouse gets a product back, goes from low stock to in stock, runs low, sells out, the **warehouse price drops** (handy for Costco's price adjustment within 30 days) or a **new product appears in your search**.

Use cases: track products & prices, get deal & restock alerts, compare warehouse prices across a region, build market datasets of Costco warehouse inventory. No login, no membership, no app: a **Costco inventory checker online**, **Costco warehouse inventory search** and **Costco API** that returns clean JSON, CSV or Excel.

#### What makes it different

| | |
| --- | --- |
| 🏬 **Warehouse stock, not just online** | `stockStatus` per warehouse: In stock / Low stock / Out of stock, for many warehouses at once instead of picking them one by one on costco.com |
| 💲 **Warehouse and online prices** | `warehousePrice` of each warehouse next to `onlinePrice`: the Pokémon dog toys below are $16.99 in the warehouse and $25.99 online |
| 🗺️ **Every warehouse near you** | The nearest warehouses to each ZIP code, postal code or city, or exact warehouses by number |
| 🇺🇸 🇨🇦 **US and Canada** | costco.com and costco.ca, about 750 warehouses |
| 🔔 **Restock and price alerts** | `back_in_stock`, `restocked`, `low_stock`, `out_of_stock`, `price_drop`, `new_item`, with restock history and the usual restock weekday of each warehouse |
| ✅ **Works on the free Apify plan** | No proxy setup, no cookies, no Costco account |

#### Example

Input: *Check products* with item numbers `1958890`, `1511996`, `1872109`, ZIP `95050` (Santa Clara, CA), 4 nearest warehouses. Real run, 26 Oct 2026:

| Product | Warehouse price | Online price | Warehouse | Miles | Warehouse stock |
| --- | --- | --- | --- | --- | --- |
| Nintendo Switch 2 + NSO + Memory Card Bundle | $569.99 | $569.99 | Santa Clara | 0.9 | Out of stock |
| Nintendo Switch 2 + NSO + Memory Card Bundle | $569.99 | $569.99 | Sunnyvale | 2.8 | Out of stock |
| Nintendo Switch 2 + NSO + Memory Card Bundle | $569.99 | $569.99 | San Jose | 6.2 | Low stock |
| Pokémon Squeaky Dog Toys, 3-count | $16.99 | $25.99 | Santa Clara | 0.9 | In stock |
| Arcade1Up Sonic the Hedgehog Home Arcade Machine | $599.99 | $639.99 | Santa Clara | 0.9 | In stock |
| Arcade1Up Sonic the Hedgehog Home Arcade Machine | $599.99 | $639.99 | Sunnyvale | 2.8 | Stock not shown |
| Arcade1Up Sonic the Hedgehog Home Arcade Machine | $599.99 | $639.99 | NE San Jose | 4.6 | In stock |

3 products × 4 warehouses = 12 rows in a few seconds. A search runs the same way: keywords `pokemon` and `tv` at the same 4 warehouses gave 60 rows in about 10 seconds.

#### Input

| Field | What it does |
| --- | --- |
| **What to do** | *Search products* (keywords) or *Check products* (links or item numbers) |
| **Keywords** | e.g. `pokemon`, `lego`, `kirkland olive oil`, `ninja air fryer`, `tv` |
| **Product links or item numbers** | costco.com / costco.ca links (`…/p/-/name/4000446166`), item numbers (`1511996`) or product ids |
| **ZIP codes, postal codes or cities** | `98101`, `M5V 2T6`, `M5V`, `Seattle, WA`, `Toronto` or `latitude, longitude` |
| **Warehouse numbers or names** | Exact warehouses, e.g. `129` or `Santa Clara` |
| **Radius (miles)**, **Warehouses per location** | 50 miles and 5 warehouses by default |
| **Max products per search** | Up to 960 products per keyword, in Costco's order |
| **Only products matching the keywords** | On by default: Costco's search also returns related products (`pokemon` brings Star Wars and Topps cards) |
| **Include online-only products** | Off by default: products Costco sells online only have no warehouse stock |
| **Only in stock**, **Maximum price** | Filters: you pay only for returned rows |
| **Only report changes**, **Monitor name** | Restock and price alerts for scheduled runs |

#### Output

| Field | Example |
| --- | --- |
| `title`, `itemNumber`, `productId`, `brand`, `category`, `url`, `image` | Pokémon Squeaky Dog Toys, 3-count, 1511996, 4000446166, Jazwares, Pet Supplies > Pet Toys & Treats |
| `stockStatus`, `inStockAtWarehouse`, `lowStock` | In stock, true, false (Low stock = true, true; Out of stock = false, false) |
| `warehousePrice`, `onlinePrice`, `onlineListPrice`, `onlineSavings`, `promotion` | 16.99, 25.99 (USD or CAD) |
| `onlineStock` | In stock (delivery to the first ZIP code) |
| `warehouseName`, `warehouseId`, `warehouseAddress`, `warehouseCity`, `warehouseState`, `warehouseZip`, `warehouseCountry` | Santa Clara, 129, 1601 Coleman Ave, Santa Clara, CA, 95050, US |
| `warehousePhone`, `warehouseHours`, `warehouseServices` | (408) 567-9000, Mon-Fri 10am-8:30pm, Sat 9:30am-7pm, Sun 10am-7pm, Food Court, Gas Station, Pharmacy, Tire Service Center |
| `distanceMiles`, `near`, `warehouseLatitude`, `warehouseLongitude` | 0.9, 95050, 37.3569, -121.9386 |
| `rating`, `reviews`, `memberOnly`, `maxPerOrder` | 5.0, 4, false |
| `query`, `queryType` | the search or product the row came from |
| `change`, `changes`, `previousStatus`, `previousPrice` | back_in_stock from Out of stock, price_drop from 39.99 (monitoring) |
| `restocksSeen`, `lastRestockAt`, `usualRestockDay` | 3, 2026-10-09T08:10:00Z, Friday (2 of 3) (monitoring) |

`stockStatus` **Stock not shown** = Costco sells the product at that warehouse (it has a warehouse price) but shows no stock level for it, as on costco.com (often large items). **Not carried** = the warehouse does not sell it. Costco shows stock levels, not unit counts. A bad product link, an unknown warehouse, a place with no Costco nearby or an online-only product returns a row with `error` (free).

#### Pricing

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

| Example | Cost |
| --- | --- |
| 20 products at the 5 warehouses nearest to one ZIP code | ~$0.18 (100 rows) |
| 1 product at 50 warehouses in a region | ~$0.09 (50 rows) |
| Restock alert: 5 products near 2 ZIP codes every hour, nothing changed | $0.001 per run |

#### FAQ

**How do I check Costco inventory near me?** Put your ZIP code (or Canadian postal code, or city) into **ZIP codes, postal codes or cities** and the product into **Keywords** (or its link or item number into *Check products*). Each row is one nearby warehouse with its stock and price.

**Does it show how many units a warehouse has?** No: Costco shows only In stock / Low stock / Out of stock per warehouse, and so does this Actor. "Low stock" usually means a few units left.

**Where do I find the item number?** On the shelf tag and the receipt (e.g. `1511996`), or in the `itemNumber` column of any run. Product links work too.

**Can I check Pokemon cards at Costco?** Yes: search `pokemon` or check the item numbers of the Pokémon TCG bundles you want. Many Pokémon products at Costco are online only: tick **Include online-only products** to see them with their online price and stock.

**When does Costco restock?** Schedule this Actor with **Only report changes**: every delivery shows up as `back_in_stock` or `restocked`, and after a few weeks `usualRestockDay` shows the weekday your warehouses usually get theirs.

**How do I get Costco price drop alerts?** Check your products with **Only report changes** on a daily schedule: a `price_drop` row tells you the warehouse price went down, the moment to ask Costco for a price adjustment.

**Does it work for Costco Canada?** Yes: use a Canadian postal code (`M5V 2T6`), a city (`Toronto`) or a warehouse number. One country per run: costco.com and costco.ca have different catalogs and item numbers.

**Why is a product missing from my search?** Costco sells many products online only (no warehouse stock): they are skipped unless you tick **Include online-only products**. Broad words like `tv` open a category page on costco.com: the Actor then searches the word as a phrase.

#### Tips

- Rows = products × warehouses, so start with a few warehouses and **Only in stock**.
- For a watchlist, use *Check products* with item numbers: the same products every run, no search noise.
- Compare prices across a region: one product, a big radius and 20-50 warehouses per location.
- Use a separate **Monitor name** for each scheduled task.

#### Limits

- Costco US and Costco Canada (other countries' Costco sites are not covered).
- Up to 20 locations, 100 warehouses and 1 000 products per run.
- Stock levels, not unit counts; searches follow Costco's own order.
- Business Centers and gas stations are not checked (warehouses only).

#### Related

- [Sam's Club Stock Checker](https://apify.com/s_actors/sams-club-stock-checker)
- [Walmart Restock Tracker](https://apify.com/s_actors/walmart-restock-tracker)
- [Target Scraper: store stock with units](https://apify.com/s_actors/target-scraper)
- [Best Buy Stock Checker: in-store inventory by ZIP](https://apify.com/s_actors/best-buy-stock-checker)
- [Home Depot Scraper](https://apify.com/s_actors/home-depot-scraper)
- [GameStop Inventory Checker](https://apify.com/s_actors/gamestop-inventory-checker)
- [Five Below Stock Checker](https://apify.com/s_actors/five-below-stock-checker)
- [Walgreens Stock Checker](https://apify.com/s_actors/walgreens-stock-checker)
- [CVS Stock Checker](https://apify.com/s_actors/cvs-stock-checker)
- [IKEA Stock Checker](https://apify.com/s_actors/ikea-stock-checker)

#### For AI agents and API

```json
{
    "mode": "products",
    "products": ["1958890", "https://www.costco.com/p/-/pokmon-squeaky-dog-toys-3-count/4000446166"],
    "locations": ["98101", "95050"],
    "maxWarehousesPerLocation": 5,
    "onlyInStock": true,
    "onlyChanges": true,
    "monitorName": "costco-restock"
}
```

Each row is one product at one warehouse with `stockStatus`, `warehousePrice`, `onlinePrice`, `distanceMiles` and the warehouse address.

# Actor input Schema

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

Search: keywords, every product Costco sells in its warehouses with its stock and price at your warehouses. Check products: exact products by link or item number (best for a back-in-stock watchlist).

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

Search mode: what to search on Costco, one per line (e.g. "pokemon", "pokemon cards", "kirkland olive oil", "ninja air fryer", "tv"). Only products sold in warehouses are checked (online-only products have no warehouse stock).

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

Check products mode: costco.com or costco.ca product links (…/p/-/name/4000446166), item numbers from the shelf tag or receipt (e.g. 1511996) or product ids, one per line.

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

Where to check, one per line: a US ZIP code ("98101"), a Canadian postal code ("M5V 2T6" or "M5V"), a city with a Costco ("Seattle, WA", "Toronto") or "latitude, longitude". The nearest Costco warehouses within "Radius" are checked (up to "Warehouses per location"). The first ZIP also gives the online price and online stock. One country per run: Costco US and Costco Canada have different catalogs.

## `warehouses` (type: `array`):

Exact Costco warehouses to check, one per line: the warehouse number (e.g. "129", in the "warehouseId" column of any run) or its name as on costco.com (e.g. "Santa Clara", "Seattle").

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

How far from each location to look for warehouses.

## `maxWarehousesPerLocation` (type: `integer`):

For each ZIP code, postal code or city: how many of the nearest warehouses to check.

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

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

## `onlyMatchingProducts` (type: `boolean`):

Costco's search also returns loosely related products ("pokemon" brings Star Wars and Topps cards). On: keep only products whose name, brand or category contains every word of the keyword. Broad words that Costco opens as a category page (e.g. "tv") are not filtered.

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

Costco sells many products online only (no warehouse stock): they are skipped by default. Tick to get them too, with the online price and online stock ("Not carried" at warehouses).

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

Return only rows where the warehouse has the product now (in stock or low stock).

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

Return only products at or below this price (USD or CAD, the warehouse 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 warehouse, restocked (low stock to in stock), low stock, sold out, warehouse price drops and increases (handy for Costco price adjustments), and new products or warehouses in your searches (e.g. a new Pokemon set). 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.

## Actor input object example

```json
{
  "mode": "search",
  "keywords": [
    "pokemon"
  ],
  "products": [
    "1958890"
  ],
  "locations": [
    "95050"
  ],
  "radius": 50,
  "maxWarehousesPerLocation": 5,
  "maxProductsPerSearch": 10,
  "onlyMatchingProducts": true,
  "includeOnlineOnly": false,
  "onlyInStock": false,
  "onlyChanges": false,
  "monitorName": "default"
}
```

# Actor output Schema

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

One row per product and warehouse: warehouse stock, price, distance.

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

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

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

Item number, brand, category, rating, warehouse and online prices, limits.

## `warehouses` (type: `string`):

Warehouse address, phone, member hours and services 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": [
        "1958890"
    ],
    "locations": [
        "95050"
    ],
    "maxProductsPerSearch": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("s_actors/costco-scraper").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": ["1958890"],
    "locations": ["95050"],
    "maxProductsPerSearch": 10,
}

# Run the Actor and wait for it to finish
run = client.actor("s_actors/costco-scraper").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": [
    "1958890"
  ],
  "locations": [
    "95050"
  ],
  "maxProductsPerSearch": 10
}' |
apify call s_actors/costco-scraper --silent --output-dataset

```

## MCP server setup

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

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/LWEMso5FHla8ItldI/builds/aYZkWoALFpjD6c5T1/openapi.json