+Coles API
Search Coles and pull Australian grocery prices, specials and nutrition as clean JSON.
The API.SH Coles API returns public coles.com.au product data as structured JSON. Search with brand, dietary, allergen and specials filters and price or unit-price sorts, browse any department or aisle, list this week's specials and multibuys, and open a product for its price, was price, unit price, ingredients, allergens, nutrition panel, country of origin and size variants.
- 6 endpoints
- from $1 / 1,000 calls
- 1,000 free credits / month
- failed calls free
GET https://api.api.sh/coles/v1/ search
{"query": "milk","applied_filters": {"sort": "relevance"},"page": 1,"limit": 48,"total": 328,"count": 55,"next_page": 2,"did_you_mean": null,"facets": [{"name": "brand","values": [{"id": "2780582535","name": "a2 Milk","count": 12},{"id": "239341655","name": "Australias Own","count": 8},"… 18 more"]},{"name": "allergen","values": [{"id": "9","name": "Gluten Free","count": 79},{"id": "10","name": "Lactose Free","count": 61},"… 8 more"]},"… 2 more"],"categories": [{"id": "1300","name": "Dairy, Eggs & Fridge","slug": "dairy-eggs-fridge","count": 328},{"id": "10302","name": "Pantry","slug": "pantry","count": 3},"… 5 more"],"products": [{"id": "8150288","url": "https://www.coles.com.au/product/coles-full-cream-milk-3l-8150288","name": "Full Cream Milk","brand": "Coles","description": "COLES FULL CREAM MILK 3L","size": "3L","price": 4.95,"was_price": null,"save_amount": null,"save_percent": null,"save_statement": null,"currency": "AUD","unit_price": 1.65,"unit_measure": "1l","unit_price_text": "$1.65/ 1L","weighted": false,"promotion_type": null,"special_type": null,"online_special": false,"offer": null,"multibuy": null,"available": true,"availability_type": "InStoreAndOnline","available_quantity": 3160,"sponsored": false,"featured": false,"min_guarantee": "Life 7 days min","category": {"department": "Dairy, Eggs & Fridge","department_id": "1300","category": "Milk","category_id": "8881800","aisle": "Full Cream Milk","aisle_id": "8881801"},"aisle_location": null,"retail_limit": 20,"promotional_limit": 12,"liquor": false,"tobacco": false,"variant_count": 18,"image": "https://cdn.productimages.coles.com.au/productimages/8/8150288.jpg"},{"id": "5610177","url": "https://www.coles.com.au/product/rokeby-fitmilk-lactose-free-light-milk-1l-5610177","name": "Fitmilk Lactose Free Light Milk","brand": "Rokeby","description": "ROKEBY FITMILK LACTOSE FREE LIGHT MILK 1L","size": "1L","price": 3.2,"was_price": null,"save_amount": null,"save_percent": null,"save_statement": null,"currency": "AUD","unit_price": 3.2,"unit_measure": "1l","unit_price_text": "$3.20/ 1L","weighted": null,"promotion_type": null,"special_type": null,"online_special": false,"offer": null,"multibuy": null,"available": true,"availability_type": "InStoreAndOnline","available_quantity": 111,"sponsored": true,"featured": true,"min_guarantee": "Life 7 days min","category": {"department": "Dairy, Eggs & Fridge","department_id": "1300","category": "Milk","category_id": "8881800","aisle": "Specialty Milk","aisle_id": "8881805"},"aisle_location": null,"retail_limit": 20,"promotional_limit": null,"liquor": null,"tobacco": null,"variant_count": null,"image": "https://cdn.productimages.coles.com.au/productimages/5/5610177.jpg"},"… 53 more"],"cached": false,"credits_used": 1} What you can build with the Coles API
Australian grocery price tracking
Run searches or category pages on a schedule and record price, was price and unit price for the products you follow.
Weekly specials monitoring
Pull the specials list shop-wide or for one department, filtered to multibuys or online-only deals, to see what is discounted this week.
Coles vs Woolworths comparison
Search the same products at Coles and Woolworths through one key and compare price and unit price side by side.
Nutrition and origin data
Open products to collect ingredients, allergens, the nutrition panel per serving and per 100 g, and the Australian-made share.
Range mapping
Walk the category tree with product counts and page through aisles to map Coles' range by brand.
Coles data you get
Field names from real responses. Numbers come parsed, URLs absolute, dates in ISO 8601.
Coles API endpoints and prices
Every Coles endpoint costs 1 credit per call: credits are $1 per 1,000 on a monthly plan, $2 pay-as-you-go. Pricing
| Search Coles products /coles/ | $1 · $2 PAYG 1 credit |
| Coles category products /coles/ | $1 · $2 PAYG 1 credit |
| Coles product /coles/ | $1 · $2 PAYG 1 credit |
| Coles category tree /coles/ | $1 · $2 PAYG 1 credit |
| Coles specials /coles/ | $1 · $2 PAYG 1 credit |
| Coles store finder /coles/ | $1 · $2 PAYG 1 credit |
Call the Coles API
Search Coles products: GET https://api.api.sh/coles/
curl "https://api.api.sh/coles/v1/search?q=milk" \
-H "x-api-key: $APISH_KEY" import os, requests
res = requests.get(
"https://api.api.sh/coles/v1/search",
params={"q": "milk"},
headers={"x-api-key": os.environ["APISH_KEY"]},
timeout=120,
)
res.raise_for_status()
data = res.json() const url = new URL("https://api.api.sh/coles/v1/search");
url.searchParams.set("q", "milk");
const res = await fetch(url, { headers: { "x-api-key": process.env.APISH_KEY } });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const data = await res.json(); # Google Sheets (API.SH add-on)
=APISH("/coles/v1/search", "q", "milk")
# Zapier, Make, n8n (verified node): pick the API.SH app,
# choose "Coles" and "Search Coles products".
# AI agents (Claude, ChatGPT, Cursor): add the
# API.SH MCP server https://api.sh/mcp - Create a free accountConfirm your email and get 1,000 free credits every month. No card needed.
- Create an API keyOne key works for all 918 platforms.
- Send the requestJSON back in one call. Add
output=csvoroutput=ndjsonfor files.
Why API.SH for Coles data
- Public data only: no Coles login, cookies or account needed
- One key and one response shape for Coles and 917 other platforms
- Built and maintained by API.SH, not third-party publishers
- Pay per call; errors on our side cost nothing
- No rate limits: run as many calls in parallel as you need
- Live status for every endpoint
API.SH vs the official Coles API
Coles has no open public API for product and price data; the Coles API pages in search results are integration agencies, unofficial wrappers and marketplace listings. API.SH needs no key from Coles and returns public coles.com.au data as JSON.
Skip reverse engineering the Coles app or paying for a RapidAPI listing: one API.SH key covers Coles, Woolworths and other supermarkets with the same JSON shape.
Coles API questions
What Coles data can I get?+
Product search with filters and sorts (/coles/v1/search), one product with price, specials, ingredients, nutrition and variants (/coles/v1/product), the category tree (/coles/v1/categories), category listings (/coles/v1/category) and this week's specials (/coles/v1/specials).
How much does the Coles API cost?+
Every Coles endpoint costs 1 credit per call. On a monthly plan 1,000 credits cost $1 (Starter is $50/month for 50,000 credits). Pay-as-you-go is $2 per 1,000 credits, with top-ups from $15 that never expire.
Is there a free trial?+
Yes. Every account gets 1,000 free credits every month. That is 1,000 calls to /coles/v1/categories at 1 credit each.
Is there an official Coles API?+
No. Coles does not offer a public developer API for product or price data. Projects on GitHub and RapidAPI are unofficial. API.SH returns the same public data as JSON with one key.
Do I need a Coles account or login?+
No. API.SH reads public coles.com.au pages only. No endpoint uses a Coles or Flybuys login.
How do I get started?+
Sign up at api.sh, copy your API key and call /coles/v1/search?q=milk. The docs at https://api.sh/docs show every parameter with a live example; there are SDKs, plus Google Sheets, Zapier, Make, n8n and an MCP server at https://api.sh/mcp.
Do I need a Coles API key?+
No Coles key is needed. You use your API.SH key in the x-api-key header, and the free monthly credits let you test every route.
Can I build a Coles price history tracker?+
Yes. Call search, category or product on a schedule and store price, was price and unit price with the date. Specials show what is on promotion each week.
Is scraping Coles legal?+
API.SH returns public product and review data that anyone can see on coles.com.au without an account. Use it for research, price tracking and analysis, and follow Coles's terms and the law where you operate, especially when you republish data.
Does the Coles API have a rate limit?+
No. API.SH puts no rate limit on your key: send as many Coles calls in parallel as you need and pay only for the calls that run. If Coles itself slows down, the call returns 503 with a retry-after header and is not charged.