Coles Scraper

ENDPOINTS
GET/products/bulk

Bulk Product Lookup

Price, specials, stock and categories for up to 20 products in a single call. Ideal for baskets and watch lists.

QUERY PARAMS

Comma-separated Coles product IDs or product URLs (up to 20).

Coles supermarket whose prices, stock and aisle locations you want. Accepts a store ID or any coles.com.au store URL. Find IDs with /stores/search.

Default: 584 (Coles Burwood East, VIC)

Examples:

  • ID: 4166
  • URL: https://www.coles.com.au/find-stores/coles/nsw/marrickville-4166
{
  "store_id": "584",
  "count": 3,
  "not_found_ids": [],
  "products": [
    {
      "id": 329607,
      "name": "Tim Tam Chocolate Biscuits Original",
      "brand": "Arnott's",
      "size": "200g",
      "description": "ARNOTTS CHOCOLATE BISCUITS:TIM TAM ORIGINAL:.:200GRAM",
      "link": "https://www.coles.com.au/product/arnott-s-tim-tam-chocolate-biscuits-original-200g-329607",
      "image": "https://cdn.productimages.coles.com.au/productimages/3/329607.jpg",
      "is_available": true,
      "availability_type": "InStoreAndOnline",
      "available_quantity": null,
      "is_sponsored": false,
      "pricing": {
        "currency": "AUD",
        "price": 6,
        "was_price": null,
        "save_amount": null,
        "save_percent": null,
        "unit_price": {
          "amount": 3,
          "quantity": 100,
          "unit": "g",
          "label": "$3.00/ 100g",
          "is_weighted": false
        },
        "is_on_special": false,
        "is_online_only_special": false,
        "promotion_type": null,
        "special_type": null,
        "price_description": null,
        "offer_description": null,
        "multi_buy": null
      },
      "categories": [
        {
          "department": {
            "id": "8916201",
            "name": "Chips, Chocolates & Snacks"
          },
          "category": {
            "id": "657638318",
            "name": "Biscuits & Cookies"
          },
          "subcategory": {
            "id": "657638597",
            "name": "Chocolate Biscuits"
          }
        }
      ],
      "merchandise_category": {
        "profit_centre": "GROCERY",
        "group": "IMPULSE",
        "category": "BISCUITS & COOKIES",
        "subcategory": "CHOCOLATE BISCUITS",
        "class": "CHOCOLATE BISCUITS"
      },
      "aisle_locations": [],
      "purchase_limits": {
        "retail_limit": 20,
        "promotional_limit": 12,
        "is_liquor_age_restricted": false,
        "is_tobacco_age_restricted": false,
        "delivery_restrictions": []
      },
      "minimum_shelf_life": null,
      "variation_count": null,
      "store_id": "584"
    },
    {
      "id": 1068870,
      "name": "Dairy Milk Chocolate Block",
      "brand": "Cadbury",
      "size": "315g",
      "description": "CADBURY DAIRY MILK LARGE CHOCOLATE BLOCK 315G",
      "link": "https://www.coles.com.au/product/cadbury-dairy-milk-chocolate-block-315g-1068870",
      "image": "https://cdn.productimages.coles.com.au/productimages/1/1068870.jpg",
      "is_available": true,
      "availability_type": "InStoreAndOnline",
      "available_quantity": null,
      "is_sponsored": false,
      "pricing": {
        "currency": "AUD",
        "price": 8.5,
        "was_price": null,
        "save_amount": null,
        "save_percent": 0,
        "unit_price": {
          "amount": 2.7,
          "quantity": 100,
          "unit": "g",
          "label": "$2.70/ 100g",
          "is_weighted": false
        },
        "is_on_special": true,
        "is_online_only_special": false,
        "promotion_type": "everyday",
        "special_type": null,
        "price_description": null,
        "offer_description": null,
        "multi_buy": null
      },
      "categories": [
        {
          "department": {
            "id": "8916201",
            "name": "Chips, Chocolates & Snacks"
          },
          "category": {
            "id": "657635263",
            "name": "Chocolates"
          },
          "subcategory": {
            "id": "657635638",
            "name": "Chocolate Blocks"
          }
        }
      ],
      "merchandise_category": {
        "profit_centre": "GROCERY",
        "group": "IMPULSE",
        "category": "CONFECTIONERY",
        "subcategory": "BLOCK CHOCOLATE",
        "class": "EVERYDAY"
      },
      "aisle_locations": [],
      "purchase_limits": {
        "retail_limit": 20,
        "promotional_limit": 12,
        "is_liquor_age_restricted": false,
        "is_tobacco_age_restricted": false,
        "delivery_restrictions": []
      },
      "minimum_shelf_life": null,
      "variation_count": null,
      "store_id": "584"
    },
    {
      "id": 5998852,
      "name": "Spread",
      "brand": "Vegemite",
      "size": "380g",
      "description": "VEGEMITE 380G",
      "link": "https://www.coles.com.au/product/vegemite-spread-380g-5998852",
      "image": "https://cdn.productimages.coles.com.au/productimages/5/5998852.jpg",
      "is_available": true,
      "availability_type": "InStoreAndOnline",
      "available_quantity": null,
      "is_sponsored": false,
      "pricing": {
        "currency": "AUD",
        "price": 7.7,
        "was_price": null,
        "save_amount": null,
        "save_percent": null,
        "unit_price": {
          "amount": 2.03,
          "quantity": 100,
          "unit": "g",
          "label": "$2.03/ 100g",
          "is_weighted": false
        },
        "is_on_special": false,
        "is_online_only_special": false,
        "promotion_type": null,
        "special_type": null,
        "price_description": null,
        "offer_description": null,
        "multi_buy": null
      },
      "categories": [
        {
          "department": {
            "id": "10302",
            "name": "Pantry"
          },
          "category": {
            "id": "8881200",
            "name": "Jams, Honey & Spreads"
          },
          "subcategory": {
            "id": "8881204",
            "name": "Savoury Spreads"
          }
        },
        {
          "department": {
            "id": "10302",
            "name": "Pantry"
          },
          "category": {
            "id": "7294",
            "name": "Breakfast"
          },
          "subcategory": {
            "id": "8883601",
            "name": "Family Favourites"
          }
        },
        {
          "department": {
            "id": "8904801",
            "name": "Back To School"
          },
          "category": {
            "id": "8908403",
            "name": "School Lunches"
          },
          "subcategory": {
            "id": "8908425",
            "name": "Sandwich & Wrap Essentials"
          }
        },
        {
          "department": {
            "id": "674112512",
            "name": "Health & Dietary"
          },
          "category": {
            "id": "674135336",
            "name": "Halal"
          },
          "subcategory": {
            "id": "675041078",
            "name": "Pantry"
          }
        }
      ],
      "merchandise_category": {
        "profit_centre": "GROCERY",
        "group": "MEAL SOLUTIONS",
        "category": "SPREADS",
        "subcategory": "SAVOURY",
        "class": "YEAST EXTRACTS"
      },
      "aisle_locations": [],
      "purchase_limits": {
        "retail_limit": 20,
        "promotional_limit": 12,
        "is_liquor_age_restricted": false,
        "is_tobacco_age_restricted": false,
        "delivery_restrictions": []
      },
      "minimum_shelf_life": null,
      "variation_count": null,
      "store_id": "584"
    }
  ]
}