Costco US Products, Prices & Warehouse Finder (Unofficial)

Search Costco US products, resolve the nearest warehouses from a ZIP code, and collect public online prices, local warehouse prices, stock signals, brands, sizes, categories, images, ratings, and product mappings. Use it for regional price comparison, assortment research, product matching, and local availability analysis.

This Actor is unofficial and is not affiliated with, endorsed by, or sponsored by the retailer.

Operations

• search: lightweight product cards for a shopper query. Requires query; optional limit.
• item: the richest exact public product card available. Provide productId or url.
• batch: bounded item lookups. Requires productIds; optional limit.
• warehouses: nearest Costco locations with address, distance, coordinates, hours, phone, and services. Uses postalCode.

For product operations, postalCode is normally all you need. The Actor resolves the nearest warehouse and state through Costco's public locator, then applies that context to prices and availability. shipToState, warehouseId, productWarehouseNumber, and deliveryLocationIds remain available as advanced manual overrides.

Quick start

{
  "operation": "search",
  "query": "coffee",
  "postalCode": "60601",
  "limit": 10
}

Use the returned id with item:

{
  "operation": "item",
  "productId": "ID_FROM_SEARCH"
}

Find nearby warehouses:

{
  "operation": "warehouses",
  "postalCode": "10001",
  "limit": 5
}

Normalized product card

Every dataset row follows one consumer contract:

• Identity: id, optional sku and barcode, name, brand, source_url.
• Price: price is the verified Costco.com price for the postal context. warehouse_price is the separately verified price for warehouse_id; it is never mislabelled as an online discount. discount_price appears only for a verified lower price in the same channel.
• Unit comparison: price_per_unit_price, price_per_unit_quantity, price_per_unit_unit, and size.
• Discovery: category, category_id, and breadcrumbs when exposed by the public source.
• Promotion: promotion_type, promotion_label, multi_buy, and promotion dates when exposed.
• Availability: availability, stock_status, in_stock, fulfillment_options, and explicit price/location/warehouse scopes.
• Media and trust: image, images, rating, review_count, source, retrieved_at, and data_quality_warnings.
• Item enrichment: description, ingredients, allergens, nutrition, specifications, and variants only when the exact public item provides them.

Empty optional fields are omitted. The Actor never copies facts from a similar product and never invents a price, barcode, promotion, availability, ingredient, or specification.

Search versus item

Search intentionally stays lightweight and fast. Item may make additional public requests to enrich the exact product. A warning explains when protection or source limitations force an item result to use verified listing-level data.

Output and export

Product, offer, and store rows are written to the default dataset. Store rows use record_type: "store" and include the resolved warehouse context. The OUTPUT key-value record contains run status, counts, source-call totals, warnings, and structured errors. Export the dataset as JSON, CSV, Excel, XML, or RSS through Apify.

Limitations

Costco.com and physical-warehouse prices can differ by location. The Actor keeps them in separate fields and attaches both requested ZIP and effective warehouse context. Member-only prices are never inferred; missing or rejected enrichment is disclosed in data_quality_warnings.

Public websites change. Run bounded tests before depending on a field, respect the retailer's terms, and use the data only where lawful.