Piloterr

Aldi Product

GET
/v2/aldi/product

Aldi Product API: fetch full product page data from an Aldi URL or path slug. Returns pricing, images, description, category and cooling flags.

Credit cost: 1 credit per call

Authorization

ApiKeyAuth
headerx-api-key<token>

Your API key. Include it in the x-api-key header for every request.

Query Parameters

query*string

Aldi product page URL or site path slug.

Examples:

fiches-produits/filets-danchois-marines-6806.html
https://www.aldi.fr/fiches-produits/filets-danchois-marines-6806.html

Numeric product id alone is not supported: use URL or slug path.

region?string

Target country when query is a path only (default: fr). Ignored for full product URLs.

return_page_source?boolean

When true, return the raw HTML page source as {"result": "..."} instead of structured JSON. Defaults to false.

Response Body

Successful response

application/json
  1. response
url?string
brand?string
price?number
title?string
images?array<string>
category?string
currency?string
image_url?string
is_cooling?boolean
product_id?string
sales_unit?string
description?string
product_slug?string
short_description?string
Example Request
curl -X GET 'https://api.piloterr.com/v2/aldi/product?query=string'
Example Response
{  "url": "https://www.aldi.fr/fiches-produits/filets-danchois-marines-6806.html",  "brand": "GOLDEN SEAFOOD®",  "price": 1.99,  "title": "FILETS D'ANCHOIS MARINÉS",  "images": [    "https://s7g10.scene7.com/is/image/aldinord/6806.main.1.fr_fr.All.anchois",    "https://s7g10.scene7.com/is/image/aldinord/6806_FILETS_ANCHOIS_MARINES_AIL"  ],  "category": "73-poisson",  "currency": "EUR",  "image_url": "https://s7g10.scene7.com/is/image/aldinord/6806.main.1.fr_fr.All.anchois",  "is_cooling": true,  "product_id": "6806",  "sales_unit": "100 g",  "description": "Pêche durable selon le référentiel MSC.",  "product_slug": "filets-danchois-marines-6806",  "short_description": "Au choix : Nature, ail et persil ou à la provençale."}