Costco Scraper: prices, member deals, stock, specs and ratings from costco.com

Costco Scraper collects products from costco.com (US) by keyword, category link or product link, without a Costco membership or cookies. Each product comes back as one clean row: product ID and item numbers, title, brand, model, the online price, the warehouse price, the original price and the savings, the member deals as Costco shows them ("$400 OFF"), online and warehouse stock (in stock, low stock, out of stock), star rating and rating count, the full category path, features, program types (ships, in warehouse, same-day delivery...), member-only and FSA flags, order limits, image and link. With details on (the default), each row also gets the long description, the highlights, the specifications as key/value pairs (brand, model, capacity, color, dimensions, screen size...), the shipping note, the promotional note with the deal dates, the department and the release date.

It is used for price monitoring and deal tracking, competitor and assortment research for brands and resellers, MAP checks, warehouse versus online price comparison, product matching across retailers by model number, and clean product datasets for e-commerce, market research and AI agents.

At a glance

What	Price
Product delivered	US$ 4.50 per 1,000 products (US$ 0.0045 each)
Run start	US$ 0.005 per run

• 1,000 products with specifications and stock = US$ 4.51.
• Error rows, duplicates, filtered products and products already delivered in earlier runs (onlyNew) are never charged.
• maxItems is a hard cap, and a spending limit set on the run stops it cleanly with everything delivered so far.
• Proxy is included. The run uses the Apify datacenter proxy by default.

Quick start

{
  "searchQueries": ["coffee maker"],
  "maxItems": 50
}

Laptops from one brand, only products on sale, highest price first:

{
  "searchQueries": ["laptop"],
  "brands": ["HP"],
  "onSaleOnly": true,
  "sortBy": "price_desc",
  "maxItems": 100
}

A category, a product page and a product ID, only items in stock online:

{
  "startUrls": [
    "https://www.costco.com/televisions.html",
    "https://www.costco.com/p/-/cuisinart-brew-central-plus-14-cup-programmable-coffee-maker/4000372303",
    "100525739"
  ],
  "inStockOnly": true,
  "maxItems": 300
}

Input

Field	What it does
searchQueries	Keywords, one search each. Keywords that Costco sends to a category page (like "tv") follow that category.
startUrls	Product links (/p/-/.../4000372303 or .product.100525739.html), category links (/televisions.html), search links (/s?keyword=) or product IDs.
sortBy	relevance, price_asc, price_desc, rating or newest.
brands	Only these brands, as Costco writes them (Kirkland Signature, Samsung).
minPrice, maxPrice	Price range in USD.
minRating	Minimum average star rating.
onSaleOnly	Only products whose price is below the original price.
inStockOnly	Only products in stock for delivery.
includeDetails	On by default: description, highlights, specifications, shipping and promotional notes, department, release date.
maxItems	Cap for the whole run (default 50, 0 = no cap).
onlyNew	For schedules: delivers only products not delivered before for the same search.

Output fields

Field	Example
productId, itemNumbers	4000355164, ["1945458"]
title, brand, model	HP OmniBook 7 Flip 16" 2-in-1 AI Laptop..., HP, 16-au0773cl
price, originalPrice, savings, isOnSale	1099.99, 1499.99, 400.0, true
promotions	["$195 OFF", "$400 OFF", "$205 OFF"]
warehousePrice	1099.99
onlineAvailability, warehouseAvailability	LOW_STOCK, LOW_STOCK
rating, ratingCount	3.36, 28
category, categories	Computers > Laptops > Windows Laptops, every level of the path
features, programTypes	["Backlit Keyboard", "Touchscreen"], ["InWarehouse", "3rdPartyDelivery"]
memberOnly, buyable, fsaEligible, productClass	false, true, false, Standard
minOrderQty, maxOrderQty	1, 9999
image, url	product image and link
description, highlights	long description as text, bullet highlights
specifications	{"Brand": "HP", "Color": "Silver", "Computer Type": "2-in-1"}
shippingNote, promotionalNote	Shipping & Handling: $14.99*, "$400 manufacturer's savings is valid 10/5/26 through 10/18/26"
department, releaseDate	MAJOR APPLIANCES, 2025-05-01
membershipRequired, limitOnePerMember, isPublished	false, false, true
position, sourceQuery	rank in the results, the search or link that found it

savings and promotions are filled only when there is a deal, warehousePrice only for products sold in warehouses, and priceMax appears only for products whose variants have different prices.

Example output

A real row from 16 Oct 2026, lists and description shortened:

{
  "type": "product",
  "productId": "4000355164",
  "itemNumbers": ["1945458"],
  "title": "HP OmniBook 7 Flip 16\" 2-in-1 AI Laptop - Intel Evo Platform Powered by Intel Core Ultra 7 258V - Copilot+ PC - 3K OLED Touchscreen - 32GB Memory - 1TB SSD - Windows 11 Home",
  "brand": "HP",
  "model": "16-au0773cl",
  "price": 1099.99,
  "originalPrice": 1499.99,
  "savings": 400.0,
  "isOnSale": true,
  "promotions": ["$195 OFF", "$400 OFF", "$205 OFF"],
  "warehousePrice": 1099.99,
  "onlineAvailability": "LOW_STOCK",
  "warehouseAvailability": "LOW_STOCK",
  "rating": 3.36,
  "ratingCount": 28,
  "category": "Computers > Laptops > Windows Laptops",
  "features": ["Backlit Keyboard", "Integrated Webcam", "Touchscreen"],
  "specifications": {"Bluetooth Version": "Bluetooth 5.4", "Brand": "HP", "Color": "Silver", "Computer Type": "2-in-1"},
  "shippingNote": "Shipping & Handling: $14.99*\n Item may be available in your local warehouse, prices may vary.",
  "promotionalNote": "$400 manufacturer's savings is valid 10/5/26 through 10/18/26. While supplies last. Limit 2 per member. Terms & Conditions",
  "department": "MAJOR APPLIANCES",
  "releaseDate": "2025-05-01",
  "url": "https://www.costco.com/p/-/hp-omnibook-7-flip-16-2-in-1-ai-laptop---intel-evo-platform-powered-by-intel-core-ultra-7-258v---copilot-pc---3k-oled-touchscreen---32gb-memory---1tb-ssd---windows-11-home/4000355164",
  "position": 1,
  "sourceQuery": "laptop"
}

Errors you may see

Error rows are free and have type: "error", an errorCode and a plain message.

errorCode	Meaning
INVALID_URL	The link is not a Costco product, category or search link, nor a product ID.
INVALID_INPUT	A field has a value the Actor cannot use (for example a rating above 5).
NOT_FOUND	The product is removed, not sold online, or the link or ID is wrong.
NO_RESULTS	The search or category has no product.
BLOCKED	Costco refused every attempt for that search; run it again in a few minutes.

Integrations, scheduling and AI agents

• Schedules: run it daily or weekly from Apify Schedules. Each run is a fresh price, deal and stock snapshot; with onlyNew on, only products not seen before are delivered (new arrivals alert).
• Export: download the dataset as JSON, CSV, Excel, XML or HTML, or read it from the Apify API.
• Make, n8n, Zapier: use the Apify integration to start the Actor and send rows to Google Sheets, Airtable, Slack or your database, for example a price drop or new deal alert.
• AI agents: the Actor works as a tool through the Apify MCP server, so Claude, ChatGPT or any MCP client can search Costco and check prices, deals and stock on demand.
• Webhooks: get a call when a run finishes and pull the dataset from there.

FAQ

Do I need a Costco membership? No. The Actor reads the public catalog the way a visitor does.

Which prices are these? price is the online (delivered) price, warehousePrice the warehouse price Costco shows for the default location, and originalPrice the price before the current deal.

Can I track a list of products? Yes: put the product links or IDs in startUrls and schedule the run.

Is it legal? The Actor reads public product pages and collects no personal data. Check that your use fits the laws and terms that apply to you.

Limitations

• US store only (costco.com). Warehouse prices and stock are those of the default location the site uses.
• Reviews text is not collected, only the rating and the rating count.
• A keyword search returns what Costco's own search returns.
• Products that show their price only in the cart come without a price.

Changelog

• 16 Oct 2026: first version. Keyword, category, product link and ID input; five sort orders; brand, price, rating, sale and stock filters; online, warehouse and original price with savings and deals; specifications, description, shipping and promotional notes; onlyNew for schedules.