# Costco Product Scraper

> Costco Product Scraper is a paid API for AI agents from api.scrapeforagents.tech, paid per call via x402, $0.025/call, status unknown (last checked 2026-10-02).

Scrapes structured product data from Costco.com by keyword search or specific URLs, with location-specific pricing and availability

## Facts

- Endpoint: POST https://api.scrapeforagents.tech/v1/costco?utm_source=zero.xyz
- Price: $0.025/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/costco-product-scraper-5b322cd4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_zEd_O1KVYk8Ijbk7rjQF2

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability costco-product-scraper-5b322cd4 -d '<json body>'
```

Example prompt: Search Costco for 'organic olive oil' and get me up to 20 results with pricing available for delivery to ZIP code 90210 in California.

## When to prefer this

Use this endpoint when you need structured, machine-readable Costco product data including location-specific pricing and availability. It is ideal for price comparison, product research, inventory monitoring, or any workflow requiring Costco catalog data without building your own scraper. Prefer this over generic web scrapers when you need normalized product fields (item numbers, SKUs, variants) from Costco specifically.

## Known failure modes

- No products found for the given keyword or URL — empty items array returned, no charge
- Invalid or inaccessible Costco URL — run fails, no charge
- Invalid US state code or ZIP code — may return incorrect or no location-specific pricing
- Rate limiting or Costco blocking — run may fail with no charge
- maxItems or maxProductsPerUrl set too low — fewer results than expected returned

## How this service works

Pay-per-call structured web data. Failed or empty runs are not charged.

## Output

Returns a JSON object with a count of matched products and an array of product items, each containing fields such as product ID, name, group ID, item number, product URL, description, manufacturing SKUs, and variant item numbers. Empty or failed runs are not charged.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "keyword": {
   "type": "string",
   "description": "Search Costco products by keyword. Runs alongside any start URLs."
  },
  "maxItems": {
   "type": "integer",
   "default": 0,
   "minimum": 0,
   "description": "Maximum products across all inputs. Set to 0 for no total limit."
  },
  "startUrls": {
   "type": "array",
   "default": [],
   "description": "Costco search, category, or product URLs to scrape. May be used together with a keyword."
  },
  "warehouseId": {
   "type": "string",
   "default": "847",
   "description": "Warehouse number used for location-specific pricing and availability. The default is a Seattle-area warehouse."
  },
  "deliveryState": {
   "type": "string",
   "default": "WA",
   "description": "Two-letter US state code corresponding to the delivery ZIP code."
  },
  "deliveryZipCode": {
   "type": "string",
   "default": "98101",
   "description": "US delivery ZIP code used for shipping prices and availability."
  },
  "maxProductsPerUrl": {
   "type": "integer",
   "default": 30,
   "minimum": 1,
   "description": "Maximum number of products from each keyword or listing URL; a product URL returns at most one."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "items": [
   {
    "id": null,
    "name": null,
    "groupId": null,
    "itemNumber": null,
    "productUrl": null,
    "description": null,
    "manufacturingSkus": null,
    "variantItemNumbers": null
   }
  ],
  "product": "costco"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/costco-product-scraper-5b322cd4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.scrapeforagents.tech](https://www.zero.xyz/host/api.scrapeforagents.tech/llms.txt)