# Coles Supermarket Product Scraper (x402)

> Coles Supermarket Product Scraper (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 the Coles Australian supermarket website, supporting search, specials, category browsing, and individual product detail fetching.

## Facts

- Endpoint: POST https://x402.186-241-26-229.sslip.io/v1/coles?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/coles-supermarket-product-scraper-x402-71201f8f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_irXHRePX9Df01C9qgmzyR

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 coles-supermarket-product-scraper-x402-71201f8f -d '<json body>'
```

Example prompt: Search Coles for 'oat milk', fetch up to 50 results across 2 pages including full product details like barcodes and nutrition info, and show me everything that comes back.

## When to prefer this

Choose this endpoint when you need structured product data directly from Coles Australia — including search results, specials (all or half-price), category shelves, or individual product nutrition/ingredient details — and you want pay-per-call pricing with no charge for failed or empty runs. Prefer it over generic web scrapers when Coles-specific schema fields (barcode, allergens, nutrition) are needed.

## Known failure modes

- Empty result set (no matching products for query) — not charged
- Coles website blocking or rate-limiting the scraper — may return partial or empty results
- Invalid categoryUrl or productUrl — returns empty or error
- Coles website layout changes breaking the scraper — fields may return null
- maxItems or maxPages set to values that exceed available data — returns fewer items than requested

## 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 items and an array of product records, each containing fields like name, brand, productId, productUrl, page, query, operation, and recordType. When the 'details' flag is set, each product page is also fetched to return barcode, ingredients, allergens, and nutrition data.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "query": {
   "type": "string",
   "description": "Product keyword for search."
  },
  "details": {
   "type": "boolean",
   "default": false,
   "description": "Fetch each listing product page for barcode, ingredients, allergens, and nutrition."
  },
  "special": {
   "enum": [
    "all",
    "halfprice"
   ],
   "type": "string",
   "default": "all",
   "description": "All specials or half-price offers when operation is specials."
  },
  "maxItems": {
   "type": "integer",
   "default": 100,
   "minimum": 0,
   "description": "Stop after this many dataset rows; 0 means no cap."
  },
  "maxPages": {
   "type": "integer",
   "default": 1,
   "minimum": 1,
   "description": "Maximum native pages to fetch from the start page."
  },
  "operation": {
   "enum": [
    "search",
    "specials",
    "category",
    "item",
    "categories"
   ],
   "type": "string",
   "default": "search",
   "description": "Choose product search, specials, a category shelf, individual items, or category discovery."
  },
  "startPage": {
   "type": "integer",
   "default": 1,
   "minimum": 1,
   "description": "First native Coles page for search, specials, or category."
  },
  "categoryUrl": {
   "type": "string",
   "description": "Full Coles browse URL for category operation."
  },
  "productUrls": {
   "type": "array",
   "description": "Full Coles product URLs for item operation."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "items": [
   {
    "name": null,
    "page": null,
    "brand": null,
    "query": null,
    "operation": null,
    "productId": null,
    "productUrl": null,
    "recordType": null
   }
  ],
  "product": "coles"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/coles-supermarket-product-scraper-x402-71201f8f/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)