aldi.co.uk APIaldi.co.uk ↗
Access Aldi UK product data via API. Search products, fetch details by SKU, browse the category tree, and retrieve autocomplete suggestions.
curl -X GET 'https://api.parse.bot/scraper/35841d28-d858-4269-b5f4-c68b0f46596f/search_products' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products on Aldi UK by keyword query and/or category. Returns paginated results with product details, pricing, and available facets for filtering.
| Param | Type | Description |
|---|---|---|
| sort | string | Sort order. Accepts exactly one of: relevance, name_asc, name_desc, price_asc, price_desc. |
| limit | integer | Number of results per page. Accepts exactly one of: 12, 16, 24, 30, 32, 48, 60. |
| query | string | Search query text. At least one of query or category_key must be provided. |
| offset | integer | Pagination offset (number of results to skip). |
| category_key | string | Category key to filter products. Obtain from get_categories endpoint (e.g. '1588161416978053003' for Chocolate & Sweets). At least one of query or category_key must be provided. |
| service_point | string | Store service point code determining product availability and pricing. |
{
"type": "object",
"fields": {
"facets": "array of filter facets (category-tree, theme, brand-name)",
"products": "array of product objects with sku, name, brandName, price, categories, assets, badges",
"pagination": "object with offset, limit, totalCount"
},
"sample": {
"facets": [
{
"name": "brand-name",
"values": [
{
"key": "DAIRYFINE",
"label": "DAIRYFINE",
"docCount": 47
}
],
"localizedName": "Brand"
}
],
"products": [
{
"sku": "000000000589532003",
"name": "Milk Chocolate Belgian Chocolate Waves",
"price": {
"amount": 229,
"currencyCode": "GBP",
"comparisonDisplay": "£18.32/1 KG",
"amountRelevantDisplay": "£2.29"
},
"assets": [
{
"url": "https://dm.emea.cms.aldi.cx/is/image/aldiprodeu/product/jpg/scaleWidth/{width}/4e8aeb79-87e9-417c-a176-5482ba8c33db/{slug}",
"maxWidth": 1500
}
],
"badges": [],
"brandName": "DAIRYFINE",
"categories": [
{
"id": "1588161416978053",
"name": "Food Cupboard"
},
{
"id": "1588161416978053003",
"name": "Chocolate & Sweets"
}
],
"sellingSize": "0.125 KG",
"urlSlugText": "dairyfine-milk-chocolate-belgian-chocolate-waves"
}
],
"pagination": {
"limit": 12,
"offset": 0,
"totalCount": 263
}
}
}About the aldi.co.uk API
The Aldi UK API covers 4 endpoints for querying the aldi.co.uk product catalog, including search_products for keyword and category-based browsing, get_product_details for SKU-level data, get_categories for the full hierarchical category tree, and search_suggestions for autocomplete. Each product response includes SKU, brand name, pricing, image assets, badges, and category assignments.
Search and Browse Products
The search_products endpoint accepts a query string, a category_key from the category tree, or both. Results are paginated via offset and limit (valid values: 12, 16, 24, 30, 32, 48, 60) and can be sorted by relevance, name, or price using the sort parameter. The response includes a products array — each item carrying sku, name, brandName, price, categories, assets, and badges — plus a pagination object (offset, limit, totalCount) and facets for further filtering by category-tree, theme, or brand-name.
Product Details and SKU Lookup
get_product_details accepts a comma-separated skus string, allowing you to fetch data for one or multiple products in a single call. SKU codes are returned by search_products and search_suggestions. The response shape matches the search result items: sku, name, brandName, price, categories, assets, and badges. Both endpoints accept an optional service_point parameter, a store code that affects which products appear and what prices are shown — useful when building localised or store-specific experiences.
Category Tree and Autocomplete
get_categories returns the full Aldi UK category hierarchy: top-level category objects each include a key, name, urlSlugText, and a children array for subcategories. The key values feed directly into search_products as category_key. The search_suggestions endpoint takes a partial query string and returns three lists: completions (suggested search terms), products (matching items with name, SKU, brand, and price), and categories (matching categories with name, categoryKey, and docCount). This makes it straightforward to replicate Aldi's live search-as-you-type behaviour.
- Track price changes on specific Aldi UK products by polling get_product_details with saved SKUs.
- Build a grocery price comparison tool using search_products with price_asc sorting across multiple retailers.
- Populate a localised product catalogue by passing a service_point code to filter availability by store.
- Implement a search autocomplete widget using search_suggestions completions and product results.
- Index the full Aldi UK product range by walking the category tree from get_categories and paginating search_products per category.
- Monitor Aldi's promotional badges to detect special-offer products within a product category.
- Feed a meal-planning app with grocery item data including brand names and category assignments from search results.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Aldi UK have an official public developer API?+
What does the service_point parameter do, and when should I use it?+
Does the API return stock availability or inventory levels?+
How does pagination work in search_products?+
offset (number of results to skip) and limit (results per page) parameters. The response includes a pagination object with offset, limit, and totalCount, so you can calculate how many pages exist and iterate through the full result set. Valid limit values are fixed: 12, 16, 24, 30, 32, 48, or 60.