Skip to main content
Network status
Log in
Piloterr
Back to library

Aldi Product API

Aldi Product API — fetch full product page data from an Aldi URL or path slug. Returns pricing, images, description, category and cooling flags via Next.js __NEXT_DATA__ parsing.

Active1 credit = 1 requestGET/v2/aldi/product
Try endpoint for freePiloterr

Endpoint Overview

Detailed documentation, pricing, and usage examples.

OverviewLink to Overview

The Aldi Product API returns full product page data from Aldi online shops. Pass a product URL or path slug, optionally with region, and receive structured JSON with pricing, images, description, category, and cooling flags.

Piloterr parses the Next.js SSR payload (#__NEXT_DATA__) from the HTML — no browser rendering required.

Use Aldi Search to discover listings, then Aldi Product for the full record.

Supported regionsLink to Supported regions

Default: fr → www.aldi.fr.

region Domain Product URL pattern Aliases
fr aldi.fr /fiches-produits/{slug}.html fr-fr
de aldi-nord.de /p/{slug}.html de-de, aldi-nord
nl aldi.nl /product/{slug}.html nl-nl
es-can aldi.es/can/… /can/producto/{slug}.html can, canarias

Numeric product id alone (6806) is not supported — pass a full URL or slug path.

QuickstartLink to Quickstart

GET https://api.piloterr.com/v2/aldi/product?query=fiches-produits/filets-danchois-marines-6806.html
GET https://api.piloterr.com/v2/aldi/product?query=https://www.aldi.fr/fiches-produits/filets-danchois-marines-6806.html
GET https://api.piloterr.com/v2/aldi/product?query=/p/example-slug-1234.html&region=de

ParametersLink to Parameters

Parameter Type Required Description
query string yes Product URL or site path slug
region string no Country when query is a path only (default: fr)
return_page_source boolean no Raw HTML as {"result": "..."} (default: false)

Response fieldsLink to Response fields

Field Type Description
product_id string Aldi product id
title string Product title
url string Canonical product URL
image_url string | null Main image
images string[] | null Ordered gallery
price number | null Current price (currentPrice.priceValue)
currency string ISO currency
brand string | null Brand name
sales_unit string | null Pack size / unit
short_description string | null Card teaser text
description string | null Long description
category string | null mainCategoryID when breadcrumb unavailable
product_slug string | null URL slug
is_cooling boolean | null Chilled / frozen product flag

Aldi workflowLink to Aldi workflow

  1. Aldi Search — list category products
  2. Aldi Product — full PDP JSON (this endpoint)

Error codesLink to Error codes

Code Meaning
400 Missing or invalid query, unsupported domain, or numeric id only
404 Page without #__NEXT_DATA__ or unparsable product
500 Network or parsing error

NotesLink to Notes

  • Search category uses Algolia breadcrumbs; product category may show raw mainCategoryID (e.g. 73-poisson).
  • Canarias product URLs must stay under /can/ on aldi.es.
  • Costs 1 credit per call (HTTP crawler).

Main use casesLink to Main use cases

  • PDP enrichment — description, gallery, cooling flag
  • Price monitoring — track Aldi shelf prices by region
  • Assortment intel — brand, unit, category metadata

Related APIs

Expand your data capabilities with these complementary tools.

View All
Aldi Search/v2/aldi/search

Aldi Search API — list products from an Aldi category page URL or path across FR, DE, NL and Canarias shops. Parses Next.js __NEXT_DATA__ Algolia SSR payload; returns prices, thumbnails and pagination.

GET1 credit = 1 requestActive

Ready to get started?

Your web scraping API is one click away. Start with +500 credits, no infrastructure to set up, no proxies to manage, and no credit card required.

  • +500 credits
  • No credit card required
  • All endpoints included
Start free (+500 credits)PiloterrTalk to a data expert