Piloterr

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.

Credit cost: 1 credit per call

GET
/v2/aldi/search

Authorization

ApiKeyAuth
x-api-key<token>

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

In: header

Query Parameters

query*string

Aldi category page URL or site path.

Examples:

produits/viande-poisson/poisson-crustace.html
https://www.aldi.fr/produits/viande-poisson/poisson-crustace.html

Use 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).

Range1 <= value <= 500
return_page_source?boolean

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

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.piloterr.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"
}