Coles+API.SH

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
Search Coles products
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}
1 credit · $1 per 1,000 calls

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 category tree/coles/v1/categories
count1
categories[]id · name · slug · level · product_count · type · url · children
Coles category products/coles/v1/category
page1limit48total203count54next_page2
category[]id · name · slug · url
applied_filters[]sort
facets[]name · values
categories[]id · name · slug · count
Coles product/coles/v1/product
id8150288urlhttps://www.coles.com.au/product…nameFull Cream MilkbrandColesdescriptionCOLES FULL CREAM MILK 3Lsize3Lprice4.95currencyAUDunit_price1.65unit_measure1Lunit_price_text$1.65/ 1Lweightedfalseonline_specialfalseavailabletruesponsoredfalsemin_guaranteeLife 7 days minretail_limit20promotional_limit12
category[]department · department_id · category · category_id · aisle · aisle_id

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 and discovery1
Search Coles products
/coles/v1/search
params q +8 optionaldocstry
$1 · $2 PAYG
1 credit
Products, listings and places2
Coles category products
/coles/v1/category
params id +8 optionaldocstry
$1 · $2 PAYG
1 credit
Coles product
/coles/v1/product
params id +2 optionaldocstry
$1 · $2 PAYG
1 credit
More data3
Coles category tree
/coles/v1/categories
params none required +1 optionaldocstry
$1 · $2 PAYG
1 credit
Coles specials
/coles/v1/specials
params none required +9 optionaldocstry
$1 · $2 PAYG
1 credit
Coles store finder
/coles/v1/stores
params none required +3 optionaldocstry
$1 · $2 PAYG
1 credit

Call the Coles API

Search Coles products: GET https://api.api.sh/coles/v1/search

curl "https://api.api.sh/coles/v1/search?q=milk" \
  -H "x-api-key: $APISH_KEY"
  1. Create a free accountConfirm your email and get 1,000 free credits every month. No card needed.
  2. Create an API keyOne key works for all 918 platforms.
  3. Send the requestJSON back in one call. Add output=csv or output=ndjson for 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.

More e-commerce APIs all e-commerce APIs →

Start with 1,000 free credits
Every month, on every account. One key works for all 918 platforms.
Get a free API key