Aldi Scraper

ENDPOINTS
GET/products/availability

Store Stock Availability

Check a product's stock level in one store or in the stores around a postcode, city or coordinates.

QUERY PARAMS

Aldi product ID or any Aldi product URL.

Examples:

  • ID: 000000000000387288 (leading zeros optional: 387288)
  • URL: https://www.aldi.co.uk/product/ashfields-extra-large-british-pork-loin-steaks-000000000000387288

Aldi publishes stock for part of its range only: products whose details show has_stock_information: true.

Where to look for stores: a postcode, a city or address, or latitude,longitude. Pass either location or store; omit both for the shop's default store.

Examples:

  • City: London
  • Postcode: SW1A 1AA
  • Coordinates: 51.5074,-0.1278

Store ID to check a single store. Pass either store or location. Get IDs from Search Stores.

Example: C254

Search radius around latitude,longitude coordinates, in the shop's distance unit (miles in the UK, kilometres elsewhere).

Default: 25

Allowed values: 1-500

Set true to return only stores that have the product in stock.

Default: false

Allowed values: true, false

Page number (10 results per page).

Default: 1

Allowed values: 1-50

Aldi shop to read.

Default: uk

Allowed values: uk (United Kingdom), au (Australia), ie (Ireland), de (Germany, ALDI SÜD), ch (Switzerland), hu (Hungary), si (Slovenia, HOFER)

A product or category link already names its shop, so it overrides this.

Language of names, descriptions and links. Only the Swiss shop has more than one (de, fr, it); every other shop is published in a single language, which is the default.

Allowed values: en, de, fr, it, hu, sl

{
  "count": 1,
  "per_page": 10,
  "current_page": 1,
  "total_pages": 1,
  "next": null,
  "previous": null,
  "product_id": "000000000000387288",
  "country": "uk",
  "distance_unit": "mi",
  "stores": [
    {
      "stock_level": "medium",
      "stock_note": null,
      "store": {
        "id": "C091",
        "name": "233 Newark Road",
        "distance": null,
        "services": [
          "walk-in"
        ],
        "address": {
          "line1": "233 Newark Road",
          "line2": null,
          "line3": null,
          "city": "Lincoln",
          "district": "Lincoln",
          "region": "Lincolnshire",
          "region_code": "LIN",
          "postcode": "LN5 8NT",
          "country": "United Kingdom",
          "country_code": "GB"
        },
        "coordinates": {
          "latitude": 53.2063,
          "longitude": -0.5508
        }
      }
    }
  ]
}