Coles Australia - Full Catalog & Pricing Intelligence API
Live Coles Australia grocery data in one developer-friendly API. What this API covers: - Product search across the live Coles catalogue - Category browsing with normalized product output - Full product detail lookup by id, slug, or URL - Specials feeds including all specials, half-price, multi-buy, and online-only views - Barcode and GTIN product resolution - Coles store search, postcode lookup,…
Coles Australia - Full Catalog & Pricing Intelligence API endpoints
| Method | Endpoint | Description |
|---|---|---|
| Product Search & Catalog | ||
| GET |
GetColesCategoryProducts /coles/category |
Lists products inside a specific category path using its slug, ID, or a direct Coles URL. |
| GET |
GetColesCategories /coles/categories |
Returns the complete Coles category catalog as a flattened list, including full breadcrumb arrays. |
| GET |
SearchColesProducts /coles/search |
Searches the live Coles catalog by keyword. Supports pagination and limit controls. Use details=true to enrich results with item-level fields. |
| GET |
GetColesSearchFilters /coles/search/filters |
Fetches the active search filters and sorting options exposed by Coles for a specific keyword. |
| Specials & Promotions | ||
| GET |
GetColesSpecials /coles/specials |
Returns a paginated feed of currently active specials. Supports views like allspecials, halfprice, multibuy, and onlineonly. |
| GET |
GetColesCatalogueOffers /coles/specials/catalogue |
Parses Coles promotions or special event landing pages. Returns metadata and optional product hydration. |
| GET |
GetColesMultiBuySpecials /coles/specials/super |
A convenience route targeted at 'Buy 2 for $X' style multi-buy promotions. |
| GET |
GetColesHalfPriceSpecials /coles/specials/top |
A convenience route specifically filtered for Coles' popular weekly half-price specials. |
| GET |
GetColesSpecialsFilters /coles/specials/filters |
Pulls dynamic filter groups and sort options specifically applicable to the current set of specials. |
| Product Lookup & Identification | ||
| GET |
GetColesProductDetails /coles/item |
Fetches full details for a single product using its numeric ID, slug, or full URL. |
| GET |
ResolveColesGtin /coles/item/by-gtin |
An alias/alternative endpoint dedicated specifically to GTIN or barcode lookups. |
| GET |
ResolveColesBarcode /coles/item/by-barcode |
Resolves standard barcode, EAN, or GTIN values directly into a Coles online product. |
| Stores & Geolocation | ||
| GET |
SearchColesStores /coles/stores/search |
Searches Coles physical locations using a keyword (store name, suburb, or postcode). |
| GET |
FindColesStoresByPostcode /coles/stores/by-postcode |
Quick lookup to discover Coles branches within a specific radius of an Australian postcode. |
| GET |
FindNearbyColesStores /coles/stores/nearby |
Returns the closest Coles stores sorted by distance using explicit latitude and longitude input. |
| GET |
GetColesStoreDetails /coles/stores/item |
Fetches specific metadata for a store by ID, including address, phone, trading hours, and collection points. |
| Store-Aware Availability | ||
| GET |
GetColesStoreContext /coles/item/store-context |
Combines full product details with the resolved store stock/price data in a single payload. |
| GET |
CheckColesStoreAvailability /coles/availability/by-store |
Returns the definitive live stock status and effective price for a product at a designated store. |
| System | ||
| GET |
ProbeColesApi /coles/probe |
A lightweight health probe to ensure the upstream connection to Coles AU services is active and operating normally. |
Coles Australia - Full Catalog & Pricing Intelligence API pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | — |
|
| PRO | $9 / month | 3 / second |
|
| ULTRA | $29 / month | 3 / second |
|
| MEGA | $100 / month | — |
|