# Costco Scraper — Member Prices, Savings & Warehouse Stock (`rbbscrap/costco-scraper`) Actor

Extract Costco Wholesale product prices, Item Numbers, Instant Savings, .97 clearance deals, member-only flags, and warehouse availability. Zero-browser 256MB RAM.

- **URL**: https://apify.com/rbbscrap/costco-scraper.md
- **Developed by:** [Hector](https://apify.com/rbbscrap) (community)
- **Categories:** E-commerce, Business
- **Features:** Limited permissions
- **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 1 bookmarks
- **User rating**: No ratings yet

## Pricing

$0.45 / 1,000 scraped costco items

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

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

<p align="center">
  <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/aLIBWfk1daBmi5a2m-actor-ZW2aIIH9CqPpizREu-A4uuLArMFG-costco.png" alt="Costco Wholesale official logo" width="72" height="72" />
</p>

## Costco Scraper — Member Prices, Savings & Warehouse Stock

> **Pay-Per-Event Pricing ($0.45 / 1,000 items — 5x–10x cheaper than #1, 1st Run 100% Free!)** · Built for **Zero-Browser 256MB RAM** execution on Apify Cloud · Export to **JSON, CSV, Excel, Make, n8n, Zapier & MCP**.

**Related US Scrapers**: [Instacart Scraper](https://apify.com/rbbscrap/instacart-scraper) · [Home Depot Scraper](https://apify.com/rbbscrap/homedepot-scraper) · [Amazon Scraper](https://apify.com/rbbscrap/amazon-scraper) · [eBay Scraper](https://apify.com/rbbscrap/ebay-scraper)

***

### What does Costco Wholesale Scraper do?

Member Prices, Savings & Warehouse Stock extractor built for speed, reliability, and ultra-low compute cost. Run a **1-Click Run** immediately using prefilled US defaults or pass your own keywords, filters, and direct URLs.

#### Beyond the Official API

Costco Wholesale does not publish a public wholesale catalog or warehouse clearance API for buyers, restaurants, or retail arbitrage teams. This actor combines Costco live same-day warehouse feeds with catalog indexing to surface Item Numbers, member prices, Instant Savings, and .97 clearance deals at 256MB RAM.

***

### What data can you scrape?

| Category | Extracted Fields & Capabilities |
| :--- | :--- |
| **Costco Identifiers** | Costco Item Number, Brand & Product Name |
| **Member & Promo Pricing** | Current Price, Original Price & Instant Savings ($) |
| **Clearance Signals** | Automatic `.97` Clearance Endings Flag (`priceEndsIn97`) |
| **Warehouse Localization** | Availability Status, ZIP Code & Purchase Limit |
| **Membership Context** | Member-Only Required Flag & Tier Metadata |
| **Direct Links** | Verified Costco / Same-Day Product URLs |

***

### Why scrape Costco Wholesale? (Typical Use Cases)

- **Restaurants & B2B Buyers**: Monitor bulk Kirkland Signature staples, coffee, oils, and paper goods prices before warehouse runs.
- **Retail Arbitrage & Deal Hunters**: Detect `.97` manager markdowns and Instant Savings promotions automatically.
- **CPG Competitive Intelligence**: Compare Costco club pack pricing against Kroger, Publix, Safeway, and Amazon.
- **Automated Reordering Alerts**: Trigger Slack or email alerts whenever key wholesale SKUs drop in price or hit low stock.

***

### How to scrape Costco Wholesale data (4 Simple Steps)

1. Set a **Search Keyword** (e.g., `kirkland signature`, `olive oil`, `laptop`) and your **Warehouse ZIP Code**.
2. Enable `includeInstacartWarehouse` for live same-day warehouse shelf prices or toggle `onlyClearanceOrSavings`.
3. Click **Start** — your very first run is **100% free** (`$0.00` charged).
4. Download JSON/CSV or pipe directly into Airtable, BigQuery, Make, or n8n.

***

### Input Configuration & Examples

| Parameter | Type | Description | Default |
| :--- | :--- | :--- | :--- |
| `searchQuery` | `string` | Product keyword, brand, or Costco Item Number (e.g. 'kirkland signature', 'laptop', 'coffee', 'olive oil'). | `"kirkland signature"` |
| `productUrls` | `array` | Optional direct costco.com product URLs to inspect. | `[]` |
| `warehouseZipCode` | `string` | Target US 5-digit ZIP code for warehouse localization. | `"98101"` |
| `category` | `string` | Costco department filter for product discovery. | `"all"` |
| `onlyClearanceOrSavings` | `boolean` | Filter results to discounted items, Member-Only Savings, or .97 clearance deals. | `false` |
| `includeInstacartWarehouse` | `boolean` | Pull live Costco warehouse prices, multi-pack sizes, and stock statuses via Instacart Costco Storefront. | `true` |
| `maxItems` | `integer` | Maximum number of Costco items to extract (1–500). | `25` |
| `sortBy` | `string` | Sort extracted Costco products by relevance, lowest price, or highest savings. | `"relevance"` |
| `memberTier` | `string` | Membership tier label used in output metadata. | `"gold_star"` |
| `proxyConfiguration` | `object` | Optional Apify Proxy for direct costco.com product page enrichment. | `{"useApifyProxy":false}` |

#### Example Inputs

##### Kirkland & Warehouse Bulk Pricing (Default 1-Click)

```json
{
  "searchQuery": "kirkland signature",
  "warehouseZipCode": "98101",
  "includeInstacartWarehouse": true,
  "maxItems": 25
}
```

##### Instant Savings & .97 Clearance Hunt

```json
{
  "searchQuery": "coffee",
  "onlyClearanceOrSavings": true,
  "sortBy": "savings",
  "maxItems": 50
}
```

***

### Output Example (Table View, JSON & Output Fields Reference)

```json
{
  "itemNumber": "20142088",
  "productName": "Kirkland Signature Organic Extra Virgin Olive Oil, 2 L",
  "brand": "Kirkland Signature",
  "category": "grocery",
  "price": 24.99,
  "originalPrice": 28.99,
  "priceFormatted": "$24.99",
  "instantSavings": 4,
  "priceEndsIn97": false,
  "currency": "USD",
  "memberOnlyRequired": true,
  "warehouseAvailability": "Many in stock",
  "purchaseLimit": "Limit 5 per member",
  "memberTier": "gold_star",
  "warehouseZipCode": "98101",
  "productUrl": "https://www.costco.com/",
  "scrapedAt": "2026-11-13T09:15:00.000Z"
}
```

#### Output Fields Reference

| Field | Description |
| :--- | :--- |
| `itemNumber` | Costco item identifier or catalog product ID |
| `productName / brand` | Full item title and brand (e.g. Kirkland Signature) |
| `price / originalPrice` | Current warehouse price and regular price in USD |
| `instantSavings` | Dollar discount between original and current price |
| `priceEndsIn97` | Boolean flag indicating `.97` manager clearance pricing |
| `memberOnlyRequired` | Whether active Costco membership is required |
| `warehouseAvailability` | Live warehouse stock status (e.g. Many in stock) |
| `purchaseLimit` | Member quantity cap when specified |
| `productUrl` | Direct Costco or live warehouse listing URL |

***

### Related & Dedicated Scrapers

| Scraper | Niche | Why Combine It? |
| :--- | :--- | :--- |
| **[Instacart Scraper](https://apify.com/rbbscrap/instacart-scraper)** | US Market Data | Track Kroger, Safeway, Publix & Aldi prices nationwide |
| **[Home Depot Scraper](https://apify.com/rbbscrap/homedepot-scraper)** | US Market Data | Monitor hardware & contractor bulk pricing at Home Depot |
| **[Amazon Scraper](https://apify.com/rbbscrap/amazon-scraper)** | US Market Data | Cross-check wholesale club spreads against Amazon retail |
| **[eBay Scraper](https://apify.com/rbbscrap/ebay-scraper)** | US Market Data | Verify secondary resale demand on closed & active listings |

***

### Error Items & Resilience Reference

- **Anti-Bot & Timeout Protection**: Strict request timeouts (12–15s) and global 75s safety exit guarantee zero runaway compute charges.
- **Zero-Null Guarantee**: Every normalized field defaults cleanly without `null` or `undefined` gaps breaking downstream Make/n8n/Zapier parsers.
- **No Unwanted Compute Drain**: Zero headless browser overhead — runs cleanly at `256 MB` RAM.

***

### Frequently Asked Questions (FAQ)

#### 1. How much does it cost, and is the first run really free?

This scraper uses **Pay-Per-Event** pricing at **$0.00045 per record** (**$0.45 / 1,000 items**), roughly **5x–10x cheaper** than leading competitors. Your **very first run is 100% free** (`$0.00` event charges waived automatically via our developer trial registry).

#### 2. Can I connect this scraper to Make, n8n, or Zapier?

Yes. Every dataset item is flat, strongly typed JSON ready for **Make (Integromat)**, **n8n**, **Zapier**, Google Sheets, Airtable, and webhooks.

#### 3. How do I call this actor via Python or Node.js API?

Use `apify-client` in Python or Node.js by passing your `APIFY_TOKEN` and actor slug `rbbscrap/costco-scraper`, then read `client.dataset(run["defaultDatasetId"]).iterate_items()`.

#### 4. Does it work with Claude Desktop, Cursor, or AI Agents (MCP)?

Yes. Connect the official **Apify MCP Server** and invoke `rbbscrap/costco-scraper` directly as a tool inside Claude, Cursor, or Windsurf.

#### 5. Do I need residential proxies or cookies?

No cookies are required. Default runs work immediately without paid proxies; an optional `proxyConfiguration` input is available for localized or high-volume direct URL runs.

#### 6. Is scraping public data legal (GDPR / US compliance)?

This actor only reads publicly accessible web pages and public APIs without bypassing login gates or paywalls, and does not harvest private personal data under **EU Regulation 2016/679 (GDPR)**. Ensure your downstream usage complies with applicable local laws and target site terms.

#### 7. Where can I report an issue or request a new field?

Open an issue directly on our Apify Actor page: [Report an Issue / Request Feature](https://apify.com/rbbscrap/costco-scraper/issues/open).

# Actor input Schema

## `searchQuery` (type: `string`):

Product keyword, brand, or Costco Item Number (e.g. 'kirkland signature', 'laptop', 'coffee', 'olive oil').

## `productUrls` (type: `array`):

Optional direct costco.com product URLs to inspect.

## `warehouseZipCode` (type: `string`):

Target US 5-digit ZIP code for warehouse localization.

## `category` (type: `string`):

Costco department filter for product discovery.

## `onlyClearanceOrSavings` (type: `boolean`):

Filter results to discounted items, Member-Only Savings, or .97 clearance deals.

## `includeInstacartWarehouse` (type: `boolean`):

Pull live Costco warehouse prices, multi-pack sizes, and stock statuses via Instacart Costco Storefront.

## `maxItems` (type: `integer`):

Maximum number of Costco items to extract (1–500).

## `sortBy` (type: `string`):

Sort extracted Costco products by relevance, lowest price, or highest savings.

## `memberTier` (type: `string`):

Membership tier label used in output metadata.

## `proxyConfiguration` (type: `object`):

Optional Apify Proxy for direct costco.com product page enrichment.

## Actor input object example

```json
{
  "searchQuery": "kirkland signature",
  "productUrls": [],
  "warehouseZipCode": "98101",
  "category": "all",
  "onlyClearanceOrSavings": false,
  "includeInstacartWarehouse": true,
  "maxItems": 25,
  "sortBy": "relevance",
  "memberTier": "gold_star",
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# 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 = {
    "searchQuery": "kirkland signature",
    "productUrls": [],
    "warehouseZipCode": "98101",
    "category": "all",
    "onlyClearanceOrSavings": false,
    "includeInstacartWarehouse": true,
    "maxItems": 25,
    "sortBy": "relevance",
    "memberTier": "gold_star"
};

// Run the Actor and wait for it to finish
const run = await client.actor("rbbscrap/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 = {
    "searchQuery": "kirkland signature",
    "productUrls": [],
    "warehouseZipCode": "98101",
    "category": "all",
    "onlyClearanceOrSavings": False,
    "includeInstacartWarehouse": True,
    "maxItems": 25,
    "sortBy": "relevance",
    "memberTier": "gold_star",
}

# Run the Actor and wait for it to finish
run = client.actor("rbbscrap/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 '{
  "searchQuery": "kirkland signature",
  "productUrls": [],
  "warehouseZipCode": "98101",
  "category": "all",
  "onlyClearanceOrSavings": false,
  "includeInstacartWarehouse": true,
  "maxItems": 25,
  "sortBy": "relevance",
  "memberTier": "gold_star"
}' |
apify call rbbscrap/costco-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,rbbscrap/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/aKfKEbhi3lDHQMZWf/builds/1EDBlKD4T8gXs6Jmh/openapi.json
