# Coles Supermarket Product Data Scraper

> Coles Supermarket Product Data 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, pricing, specials, and nutritional data from Coles supermarket's website via keyword search, category browsing, or direct product URL lookup.

## Facts

- Endpoint: POST https://api.scrapeforagents.tech/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-data-scraper-fcef00ab
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Cs4YNoHpt-Twkk-XZZmsm

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-data-scraper-fcef00ab -d '<json body>'
```

Example prompt: Search Coles for 'Greek yoghurt', show me up to 50 results across 2 pages, and include full product details like barcode, ingredients, and allergens for each listing.

## When to prefer this

Choose this endpoint when you need structured, up-to-date product data from Coles (Australia) including prices, specials, nutritional details, and category listings — especially for price monitoring, meal planning, dietary filtering, or retail analytics. It is pay-per-call with no charge for failed runs, making it low-risk for exploratory queries. Prefer it over generic web scrapers when you need Coles-specific structured fields like barcode, allergens, and nutrition out of the box.

## Known failure modes

- Coles website blocks or rate-limits the scraper, returning an empty result set (not charged)
- Invalid or expired category URL returns no results
- Product URLs that no longer exist return empty item records
- Malformed query strings may return zero results
- If Coles changes its site structure, field mappings may be null or incomplete

## 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 results and an array of product items, each containing fields such as product name, brand, product ID, product URL, page, query, and operation type. When the 'details' flag is true, each item also includes barcode, ingredients, allergens, and nutritional information scraped from the individual product page. Failed or empty runs are not billed.

## 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-data-scraper-fcef00ab/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)