Aldi Search
Aldi Search API: list products from an Aldi category page URL or path across FR, DE, NL and Canarias shops. Returns prices, thumbnails and pagination.
Credit cost: 1 credit per call
Autorização
ApiKeyAuth x-api-key<token>
Your API key. Include it in the x-api-key header for every request.
In: header
Parâmetros de consulta
query*string
Aldi category page URL or site path.
Examples:
produits/viande-poisson/poisson-crustace.htmlhttps://www.aldi.fr/produits/viande-poisson/poisson-crustace.htmlUse Aldi Product on any result url for full PDP data.
region?string
Target country when query is a path only (default: fr).
Examples: de, nl, es-can
Ignored when query is a full Aldi URL.
page?number
1-based page number override (default: read from URL or 1).
Range
1 <= value <= 500return_page_source?boolean
When true, return the raw HTML page source as {"result": "..."} instead of structured JSON. Defaults to false.
Corpo da resposta
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v2/aldi/search?query=string"{ "results": [ { "url": "https://www.aldi.fr/fiches-produits/dos-de-cabillaud-9855.html", "brand": "GOLDEN SEAFOOD®", "price": 9.99, "title": "Dos de cabillaud", "images": [ "https://s7g10.scene7.com/is/image/aldinord/9855.main.01.freezer.gp2024", "https://s7g10.scene7.com/is/image/aldinord/Label_peche_durable_msc" ], "category": "Viandes et poissons > Poissons et crustacés", "currency": "EUR", "image_url": "https://s7g10.scene7.com/is/image/aldinord/9855.main.01.freezer.gp2024", "product_id": "9855", "sales_unit": "540G", "product_slug": "dos-de-cabillaud-9855", "short_description": "Régalez-vous avec notre délicieux dos de cabillaud…" } ], "pagination": { "next": null, "page": 1, "per_page": 46, "total_pages": 1, "total_results": 46 }}{ "error": "Bad Request"}{ "error": "Invalid API Key"}{ "error": "Payment required"}{ "error": "Rate limit exceeded for the API key: quota monthly"}{ "error": "Internal Error"}