Aldi Scraper

ENDPOINTS
GET/special-buys

Special Buys Calendar

Get the announced Special Buys on-sale dates and the themes of each.

QUERY PARAMS

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

{
  "country": "uk",
  "count": 7,
  "special_buys": [
    {
      "date": "2026-11-26",
      "title": "Thu 26th November",
      "on_sale_date": "2026-11-26",
      "is_on_sale": false,
      "themes": [
        {
          "name": "Black Friday",
          "slug": "black-friday"
        },
        {
          "name": "Gifts for Them",
          "slug": "gifts-for-them"
        },
        {
          "name": "Pamper & Party",
          "slug": "pamper-party"
        }
      ]
    },
    {
      "date": "2026-11-23",
      "title": "Mon 23rd November",
      "on_sale_date": "2026-11-23",
      "is_on_sale": false,
      "themes": [
        {
          "name": "Fresh Specials",
          "slug": "fresh-specials"
        }
      ]
    },
    {
      "date": "2026-11-22",
      "title": "Sun 22nd November",
      "on_sale_date": "2026-11-22",
      "is_on_sale": false,
      "themes": [
        {
          "name": "Beer",
          "slug": "beer"
        },
        {
          "name": "Christmas Treats",
          "slug": "christmas-treats"
        },
        {
          "name": "Plants & Flowers",
          "slug": "plants-flowers"
        }
      ]
    },
    {
      "date": "2026-11-19",
      "title": "Thu 19th November",
      "on_sale_date": "2026-11-19",
      "is_on_sale": true,
      "themes": [
        {
          "name": "Christmas Crafts",
          "slug": "christmas-crafts"
        },
        {
          "name": "Festive Fragrance",
          "slug": "festive-fragrance"
        },
        {
          "name": "Keep Cosy",
          "slug": "keep-cosy"
        },
        {
          "name": "Ski",
          "slug": "ski"
        },
        {
          "name": "Top Finds",
          "slug": "top-finds"
        }
      ]
    },
    {
      "date": "2026-11-15",
      "title": "Sun 15th November",
      "on_sale_date": "2026-11-15",
      "is_on_sale": true,
      "themes": [
        {
          "name": "Fireworks",
          "slug": "fireworks"
        },
        {
          "name": "Plants & Flowers",
          "slug": "plants-flowers"
        },
        {
          "name": "Specially Selected Festive Food",
          "slug": "specially-selected-festive-food"
        }
      ]
    },
    {
      "date": "2026-11-13",
      "title": "Fri 13th November",
      "on_sale_date": "2026-11-13",
      "is_on_sale": true,
      "themes": [
        {
          "name": "Aldi Next Big Seller",
          "slug": "aldi-next-big-seller"
        }
      ]
    },
    {
      "date": "2026-11-12",
      "title": "Thu 12th November",
      "on_sale_date": "2026-11-12",
      "is_on_sale": true,
      "themes": [
        {
          "name": "Breakfast",
          "slug": "breakfast"
        },
        {
          "name": "Christmas at Home",
          "slug": "christmas-at-home"
        },
        {
          "name": "Fresh Specials",
          "slug": "fresh-specials"
        },
        {
          "name": "Kevin and Friends",
          "slug": "kevin-and-friends"
        },
        {
          "name": "Soft Drinks",
          "slug": "soft-drinks"
        },
        {
          "name": "Toys, Games & Creativity",
          "slug": "toys-games-creativity"
        }
      ]
    }
  ]
}