// docs

Leroy Merlin: Search products

Extracts searches and categories Leroy Merlin with prices, Pix, brand, image, pagination and ordering. Fields compatible with Mercado Livre and Magalu. 1 credit per page.

leroymerlin.com.br:plp · 1 credit per request

Standard credit cost. Your account pricing is shown in the sandbox.

Try this operation in the sandbox

Source-specific limitations

Uses the website default region (outros), without a CEP, and the web catalog price and availability filters. Ads are not included. URLs with unsupported refinements are rejected. Seller is not inferred when a card includes several sellers. price is the installment total and cashPrice the cash price. Example captured on 05/11/2026, with two items from the page. Price sorting preserves the native website ranking, which may differ from the returned regional prices.

HTTP request

cURL

curl -X POST https://api.geckoapi.com.br/v1/extract \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "target": "leroymerlin.com.br",
  "type": "plp",
  "keyword": "furadeira",
  "page": 1
}'

Keep your API key on your server. See the quickstart for authentication and response handling.

MCP request

The hosted MCP tool fixes target and type for this operation. Its remaining arguments use the same input rules as Extract.

POST /v1/mcp · Bearer or X-API-Key authentication

leroymerlin_com_br_plp · tools/call

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "leroymerlin_com_br_plp",
    "arguments": {
      "keyword": "furadeira",
      "page": 1,
      "executionId": "exec_example_123"
    }
  }
}

Supported inputs

Conditional fields depend on the alternatives and constraints in the rule column. Fields marked unsupported are omitted.

Field	Type	Requirement	Rule	Default	Example
url URL extraction target. For some PLPs it can be omitted when API assembles URL from other fields.	string (URL)	Optional	URL /search?term=TERMO or category without filters, such as /furadeiras. Accepts page, sortBy or order; Category filters and refinement parameters are not yet supported.	-	https://www.leroymerlin.com.br/furadeiras
keyword Keyword for PLP searches. In Google Search it represents the query sent to Google; in Booking PLP is mandatory; in other PLPs it can replace URL.	string	Optional	Mandatory without URL. Enter 1 and 200 characters. If shipped with URL, must match the term of URL.	-	furadeira
sort Ordering for VivaReal, Chaves na Mão, OLX and Webmotors PLP, Booking Review and Hotels Review. VivaReal: relevance/date/price/biggest_price/biggest_area. Webmotors: relevance/price/biggest_price/year_desc/mileage_asc. OLX: relevance/date/price/biggest_price/price_relevance. Booking/Hotels Review: most_relevant/newest_first/oldest_first/score_desc/score_asc.	"relevance" \| "date" \| "price" \| "biggest_price" \| "biggest_area" \| "price_relevance" \| "most_relevant" \| "newest_first" \| "oldest_first" \| "score_desc" \| "score_asc" \| "year_desc" \| "mileage_asc"	Optional	relevance, price or biggest_price. Without this field, preserve the ordering of URL. Uses the catalog's native ordering; the ranking may differ from a strict ordering by the regional prices returned.	-	price
target Target source for extraction.	enum	Required	Use leroymerlin.com.br.	leroymerlin.com.br	leroymerlin.com.br
type Extraction type: pdp, idp, plp, ilp, quote, review or places.	enum	Required	Use plp.	plp	plp
page Pagination. In PLP, including Trivago, and in Reclame AQUI ILP starts in 1; in review (MercadoLivre, Booking and Hotels) starts in 0. The Reclame AQUI ILP even accepts the page 100.	integer	Optional	Integer from 1 to 1000; overlays the URL page. The catalog may limit the number of accessible pages.	1	1

Request examples

Keyword search

Up to 36 products per page.

Keyword search

{
  "target": "leroymerlin.com.br",
  "type": "plp",
  "keyword": "furadeira",
  "page": 1
}

Next page sorted

{
  "target": "leroymerlin.com.br",
  "type": "plp",
  "keyword": "furadeira",
  "page": 2,
  "sort": "price"
}

Response schema

Leaf paths and expected types. Field names and enum values are part of the API contract.

responseSchema

{
  "requestId": "string",
  "executionId": "string",
  "data.source": "string",
  "data.type": "string",
  "data.extractedAt": "string",
  "data.region": "string",
  "data.url": "string",
  "data.requestUrl": "string",
  "data.query": "string | null",
  "data.page": "number",
  "data.totalResults": "number",
  "data.totalPages": "number",
  "data.resultsPerPage": "number",
  "data.offset": "number",
  "data.nextPage": "number | null",
  "data.nextPageUrl": "string | null",
  "data.breadcrumbs[].name": "string (optional)",
  "data.breadcrumbs[].url": "string (optional)",
  "data.items[].url": "string",
  "data.items[].offerUrl": "string | null",
  "data.items[].sku": "string",
  "data.items[].name": "string",
  "data.items[].brand": "string | null",
  "data.items[].price": "number | null",
  "data.items[].cashPrice": "number | null",
  "data.items[].regularPrice": "number | null",
  "data.items[].currency": "string",
  "data.items[].currencyRaw": "string",
  "data.items[].installmentPrice": "number | null",
  "data.items[].installmentCount": "number | null",
  "data.items[].imageUrl": "string | null",
  "data.items[].thumbnail": "string | null",
  "data.items[].ean": "string | null",
  "data.items[].sellerName": "string | null",
  "data.items[].sellerId": "string | null",
  "data.items[].aggregateRating": "object | null",
  "data.items[].availability": "string | null",
  "data.items[].freeShipping": "boolean | null"
}

Example response

Illustrative response. Product names, reviews and other source content retain their original language. Missing and null values do not imply zero stock, free shipping or zero reviews.

responseExample

{
  "requestId": "7d34e3ae-4f99-46ac-bc71-69d23ec822fe",
  "executionId": "cf5bd2ec-7531-42fa-9203-c08f6b4df945",
  "data": {
    "source": "leroymerlin.com.br",
    "type": "plp",
    "url": "https://www.leroymerlin.com.br/search?term=furadeira",
    "requestUrl": "https://www.leroymerlin.com.br/search?term=furadeira",
    "extractedAt": "2026-11-05T22:37:26.636Z",
    "region": "outros",
    "query": "furadeira",
    "page": 1,
    "totalResults": 358,
    "totalPages": 10,
    "resultsPerPage": 36,
    "offset": 0,
    "nextPage": 2,
    "nextPageUrl": "https://www.leroymerlin.com.br/search?term=furadeira&page=2",
    "breadcrumbs": [],
    "items": [
      {
        "url": "https://www.leroymerlin.com.br/furadeira-e-parafusadeira-de-impacto-wap-k21-id01-a-bateria-21v-3-8-com-maleta-carregador-e-bateria_92429330",
        "offerUrl": "https://www.leroymerlin.com.br/furadeira-e-parafusadeira-de-impacto-wap-k21-id01-a-bateria-21v-3-8-com-maleta-carregador-e-bateria_92429330",
        "sku": "92429330",
        "name": "Furadeira e Parafusadeira de Impacto Wap K21 ID01 a Bateria 21V 3/8\" com Maleta, Carregador e Bateria",
        "brand": "Wap",
        "price": 365.56,
        "cashPrice": 329,
        "regularPrice": 365.56,
        "currency": "BRL",
        "currencyRaw": "R$",
        "installmentPrice": 121.85,
        "installmentCount": 3,
        "imageUrl": "https://cdn.leroymerlin.com.br/products/parafusadeira_furadeira_wap_a_bateria_21v_3_8_bivolt_k21_id01_92429330_fe18_300x300.jpg",
        "thumbnail": "https://cdn.leroymerlin.com.br/products/parafusadeira_furadeira_wap_a_bateria_21v_3_8_bivolt_k21_id01_92429330_fe18_300x300.jpg",
        "ean": "7899831312634",
        "sellerName": null,
        "sellerId": null,
        "aggregateRating": null,
        "availability": "InStock",
        "freeShipping": false
      },
      {
        "url": "https://www.leroymerlin.com.br/furadeira-e-parafusadeira-de-impacto-dewalt-dcd7781d2-br-a-bateria-20v-brushless-1-2-com-maleta-carregador-e-2-baterias_91991312",
        "offerUrl": "https://www.leroymerlin.com.br/furadeira-e-parafusadeira-de-impacto-dewalt-dcd7781d2-br-a-bateria-20v-brushless-1-2-com-maleta-carregador-e-2-baterias_91991312",
        "sku": "91991312",
        "name": "Furadeira e Parafusadeira de Impacto Dewalt DCD7781D2-BR a Bateria 20V Brushless 1/2\" com Maleta Carregador e 2 Baterias",
        "brand": "Dewalt",
        "price": 1541.28,
        "cashPrice": 1541.28,
        "regularPrice": 0,
        "currency": "BRL",
        "currencyRaw": "R$",
        "installmentPrice": 192.66,
        "installmentCount": 8,
        "imageUrl": "https://cdn.leroymerlin.com.br/products/furadeira_parafusadeira_dewalt_20v_dcd7781d2_br___2_baterias_91991312_2864_300x300.jpg",
        "thumbnail": "https://cdn.leroymerlin.com.br/products/furadeira_parafusadeira_dewalt_20v_dcd7781d2_br___2_baterias_91991312_2864_300x300.jpg",
        "ean": "885911894074",
        "sellerName": null,
        "sellerId": null,
        "aggregateRating": null,
        "availability": "InStock",
        "freeShipping": false
      }
    ]
  }
}

Complete field reference

Path	Type	Description	Example
data.breadcrumbs[].name	string (optional)	Category consulted, when available.	N/A
data.breadcrumbs[].url	string (optional)	URL of the queried category.	N/A
data.extractedAt	string	Date and time UTC of extraction.	2026-11-05T22:37:26.636Z
data.items[].aggregateRating	object \| null	Not published in the catalog consulted; null.	null
data.items[].availability	string \| null	Published availability: InStock, OutOfStock or LimitedAvailability; null if missing.	InStock
data.items[].brand	string \| null	Brand name, as in PLP Magalu.	Wap
data.items[].cashPrice	number \| null	Published cash price, including Pix where indicated.	329
data.items[].currency	string	Currency code: BRL.	BRL
data.items[].currencyRaw	string	Currency symbol: R$.	R$
data.items[].ean	string \| null	EAN published by the page.	7899831312634
data.items[].freeShipping	boolean \| null	Free shipping on selected offer, when known; It is not a delivery quote.	false
data.items[].imageUrl	string \| null	Image of the card, as in PLP Mercado Livre.	https://cdn.leroymerlin.com.br/products/parafusadeira_furadeira_wap_a_bateria_21v_3_8_bivolt_k21_id01_92429330_fe18_300x300.jpg
data.items[].installmentCount	number \| null	Number of installments in the main condition.	3
data.items[].installmentPrice	number \| null	Value of each installment, as published.	121.85
data.items[].name	string	Full product name.	Furadeira e Parafusadeira de Impacto Wap K21 ID01 a Bateria 21V 3/8" com Maleta, Carregador e Bateria
data.items[].offerUrl	string \| null	URL, compatible with PLP Mercado Livre.	https://www.leroymerlin.com.br/furadeira-e-parafusadeira-de-impacto-wap-k21-id01-a-bateria-21v-3-8-com-maleta-carregador-e-bateria_92429330
data.items[].price	number \| null	Total published for purchase in installments; in its absence, current price.	365.56
data.items[].regularPrice	number \| null	Reference price before discount.	365.56
data.items[].sellerId	string \| null	There is no unequivocal identification of the seller of the offer on the card; null.	null
data.items[].sellerName	string \| null	Name when the catalog identifies only one seller; null if there are several.	null
data.items[].sku	string	Numeric product code in Leroy Merlin, such as string.	92429330
data.items[].thumbnail	string \| null	Same image on imageUrl, compatible with PLP Magalu.	https://cdn.leroymerlin.com.br/products/parafusadeira_furadeira_wap_a_bateria_21v_3_8_bivolt_k21_id01_92429330_fe18_300x300.jpg
data.items[].url	string	URL canonical product.	https://www.leroymerlin.com.br/furadeira-e-parafusadeira-de-impacto-wap-k21-id01-a-bateria-21v-3-8-com-maleta-carregador-e-bateria_92429330
data.nextPage	number \| null	Next page, or null.	2
data.nextPageUrl	string \| null	URL to request the next page, or null.	https://www.leroymerlin.com.br/search?term=furadeira&page=2
data.offset	number	Starting position of the page.	0
data.page	number	Current page, starting at 1.	1
data.query	string \| null	Keyword; null for category.	furadeira
data.region	string	Site default region: other, without CEP.	outros
data.requestUrl	string	URL normalized from the query.	https://www.leroymerlin.com.br/search?term=furadeira
data.resultsPerPage	number	Page size: up to 36 products.	36
data.source	string	Source site.	leroymerlin.com.br
data.totalPages	number	Number of accessible pages reported by the catalog.	10
data.totalResults	number	Total informed by the catalogue.	358
data.type	string	Extraction type.	plp
data.url	string	URL canonical product.	https://www.leroymerlin.com.br/search?term=furadeira
executionId	string	Execution identifier.	cf5bd2ec-7531-42fa-9203-c08f6b4df945
requestId	string	Request identifier.	7d34e3ae-4f99-46ac-bc71-69d23ec822fe

Errors and missing data

When supported by this operation, an entity not found upstream can return HTTP 200 with data: null and notFound: true. Check the documented response fields before interpreting an empty result. Source-specific behavior and exceptions are described above.

HTTP status	Error code	Meaning
400	`INVALID_PAYLOAD`	Invalid JSON or a request that violates the documented validation rules.
401	`UNAUTHORIZED`	Missing authorization or an invalid API key or token.
402	`INSUFFICIENT_CREDITS`	The account has insufficient credits for this operation.
403	`FORBIDDEN`	The account does not have access, or the API is temporarily disabled.
409	`EXECUTION_CONFLICT`	The execution identifier conflicts with an incompatible execution state.
429	`RATE_LIMIT_EXCEEDED / TOO_MANY_INFLIGHT_REQUESTS`	A rate limit or simultaneous request limit was exceeded.
5xx	`UPSTREAM_TIMEOUT / UPSTREAM_HTTP_ERROR / WORKER_FUNCTION_ERROR`	An upstream, worker or gateway failure. Failed requests follow the platform refund policy.

Other Leroy Merlin operations

Get product details (PDP)

Leroy Merlin: Search products

Source-specific limitations

HTTP request

MCP request

Supported inputs

Request examples

Keyword search

Category

Next page sorted

Response schema

Example response

Complete field reference

Errors and missing data

Other Leroy Merlin operations