Mercado Libre
Product listings, product prices and seller ratings
Search public marketplace listings in Latin America.
Your information
Result order, for example “Price low to high”.
Words to search for, for example iphone 15.
Country name or two-letter code, for example Brazil or BR.
Listing condition, for example used.
Maximum listing price in the local currency, for example 2000.
Minimum listing price in the local currency, for example 500.
Most listings to return, for example 20.
Example results
Search results
About the Mercado Libre tool
Mercado Libre returns listings for a search query in one country, with optional condition, price, and sort filters.
Search products returns listing titles, prices, currencies, links, and available seller, rating, sales, and shipping details.
Built from mercadolibre.com and lista.mercadolivre.com.br. Last checked Sep 29, 2026.
Actions
Search products
1 creditSearch Mercado Libre listings in one country with condition, price and sort filters. Returns listings in site order; unavailable seller, rating, sales, or condition details are null.
Uses lista.mercadolivre.com.br.
What you provide
| Field | Type | Required | Description |
|---|---|---|---|
Sortsort | Text | Optional | Result order, for example price_low_to_high.Example: Price low to high |
Queryquery | Text | Required | Words to search for, for example iphone 15.Example: audifonos bluetooth |
Countrycountry | Text | Optional | Country name or two-letter code, for example Brazil or BR.Example: Mexico |
Conditioncondition | Text | Optional | Listing condition, for example used.Example: Used |
Max Pricemax_price | Number | Optional | Maximum listing price in the local currency, for example 2000.Example: 2000 |
Min Pricemin_price | Number | Optional | Minimum listing price in the local currency, for example 500.Example: 500 |
Max Resultsmax_results | Number | Optional | Most listings to return, for example 20.Example: 5 |
What you get
| Field | Type | Description |
|---|---|---|
Listingslistings | List | |
Pricelistings[].price | Number | Example: 500 |
Titlelistings[].title | Text | Example: Audífonos Inalambrios Mi True Wireless Earbuds Basic |
Currencylistings[].currency | Text | Example: MXN |
Conditionlistings[].condition | Text | Example: Used |
Image Linklistings[].image_link | Text | Example: https://http2.mlstatic.com/D_Q_NP_2X_881254-MLM42348841460_062020-E.webp |
Listing IDlistings[].listing_id | Text | Example: MLM788883103 |
Units Soldlistings[].units_sold | Number | |
Seller Namelistings[].seller_name | Text | Example: Apple |
Star Ratinglistings[].star_rating | Number | Example: 4.9 |
Installmentslistings[].installments | Text | Example: 4 meses sin intereses de $ 125 |
Listing Linklistings[].listing_link | Text | Example: https://www.mercadolibre.com.mx/audifonos-inalambrios--mi-true-wireless-earbuds… |
Free Shippinglistings[].free_shipping | Yes or no | Example: Yes |
Original Pricelistings[].original_price | Number | Example: 19999 |
Example result
For Sort: Price low to high, Query: audifonos bluetooth, Country: Mexico, Condition: Used, Max Price: 2000, Min Price: 500, Max Results: 5
{
"listings": [
{
"price": 500,
"title": "Audífonos Inalambrios Mi True Wireless Earbuds Basic",
"currency": "MXN",
"condition": "used",
"image_link": "https://http2.mlstatic.com/D_Q_NP_2X_881254-MLM42348841460_062020-E.webp",
"listing_id": "MLM788883103",
"units_sold": null,
"seller_name": null,
"star_rating": null,
"installments": "4 meses sin intereses de $ 125",
"listing_link": "https://www.mercadolibre.com.mx/audifonos-inalambrios--mi-true-wireless-earbuds--basic/up/MLMU997630020?pdp_filters=price%3A500-2000",
"free_shipping": true,
"original_price": null
},
{
"price": 500,
"title": "Refacciones Sony Sve141d11u Sve141l11u Sve14111el Sve14111ew",
"currency": "MXN",
"condition": "used",
"image_link": "https://http2.mlstatic.com/D_Q_NP_2X_771143-MLM44115284258_112020-E.webp",
"listing_id": "MLM841090802",
"units_sold": null,
"seller_name": null,
"star_rating": null,
"installments": "3 meses sin intereses de $ 166 . 67",
"listing_link": "https://www.mercadolibre.com.mx/refacciones-sony-sve141d11u-sve141l11u-sve14111el-sve14111ew/up/MLMU723303359?pdp_filters=price%3A500-2000",
"free_shipping": true,
"original_price": null
},
{
"price": 500,
"title": "Audífonos Inalámbricos Buen Sonido Marca Sony",
"currency": "MXN",
"condition": "used",
"image_link": "https://http2.mlstatic.com/D_Q_NP_2X_796429-MLM117884066195_092026-E.webp",
"listing_id": "MLM849538987",
"units_sold": null,
"seller_name": null,
"star_rating": null,
"installments": "3 meses sin intereses de $ 166 . 67",
"listing_link": "https://www.mercadolibre.com.mx/audifonos-inalambricos-buen-sonido-marca-sony/up/MLMU541636308?pdp_filters=price%3A500-2000",
"free_shipping": true,
"original_price": null
}
]
}For developers
Call it from your code with one request. Change the values in input to run it on new data. To get an API key, open Developers at the bottom of Studio, turn on Developer mode and go to API keys.
curl 'https://api.fous.com/v1/query' \
--fail-with-body --silent --show-error --max-time 180 \
-H "Authorization: Bearer YOUR_API_KEY" \
-H 'Content-Type: application/json' \
--data-raw '{
"api": "@mercado-libre",
"visibility": "public",
"operation": "search_products",
"version": 1,
"input": {
"sort": "price_low_to_high",
"query": "audifonos bluetooth",
"country": "Mexico",
"condition": "used",
"max_price": 2000,
"min_price": 500,
"max_results": 5
},
"response": {
"format": "json"
}
}'What you can do with it
- Compare product prices across listings
- Find used products within a price range
- Review listing titles, sellers, and ratings
- Track available shipping and installment details
Questions about Mercado Libre
Can I run it with my own inputs?
Yes. Change the inputs in Studio and press Run, or send new inputs from your code, or ask a connected AI assistant.
Can I call this Mercado Libre tool as an API?
Yes. Send a POST request to /v1/query with your Fous API key and the inputs, and get JSON back.
How much does it cost?
Each completed run costs 1 credit. Failed runs without a completed receipt are free; completed work can remain charged if delivery is interrupted. With pay as you go, a credit costs 1¢. Monthly plans cost less per credit.
Do I need a Mercado Libre account?
No. You only need a Fous account.
How current is the data?
Fous gets the data from mercadolibre.com when you run it. Some results are reused for up to 24 hours, and results that use your account or key are never reused. It was last verified on Sep 29, 2026.
What listings match a product search?
Search products returns listings matching the required query in a selected country.
Can I filter listings by condition or price?
Yes. Search products accepts condition, minimum price, and maximum price filters.
What details are returned for each listing?
Search products can return price, currency, title, condition, seller, rating, units sold, shipping, and listing links. Some details may be null.