# Costco Scraper: Prices, Item Numbers, Ratings and Stock (`themineworks/costco-scraper`) Actor

Scrape Costco.com and Costco.ca by keyword, product link or item number: price, instant savings and dates, rating, reviews, item number, brand, model, online stock and member only flag, one row per product. No login.

- **URL**: https://apify.com/themineworks/costco-scraper.md
- **Developed by:** [The Mine Works](https://apify.com/themineworks) (community)
- **Categories:** E-commerce, Automation, Developer tools
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.61 / 1,000 products

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 Scraper: Prices, Item Numbers, Ratings and Stock

[![20 Costco products with price, instant savings, rating and stock in 3 seconds](https://api.apify.com/v2/key-value-stores/cUXz95yxflDho41nn/records/costco-scraper-hero.png)](https://console.apify.com/actors/pWZA3nbmpsy66jE90/input?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

Returns Costco products from costco.com and costco.ca by keyword, product link or item number, one row per product with price, instant savings and their dates, rating, review count, brand, model, item number, online stock and member only flag. No login, no cookies, no API key. You pay $4.50 per 1,000 products on the Free plan and $2.61 per 1,000 on the Gold plan, plus a $0.001 start fee per run.

**Part of The Mine Works E-commerce and marketplaces family:** [Ozon.ru Scraper](https://apify.com/themineworks/ozon-product-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [⭐ Amazon Reviews Scraper](https://apify.com/themineworks/amazon-reviews?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Amazon Product Scraper](https://apify.com/themineworks/amazon-products?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Etsy Listings Scraper](https://apify.com/themineworks/etsy-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [AliExpress Scraper](https://apify.com/themineworks/aliexpress-products?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Kleinanzeigen.de Scraper](https://apify.com/themineworks/kleinanzeigen-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral).

Updated 17 Nov 2026: first release. Keywords matched across Costco's whole online catalogue, product links and item numbers, the United States and Canada, five sort orders, online stock by ZIP or postal code, sizes and colors with their own item numbers and prices, and an optional description and spec table, one flat row per product. Bookmark this Actor on its Store page so it is one click away next time.

### Why choose this actor?

- **The price a member pays, and the saving, in columns.** `price` is what Costco charges online today after instant savings; `price_before_savings`, `savings`, `promo_text`, `promo_start` and `promo_end` show the manufacturer's savings and when they end. Sort a list by saving without cleaning text.
- **Item numbers you can match.** Every row has the Costco `item_number` from the shelf tag and receipt, the `product_id` from the link, and for products sold in several sizes or colors, each one with its own item number, price and stock in `variants`.
- **Stock and Costco's own flags.** `availability` (in stock, low stock, out of stock) for delivery to your ZIP or postal code, plus `member_only`, `online_only`, `sold_in_warehouse`, `price_in_cart_only`, `limit_one_per_member` and how Costco delivers it (ShipIt, 2 Day, warehouse delivery).
- **Pay per product, nothing for errors.** Links that are not Costco product links, ids Costco does not have, the summary row and duplicates found by two keywords are never charged. Stock, description and specs cost nothing extra.

[![Run it on Apify](https://api.apify.com/v2/key-value-stores/cUXz95yxflDho41nn/records/button-run.png)](https://console.apify.com/actors/pWZA3nbmpsy66jE90/input?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

### How keyword search works here

Costco's own search box and category pages run behind a bot wall that outside tools cannot pass without hiding what they are, and this actor does not hide. Instead it reads Costco's full online catalogue (about 18,000 products on costco.com and 15,000 on costco.ca, the list Costco publishes for search engines) and keeps every product whose name holds all the words of your keyword. Best match puts names that hold your keyword as one phrase first and lets the number of reviews break ties, so the products members buy most come near the top.

What this means for you:

- Use the words that appear in product names: `paper towels`, `olive oil`, `air fryer`, `tv`, `dyson`. Short keywords find more. "tv", "tvs" and "television" are treated as the same word, and plurals are matched.
- `matches_for_query` in every row says how many Costco products matched, so you know when to narrow or widen a keyword.
- Category links (for example costco.com/televisions.html) cannot be read; put the product type in as a keyword instead.
- Costco keeps some sold out and older models online. Turn on `onlyInStock` to keep only what can be ordered today.

### Try it in one minute

Paste this into the input (JSON view) and press Start. It returns 20 Costco paper towel products. It took 3 seconds in our test run on Apify:

```json
{
  "searchQueries": ["paper towels"],
  "maxItems": 20
}
```

Put several keywords on separate lines to run several searches at once, or paste product links and item numbers into `productUrls`. A product that two of your keywords find is delivered once.

Apify's free plan includes $5 of credit every month, which covers about 1,100 products at this actor's price.

#### Copy to your AI assistant

```text
themineworks/costco-scraper on Apify. Reads Costco products from costco.com (US) and costco.ca (Canada) by keyword, product link or item number and returns one flat row per product, no login. Call ApifyClient("TOKEN").actor("themineworks/costco-scraper").call(run_input={"searchQueries": ["paper towels"], "maxItems": 50}), then client.dataset(run["defaultDatasetId"]).list_items().items. Give searchQueries (keywords; every word must be in the product name; costco.com/s?keyword= links work too) or productUrls (costco.com or costco.ca product links /p/-/<name>/<id> or .product.<id>.html, bare product ids, or Item numbers), or both. Optional: country (US or CA, for keywords; default US), maxItems (default 50, 1 to 1000, per keyword), sort (relevance, most_reviewed, rating, price_low, price_high), checkStock (default true), zipCode (US ZIP or Canadian postal code for stock; default 98101 or M5V 3L9), onlyInStock (default false), includeDetails (default false; adds description, specs, marketing_statement). Product rows have no _type field and carry product_id, item_number, title, brand, model, price, price_max, price_before_savings, savings, on_sale, promo_text, promo_start, promo_end, currency, price_in_cart_only, rating, review_count, availability, in_stock, stock_zip, member_only, online_only, sold_in_warehouse, delivery_programs, max_per_order, limit_one_per_member, fsa_eligible, department, variant_count, variants, image_url, product_url, country, description, specs, marketing_statement, source, search_query, position, matches_for_query, input, scraped_at. Each run also writes one row with _type "summary", one with _type "info" when products were delivered or a keyword matched nothing, and a row with _type "error" for each input that could not be read; none of these is charged. Full spec: GET https://api.apify.com/v2/acts/themineworks~costco-scraper/builds/default (Bearer TOKEN), which returns inputSchema and readme.
```

### Key features

- **United States and Canada.** costco.com prices in USD and costco.ca prices in CAD. Keywords use the site you pick; product links use the site of the link.
- **Product links and item numbers.** Paste the product page link, the number at its end, or the Item number from a shelf tag or receipt; an item number of one size returns its whole product with all sizes.
- **Five sort orders.** Best match, most reviewed, highest rated, price low to high and price high to low. The non default orders read up to 400 matching products and sort them by the real price or reviews.
- **Online stock by ZIP or postal code.** One call per 50 products adds `availability` and `in_stock` for delivery to `zipCode` (Seattle 98101 or Toronto M5V 3L9 when empty).
- **Description and specs.** With `includeDetails`, every row also carries the full description as plain text and the spec table Costco shows (brand, model, size, dimensions, warranty and so on).
- **Stops cleanly.** Each call is retried, on an Apify datacenter IP if needed; six failed calls in a row end the run; the run stops before its time limit and keeps every row it read. The summary row says why.

### How to use it

#### Basic: the best 50 matches of a keyword

```json
{
  "searchQueries": ["olive oil"],
  "maxItems": 50
}
```

#### Price monitoring: the same products every day

```json
{
  "productUrls": [
    "https://www.costco.com/p/-/kirkland-signature-paper-towels-2-ply-160-sheets-12-individually-wrapped-rolls/100234271",
    "1738644"
  ],
  "zipCode": "10001"
}
```

Schedule it daily and compare `price`, `savings` and `availability` per `item_number`.

#### Deals: what is on instant savings now, cheapest first

```json
{
  "searchQueries": ["air fryer", "coffee maker", "vacuum"],
  "sort": "price_low",
  "onlyInStock": true,
  "maxItems": 100
}
```

Filter the result on `on_sale` and read `promo_end` to see how long each saving lasts.

#### Costco Canada

```json
{
  "searchQueries": ["coffee"],
  "country": "CA",
  "zipCode": "V6B 1A1",
  "maxItems": 100
}
```

#### Catalog export with descriptions and specs

```json
{
  "searchQueries": ["laptop"],
  "sort": "most_reviewed",
  "includeDetails": true,
  "maxItems": 200
}
```

### Input parameters

| Field | Type | Default | What it does |
|---|---|---|---|
| `searchQueries` | list of text | | Keywords, one search each; every word must be in the product name. Up to 100 per run. |
| `productUrls` | list of text | | Costco product links, product ids or Item numbers, up to 2,000. |
| `country` | choice | US | US (costco.com) or CA (costco.ca), for keywords. |
| `maxItems` | number | 50 | Most products per keyword, 1 to 1,000. |
| `sort` | choice | relevance | relevance, most_reviewed, rating, price_low, price_high. |
| `checkStock` | true/false | true | Adds online stock for delivery to `zipCode`. |
| `zipCode` | text | | US ZIP or Canadian postal code for stock. |
| `onlyInStock` | true/false | false | Keeps only keyword results in stock online. |
| `includeDetails` | true/false | false | Adds description, spec table and marketing statement. |
| `proxyConfiguration` | proxy | none | Not needed; leave as is. |

### What data do you get?

| Field | Example | Notes |
|---|---|---|
| `product_id` | 4000346087 | the number at the end of the product link |
| `item_number` | 1919326 | Costco Item number (shelf tag, receipt) |
| `title` | Bounty Advanced Paper Towels, 2-Ply, 103 Sheets, 12-count | |
| `brand` / `model` | Bounty / | model when Costco lists one |
| `price` | 27.39 | what you pay online now, after instant savings |
| `price_before_savings` / `savings` | 32.99 / 5.6 | when there is a saving |
| `promo_text` / `promo_start` / `promo_end` | $5.60 manufacturer's savings ... | |
| `currency` | USD | USD or CAD |
| `rating` / `review_count` | 4.79 / 2420 | |
| `availability` / `in_stock` | in_stock / true | online, for `stock_zip` |
| `member_only` / `online_only` / `sold_in_warehouse` | false / false / true | |
| `delivery_programs` | \["2DayDelivery", "InWarehouse", "ShipIt"] | |
| `variants` | \[{item_number, price, options, availability}] | sizes and colors, when 2 or more |
| `image_url` / `product_url` | gdx-assets.costco.com / costco.com links | |
| `description` / `specs` | | with `includeDetails` |
| `search_query` / `position` / `matches_for_query` | paper towels / 4 / 26 | where the row came from |

#### Output example

```json
{
  "product_id": "4000346087",
  "item_number": "1919326",
  "title": "Bounty Advanced Paper Towels, 2-Ply, 103 Sheets, 12-count",
  "brand": "Bounty",
  "price": 27.39,
  "price_before_savings": 32.99,
  "savings": 5.6,
  "on_sale": true,
  "promo_text": "$5.60 manufacturer's savings is valid 11/16/26 through 12/20/26. While supplies last. Limit 2 per member.",
  "promo_start": "2026-11-16T08:00:00Z",
  "promo_end": "2026-12-21T07:59:00Z",
  "currency": "USD",
  "price_in_cart_only": false,
  "rating": 4.79,
  "review_count": 2420,
  "availability": "in_stock",
  "in_stock": true,
  "stock_zip": "98101",
  "member_only": false,
  "online_only": false,
  "sold_in_warehouse": true,
  "delivery_programs": ["3rdPartyDelivery", "2DayDelivery", "LocationControlledInventory", "InWarehouse", "WarehouseDelivery", "ShipIt"],
  "limit_one_per_member": false,
  "fsa_eligible": false,
  "department": "SUNDRIES",
  "variant_count": 1,
  "image_url": "https://gdx-assets.costco.com/adobe/assets/urn:aaid:aem:8af70991-77d3-4a34-8962-76191759ecb3/as/4000346087-847__1.avif",
  "product_url": "https://www.costco.com/p/-/bounty-advanced-paper-towels-2-ply-103-sheets-12-count/4000346087",
  "country": "US",
  "source": "search",
  "search_query": "paper towels",
  "position": 4,
  "matches_for_query": 26,
  "scraped_at": "2026-11-17T09:40:51.931Z"
}
```

### Pricing

Pay per event: you pay for the products you receive, plus a flat $0.001 per run, whatever memory you choose. Stock, description and specs cost nothing extra.

| Event | When it is charged | Free plan | Bronze (Starter) | Silver (Scale) | Gold (Business) |
|---|---|---|---|---|---|
| `product` | Once per product row stored in your dataset | $4.50 per 1,000 | $3.87 per 1,000 | $3.24 per 1,000 | $2.61 per 1,000 |
| `run-start` | Once per run, after the first call returned products | $0.001 | $0.001 | $0.001 | $0.001 |

Never charged:

- links that are not Costco product links, category links, and ids Costco does not have (each gets an error row);
- a product that a second keyword of the same run finds again;
- products past your `maxItems`, and products dropped by `onlyInStock`;
- the summary, info and error rows;
- a run with no valid input, or one whose keywords match nothing: the start fee is charged only once products came back;
- anything past your "Max cost per run". The actor checks the budget before each batch of rows and stops while the total is still below your limit.

### How it compares

| Actor | Price per 1,000 on the Free plan | Price per 1,000 on Gold | Start fee | Item numbers and sizes | Online stock | Canada |
|---|---|---|---|---|---|---|
| **This actor** | $4.50 | $2.61 | $0.001 per run | Yes, each size with its own item number and price | Yes, by ZIP or postal code | Yes |
| [CostCo Fast Product Scraper by e-commerce](https://apify.com/e-commerce/costco-fast-product-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) | $5.00 | $2.90 | $0.0001 per run | not stated | Stock field | not stated |
| [Costco Product Scraper by parseforge](https://apify.com/parseforge/costco-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) | $9.90 | $2.90 | $0.005 per run | not stated | Stock status | not stated |
| [Costco Product Search Scraper by easyapi](https://apify.com/easyapi/costco-product-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) | $2.99 | $2.99 | $0.09 per run | not stated | not stated | not stated |

Checked 17 Nov 2026 from the public Store listings.

### Run it on a schedule

1. Open the actor in Apify Console, set your input and click **Save as a new task**.
2. In the task, open **Schedules**, click **Add schedule** and pick how often (every day, every Monday at 08:00 and so on).
3. Compare runs on `item_number` and `price` to see new savings, price changes and stock changes.
4. Optional: add an integration (Google Sheets, Slack, a webhook) so each run lands where your team works.

### FAQ

#### What does this actor read?

The same public product data costco.com and costco.ca load in your browser for product tiles and product pages, and the product list Costco publishes for search engines, as anyone sees them without logging in. It does not log in, add to cart or read anything behind a Costco membership account.

#### Do I need an account, cookies or an API key?

No account, no membership, no cookies and no API key. Nothing to set up and no proxy needed.

#### Why does my keyword return fewer products than the Costco search box?

Costco's search box also matches descriptions, synonyms and spelling mistakes. This actor matches the words of your keyword against product names, so "tv" finds products named "TV" but a product named only "65 in. QLED Display" is not found. Use the words Costco puts in names, try singular and plural, and check `matches_for_query`.

#### Why are some prices or stock fields empty?

Some items show their price only in the cart (`price_in_cart_only` is true) and a few are sold in warehouses only, so Costco has no online stock for them. A member only item still shows its price in the data Costco publishes.

#### Is the price the warehouse price?

No. It is the costco.com or costco.ca online price, which can differ from the price on the shelf in a warehouse.

#### How long does a run take?

In our tests on Apify (17 Nov 2026): 3 seconds for the "Try it" input (20 products), 8 seconds for 143 products from 5 keywords with stock for a New York ZIP, 6 seconds for 86 in stock products from 4 keywords sorted by price, and 13 seconds for 74 Canadian products with descriptions and specs plus US product links. Reading Costco's catalogue once per run takes under a second; each keyword adds one or two.

#### Which formats can I download?

JSON, CSV, Excel, XML, RSS and HTML from the run's Storage tab or through the API. In CSV and Excel, lists such as `variants` and `delivery_programs` are flattened into columns.

#### Can I use it from Claude, ChatGPT or Cursor (MCP)?

Yes, through Apify's MCP server. Connector URL: https://mcp.apify.com/?tools=themineworks/costco-scraper

- Claude: Settings > Connectors > Add custom connector, paste the URL, sign in with Apify.
- ChatGPT: turn on developer mode, add an MCP connector with the URL, sign in with Apify.
- Cursor or VS Code: add it as an HTTP MCP server with that URL.
- Claude Code: `claude mcp add -t http costco-scraper "https://mcp.apify.com/?tools=themineworks/costco-scraper"`

#### Is it legal to scrape Costco?

The actor reads only public product data that anyone can see without logging in: names, prices, ratings and stock that Costco publishes to be found. You are responsible for how you use the data, including Costco's terms and laws that apply to you. This is general information, not legal advice.

### Integrations

- **Google Sheets**: send each run's products to a sheet with Apify's Google Sheets integration; one row per product fits a sheet as is.
- **Make, Zapier and n8n**: start a run and read its dataset with the Apify apps and nodes, for example "new Costco savings on our tracked items every morning to Slack".
- **Webhooks**: have Apify call your URL when a run succeeds, then fetch the dataset.
- **API and SDKs**: run it from Python or JavaScript with the Apify client, or with a plain HTTP call (see "Copy to your AI assistant" above).
- **MCP clients**: Claude, ChatGPT, Cursor and VS Code can run it as a tool through the connector URL in the FAQ.

If this actor saved you time, a short rating on the Store helps other buyers find it.

### More from The Mine Works

**E-commerce and marketplaces**

- [Ozon.ru Scraper](https://apify.com/themineworks/ozon-product-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [⭐ Amazon Reviews Scraper](https://apify.com/themineworks/amazon-reviews?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Amazon Product Scraper](https://apify.com/themineworks/amazon-products?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Etsy Listings Scraper](https://apify.com/themineworks/etsy-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [AliExpress Scraper](https://apify.com/themineworks/aliexpress-products?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Kleinanzeigen.de Scraper](https://apify.com/themineworks/kleinanzeigen-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Carsales.com.au Scraper](https://apify.com/themineworks/carsales-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [eBay Product Listings Scraper](https://apify.com/themineworks/ebay-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Shopify Store Scraper](https://apify.com/themineworks/shopify-store-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [🛒 TikTok Shop Scraper](https://apify.com/themineworks/tiktok-shop-products?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Walmart Product & Price Scraper](https://apify.com/themineworks/walmart-product-price-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Vinted Scraper](https://apify.com/themineworks/vinted-listings-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Social media and video**

- [Threads Scraper](https://apify.com/themineworks/threads-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Reddit Scraper](https://apify.com/themineworks/reddit-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Threads Search Scraper](https://apify.com/themineworks/threads-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Instagram Profile Scraper](https://apify.com/themineworks/instagram-profile-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Leads and business directories**

- [B2B Leads Finder](https://apify.com/themineworks/b2b-leads-finder?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Skip Trace Lookup](https://apify.com/themineworks/skip-trace-lookup?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Google Maps Email Scraper](https://apify.com/themineworks/maps-leads?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [2GIS Places Scraper](https://apify.com/themineworks/2gis-places-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Marketing, SEO and reviews**

- [Facebook Ad Library Scraper](https://apify.com/themineworks/meta-ad-library-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Google Ads Transparency Scraper](https://apify.com/themineworks/google-ads-transparency?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Similarweb Scraper](https://apify.com/themineworks/similarweb-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Google News Scraper](https://apify.com/themineworks/google-news?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**LinkedIn**

- [LinkedIn Company Scraper](https://apify.com/themineworks/linkedin-company-details?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [LinkedIn Post Scraper](https://apify.com/themineworks/linkedin-post-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [LinkedIn Employees Scraper](https://apify.com/themineworks/linkedin-employees?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [LinkedIn Profile Scraper](https://apify.com/themineworks/linkedin-profile-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Real estate**

- [Zillow Rentals Scraper](https://apify.com/themineworks/zillow-rental-listings?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Zillow Sold Comps Scraper](https://apify.com/themineworks/zillow-recently-sold?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [India Real Estate MCP](https://apify.com/themineworks/india-real-estate-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Housing.com Scraper](https://apify.com/themineworks/housing-com-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Science, health and government data**

- [Academic Research MCP](https://apify.com/themineworks/academic-research-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [CourtListener Scraper](https://apify.com/themineworks/courtlistener-court-records?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Socrata Open Data Scraper](https://apify.com/themineworks/socrata-open-data?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [OpenAlex Scraper](https://apify.com/themineworks/openalex-scholarly-works?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Jobs and hiring**

- [Foundit Monster India Jobs](https://apify.com/themineworks/foundit-jobs-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Hirist Jobs Scraper](https://apify.com/themineworks/hirist-jobs-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [India Jobs MCP](https://apify.com/themineworks/india-jobs-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Naukri Jobs Scraper](https://apify.com/themineworks/naukri-jobs?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Company and business data**

- [Company Domain Finder](https://apify.com/themineworks/company-domain-finder?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GST Taxpayer Lookup](https://apify.com/themineworks/gst-taxpayer-lookup?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Company KYB Resolver](https://apify.com/themineworks/company-identity-resolver?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [SEC EDGAR Filings Scraper](https://apify.com/themineworks/sec-edgar-filings?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Food and local services**

- [NoBroker Scraper](https://apify.com/themineworks/nobroker-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Swiggy Restaurant Scraper](https://apify.com/themineworks/swiggy-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Zomato Scraper](https://apify.com/themineworks/zomato-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Developer and AI tools**

- [Website to Markdown Crawler](https://apify.com/themineworks/rag-crawler?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GitHub Skill Finder](https://apify.com/themineworks/github-skill-discovery?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GitHub Repo Scraper](https://apify.com/themineworks/github-repo-intelligence?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GitHub Trending Scraper](https://apify.com/themineworks/github-trending-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**More tools**

- [G2 Reviews Scraper](https://apify.com/themineworks/g2-reviews-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Naver Blog Scraper](https://apify.com/themineworks/naver-blog-posts-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [WeChat Article Scraper 微信公众号文章](https://apify.com/themineworks/wechat-article-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Taobao Products Scraper 淘宝 天猫](https://apify.com/themineworks/taobao-products-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

### Support

Found a keyword that misses products you can see on Costco, or a field that comes back empty? Open an issue in the Issues tab with the input and the run ID, and we will look at it. For a field you need or a new source, email dmineworks@gmail.com.

*Search Costco.com and Costco.ca by keyword or item number and get every product back as one row, with price, instant savings, rating, item number, stock and member only flag, no login.*

# Actor input Schema

## `searchQueries` (type: `array`):

Product keywords, one per line. Example: paper towels, air fryer, olive oil. Every word must appear in the product name, so short keywords find more. Costco search links (https://www.costco.com/s?keyword=tv) work too. Up to 100 keywords per run.

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

Costco product links copied from your browser, for example https://www.costco.com/p/-/kirkland-signature-paper-towels/100234271 or a costco.ca link, or just the number at the end of the link. The Item number from the shelf tag or the product page works too (for example 1738644). Up to 2,000 per run.

## `country` (type: `string`):

Which Costco to search: the United States (costco.com, prices in USD) or Canada (costco.ca, prices in CAD). Product links always use the site of the link.

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

The most products to return for each keyword, 1 to 1,000.

## `sort` (type: `string`):

Order of the keyword results. Best match puts products whose name holds your keyword as one phrase first. The other orders read up to 400 matches and sort them by the real price or reviews.

## `checkStock` (type: `boolean`):

On: every row gets availability (in stock, low stock, out of stock) for delivery to the ZIP or postal code below. One extra call per 50 products, same price per product.

## `zipCode` (type: `string`):

A US ZIP code (for example 10001) or a Canadian postal code (for example M5V 3L9). Stock is checked for delivery there. Empty: Seattle 98101 for the US, Toronto M5V 3L9 for Canada.

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

On: keyword results keep only products Costco has in stock (or low stock) for delivery to the ZIP or postal code. Costco keeps some sold out and older models online, so this gives a list of what you can order today.

## `includeDetails` (type: `boolean`):

On: each row also gets the full product description, the spec table (brand, size, model, dimensions and so on) and the marketing statement. Same price per product.

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

Not needed: the actor works without a proxy and switches to an Apify datacenter IP by itself if a call is refused. Set your own proxy only if you have a reason to.

## Actor input object example

```json
{
  "searchQueries": [
    "paper towels"
  ],
  "country": "US",
  "maxItems": 20,
  "sort": "relevance",
  "checkStock": true,
  "onlyInStock": false,
  "includeDetails": false,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

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

No description

## `summary` (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 = {
    "searchQueries": [
        "paper towels"
    ],
    "maxItems": 20
};

// Run the Actor and wait for it to finish
const run = await client.actor("themineworks/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 = {
    "searchQueries": ["paper towels"],
    "maxItems": 20,
}

# Run the Actor and wait for it to finish
run = client.actor("themineworks/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 '{
  "searchQueries": [
    "paper towels"
  ],
  "maxItems": 20
}' |
apify call themineworks/costco-scraper --silent --output-dataset

```

## MCP server setup

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