Piloterr

Leroy Merlin Search

GET
/v2/leroymerlin/search

Live Leroy Merlin search across France and Romania: title, URL, price, currency, brand, seller, rating and pagination.

Credit cost: 3 credits 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

Search keyword, SKU/EAN, or full Leroy Merlin search URL.

Examples:

perceuse
bormasina
https://www.leroymerlin.ro/search?q=drill

When query is a full URL, region is detected from the domain and can be omitted.

region?string

Leroy Merlin country when query is a keyword or identifier (default: fr). Ignored when query is a full Leroy Merlin URL (country is detected from the domain).

Supported regions:

Examples:

fr
ro
romania
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 store id for local prices and availability. Must exist for the active region (FR stores with region=fr, RO stores with region=ro). Returns 400 when unknown.

Example: 110

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

Defaultfalse
fields?string

Comma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).

is_async?boolean

Run the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.

Defaultfalse
soft_fail?boolean

Return HTTP 200 even when the request fails; the error is in the error field of the body.

Defaultfalse

Response Body

Successful response

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