Piloterr

Leroy Merlin Search

Live Leroy Merlin search results for a given keyword: title, URL, price, brand, seller, rating and pagination.

Credit cost: 3 credits per call

GET
/v2/leroymerlin/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

Search keyword used against the Leroy Merlin search engine. Matches product titles, brands and references on www.leroymerlin.fr.

Example:

colle pvc
page?number

1-based page number for pagination. Defaults to 1 when omitted. Use the pagination.total_pages returned by a previous call to iterate.

Example: 2

store_id?string

Optional Leroy Merlin store id to pin the search context to a specific physical store (impacts in-store availability and the ranking of local sellers). The id is validated against the Piloterr Leroy Merlin stores index. When omitted, the default Leroy Merlin store context is used.

Example: 110 (Balma - Toulouse)

return_page_source?boolean

When set to true, returns the raw HTML of the page instead of the parsed JSON payload. Useful for debugging or custom parsing. The response shape is {"return": "<html>..."}. Defaults to false.

Example: true

Default"false"

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.piloterr.com/v2/leroymerlin/search?query=string"
{
  "total": 21,
  "results": [
    {
      "sku": "67806074",
      "title": "Colle d'assemblage gel 604202 AXTON, 250ml, 250 g transparent",
      "url": "https://www.leroymerlin.fr/produits/colle-assemblage-gel-604202-axton-250ml-250-g-transparent-67806074.html",
      "brand": "AXTON",
      "position": 1,
      "price": 6.99,
      "price_excl_tax": 5.83,
      "currency": "EUR",
      "rating": 4.5,
      "total_offer_count": 1,
      "is_sponsored": false,
      "seller": {
        "name": "Leroy Merlin",
        "type": "1P"
      }
    },
    {
      "sku": "67805850",
      "title": "Colle en tube PVC AXTON, 60 ml",
      "url": "https://www.leroymerlin.fr/produits/colle-en-tube-pvc-axton-60-ml-67805850.html",
      "brand": "AXTON",
      "position": 2,
      "price": 3.59,
      "price_excl_tax": 2.99,
      "currency": "EUR",
      "rating": 4.4,
      "total_offer_count": 1,
      "is_sponsored": false,
      "marketing_tag": "RESPONSIBLE",
      "seller": {
        "name": "Leroy Merlin",
        "type": "1P"
      }
    },
    {
      "sku": "82345671",
      "title": "Colle néoprène multi-usages SADER, 250 ml",
      "url": "https://www.leroymerlin.fr/produits/colle-neoprene-multi-usages-sader-250-ml-82345671.html",
      "brand": "SADER",
      "position": 9,
      "price": 8.49,
      "price_excl_tax": 7.08,
      "currency": "EUR",
      "initial_price": 11.99,
      "discount": 3.5,
      "discount_rate": 29,
      "rating": 4.3,
      "total_offer_count": 4,
      "is_sponsored": false,
      "seller": {
        "name": "Bricomarket",
        "type": "3P"
      }
    }
  ],
  "pagination": {
    "current_page": 1,
    "total_pages": 41,
    "has_next": true,
    "has_previous": false
  }
}
{
  "error": "Bad Request"
}
{
  "error": "Invalid API Key"
}
{
  "error": "Payment required"
}
{
  "error": "Rate limit exceeded for the API key: quota monthly"
}
{
  "error": "Internal Error"
}