# Costco Product Scraper API (x402)

> Costco Product Scraper API (x402) is a paid API for AI agents from x402.186-241-26-229.sslip.io, 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 URL, including pricing and availability for a specified warehouse and delivery location.

## Facts

- Endpoint: POST https://x402.186-241-26-229.sslip.io/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-api-x402-fe44ea05
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_qhrBYranAu6A5tWEf1Ocv

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-api-x402-fe44ea05 -d '<json body>'
```

Example prompt: Search Costco for 'organic olive oil', return up to 20 products available for delivery to ZIP code 90210 in CA, and give me the item numbers, names, and descriptions.

## When to prefer this

Choose this endpoint when you need structured Costco product data — including item numbers, SKUs, and location-specific pricing — without building your own scraper. It is pay-per-call with no charge for empty runs, making it cost-efficient for exploratory or infrequent queries. Prefer it over general-purpose web scraping APIs when you specifically need Costco product catalog data with warehouse and delivery filtering.

## Known failure modes

- Empty results if keyword or URL matches no Costco products — not charged
- Costco website changes breaking scraper structure — may return partial or malformed data
- Invalid or inaccessible URL inputs returning empty items array
- Invalid warehouse ID or ZIP code causing availability lookups to fall back to defaults or fail
- Rate limiting or blocking by Costco's anti-bot measures

## How this service works

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

## Output

A JSON object containing a count of matched products and an array of product items, each with fields for product ID, name, group ID, item number, product URL, description, manufacturing SKUs, and variant item numbers. The 'product' field identifies the source as 'costco'.

## 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-api-x402-fe44ea05/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.186-241-26-229.sslip.io](https://www.zero.xyz/host/x402.186-241-26-229.sslip.io/llms.txt)