Skip to main content
Piloterr
Back to library

Mercado Livre Search API

Search Mercado Livre Brazil product listings by keyword and get title, price, seller, rating, condition, and shipping details as structured JSON in real time.

Private1 credit = 1 requestGET/v2/mercado/search

Endpoint Overview

Detailed documentation, pricing, and usage examples.

OverviewLink to Overview

Mercado Livre is Brazil's largest e-commerce marketplace, with over 140 million active users and tens of millions of product listings. The platform uses Cloudflare to block automated access. Piloterr routes each request through infrastructure that handles the bypass, so you receive paginated search results as structured JSON with a single GET call. No proxy management, no CAPTCHA solving, no parsing.

Each result includes the listing title, current price in BRL, instalment details, seller reputation level, shipping conditions, and buyer rating.

QuickstartLink to Quickstart

GET https://api.piloterr.com/v2/mercado/search?query=iphone+14

ParametersLink to Parameters

Parameter Type Required Description
query string yes Search keyword or phrase
category string no Mercado Livre category ID
condition string no new or used
min_price number no Minimum price in BRL
max_price number no Maximum price in BRL
sort string no Sort order for results
page integer no Page number

Response fieldsLink to Response fields

Field Type Description
results[].title string Listing title
results[].price number Current price in BRL
results[].condition string Item condition
results[].seller.reputation_level string Seller reputation badge
results[].rating.average number Average star rating
results[].shipping.free_shipping boolean Free shipping flag

Main use casesLink to Main use cases

  • Track real-time price changes on Mercado Livre for competitive pricing intelligence
  • Monitor seller reputation to identify key vendors in a product segment
  • Build a product comparison feed across Brazilian marketplaces
  • Detect discount campaigns by comparing current vs original price at scale
  • Enrich analytics dashboards with live Mercado Livre search data

Related APIs

Expand your data capabilities with these complementary tools.

Ready to get started?

Your web scraping API is one click away. Start with +500 credits, no infrastructure to set up, no proxies to manage, and no credit card required.

  • +500 credits
  • No credit card required
  • All endpoints included