// docs

Leroy Merlin PLP

Extrai buscas e categorias Leroy Merlin com preços, Pix, marca, imagem, paginação e ordenação. Campos compatíveis com Mercado Livre e Magalu. 1 crédito por página.

Tempo de resposta: Usa a região padrão do site (outros), sem CEP, e os filtros de preço e disponibilidade do catálogo web. Não inclui publicidade. URLs com refinamentos não suportados são rejeitadas. Seller não é inferido quando o card contém vários vendedores. price é o total parcelado e cashPrice o preço à vista. Exemplo coletado em 05/11/2026, com dois itens da página. A ordenação por preço preserva o ranking nativo do site, que pode diferir dos preços regionais retornados.

Nota importante: alguns campos podem retornar null em produção, dependendo da página de origem. Consulte o schema e a descrição de cada campo para tratar valores ausentes; os exemplos mostram uma resposta possível.

Quando a entidade consultada não existe na origem, o extract e a tool MCP retornam 200 com data: null e notFound: true. Esse caso é tratado como resposta concluída, não como erro de servidor.

Chamada HTTP

cURL

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

Chamada MCP

A mesma seam também aparece no MCP hospedado como uma tool dedicada. Os argumentos reaproveitam os campos do extract, mas target e type já ficam fixos pela tool.

Ver guia completo do MCP

Endpoint

POST /v1/mcp

Tool name

leroymerlin_com_br_plp

Auth

Bearer ou X-API-Key

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"
    }
  }
}

Possibilidades de input

Campos suportados nesta API do POST /v1/extract, com regras específicas de obrigatoriedade e condicionais.

Campo	Tipo	Status	Regra	Default	Exemplo
url URL alvo da extração. Para alguns PLPs pode ser omitida quando a API monta a URL a partir de outros campos.	string (URL)	Opcional	URL /search?term=TERMO ou categoria sem filtros, como /furadeiras. Aceita page, sortBy ou order; filtros de categoria e parâmetros de refinamento ainda não são suportados.	-	https://www.leroymerlin.com.br/furadeiras
keyword Palavra-chave para buscas PLP. Em Google Search ela representa a query enviada ao Google; em Booking PLP é obrigatória; em outros PLPs pode substituir a URL.	string	Opcional	Obrigatória sem URL. Entre 1 e 200 caracteres. Se enviada com URL, precisa corresponder ao termo da URL.	-	furadeira
sort Ordenacao para VivaReal, Chaves na Mão, OLX e Webmotors PLP, Booking Review e Hoteis 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/Hoteis 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"	Opcional	relevance, price ou biggest_price. Sem este campo, preserva a ordenação da URL. Usa a ordenação nativa do catálogo; o ranking pode diferir de uma ordenação estrita pelos preços regionais retornados.	-	price
target Fonte alvo da extração.	enum	Obrigatório	Use leroymerlin.com.br.	leroymerlin.com.br	leroymerlin.com.br
type Tipo da extração: pdp, idp, plp, ilp, quote, review ou places.	enum	Obrigatório	Use plp.	plp	plp
page Paginacao. Em PLP, inclusive Trivago, e no Reclame AQUI ILP inicia em 1; em review (MercadoLivre, Booking e Hoteis) inicia em 0. O Reclame AQUI ILP aceita ate a pagina 100.	integer	Opcional	Inteiro de 1 a 1000; sobrepõe a página da URL. O catálogo pode limitar o número de páginas acessíveis.	1	1

Exemplos de request

Busca por palavra-chave

Até 36 produtos por página.

Busca por palavra-chave

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

Categoria

Consulta a categoria publicada pelo site.

Categoria

{
  "target": "leroymerlin.com.br",
  "type": "plp",
  "url": "https://www.leroymerlin.com.br/furadeiras"
}

Próxima página ordenada

Preserva a busca e solicita a segunda página por menor preço.

Próxima página ordenada

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

Schema de response (leaf paths)

Mapa de paths de saída com tipo esperado para esta API.

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"
}

Exemplo de response

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
      }
    ]
  }
}

Referência completa de campos

Path	Tipo	Descrição	Exemplo
data.breadcrumbs[].name	string (optional)	Categoria consultada, quando disponível.	N/A
data.breadcrumbs[].url	string (optional)	URL da categoria consultada.	N/A
data.extractedAt	string	Data e hora UTC da extração.	2026-11-05T22:37:26.636Z
data.items[].aggregateRating	object \| null	Não publicada no catálogo consultado; null.	null
data.items[].availability	string \| null	Disponibilidade publicada: InStock, OutOfStock ou LimitedAvailability; null se ausente.	InStock
data.items[].brand	string \| null	Nome da marca, como na PLP Magalu.	Wap
data.items[].cashPrice	number \| null	Preço à vista publicado, incluindo Pix quando indicado.	329
data.items[].currency	string	Código da moeda: BRL.	BRL
data.items[].currencyRaw	string	Símbolo da moeda: R$.	R$
data.items[].ean	string \| null	EAN publicado pela página.	7899831312634
data.items[].freeShipping	boolean \| null	Frete grátis da oferta selecionada, quando conhecido; não é cotação de entrega.	false
data.items[].imageUrl	string \| null	Imagem do card, como na 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	Quantidade de parcelas na condição principal.	3
data.items[].installmentPrice	number \| null	Valor de cada parcela, conforme publicado.	121.85
data.items[].name	string	Nome completo do produto.	Furadeira e Parafusadeira de Impacto Wap K21 ID01 a Bateria 21V 3/8" com Maleta, Carregador e Bateria
data.items[].offerUrl	string \| null	URL do produto, compatível com a 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 publicado para compra parcelada; na ausência dele, preço corrente.	365.56
data.items[].regularPrice	number \| null	Preço de referência anterior ao desconto.	365.56
data.items[].sellerId	string \| null	Não há identificação inequívoca do vendedor da oferta no card; null.	null
data.items[].sellerName	string \| null	Nome quando o catálogo identifica apenas um vendedor; null se houver vários.	null
data.items[].sku	string	Código numérico do produto na Leroy Merlin, como string.	92429330
data.items[].thumbnail	string \| null	Mesma imagem em imageUrl, compatível com a 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 canônica do produto.	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	Próxima página, ou null.	2
data.nextPageUrl	string \| null	URL para solicitar a próxima página, ou null.	https://www.leroymerlin.com.br/search?term=furadeira&page=2
data.offset	number	Posição inicial da página.	0
data.page	number	Página atual, começando em 1.	1
data.query	string \| null	Palavra-chave; null para categoria.	furadeira
data.region	string	Região padrão do site: outros, sem CEP.	outros
data.requestUrl	string	URL normalizada da consulta.	https://www.leroymerlin.com.br/search?term=furadeira
data.resultsPerPage	number	Tamanho da página: até 36 produtos.	36
data.source	string	Site de origem.	leroymerlin.com.br
data.totalPages	number	Quantidade de páginas acessíveis informada pelo catálogo.	10
data.totalResults	number	Total informado pelo catálogo.	358
data.type	string	Tipo de extração.	plp
data.url	string	URL canônica do produto.	https://www.leroymerlin.com.br/search?term=furadeira
executionId	string	Identificador da execução.	cf5bd2ec-7531-42fa-9203-c08f6b4df945
requestId	string	Identificador da requisição.	7d34e3ae-4f99-46ac-bc71-69d23ec822fe

Erros comuns

Respostas com notFound: true não entram nesta tabela, porque retornam sucesso HTTP 200.

Status	errorCode	Quando acontece
400	INVALID_PAYLOAD	JSON inválido ou violação das regras de validação do payload.
401	UNAUTHORIZED	Header Authorization ausente ou token/chave inválida.
402	INSUFFICIENT_CREDITS	Saldo de créditos insuficiente para a API solicitada.
403	FORBIDDEN	Usuário sem acesso ou API temporariamente desabilitada.
409	EXECUTION_CONFLICT	executionId conflita com uma execução em estado incompatível.
429	RATE_LIMIT_EXCEEDED / TOO_MANY_INFLIGHT_REQUESTS	Limite de taxa ou limite de requisições em voo excedido.
5xx	UPSTREAM_TIMEOUT / UPSTREAM_HTTP_ERROR / WORKER_INVOCATION_FAILED / WORKER_FUNCTION_ERROR / WORKER_INVALID_RESPONSE / INTERNAL_ERROR	Falha de servidor no worker, provider/proxy ou gateway. Nesses casos os créditos são estornados automaticamente.