Mercado Livre Sellers API
A GET
request to our endpoint /api/getter/?platform="mercado_sellers"
allows you to obtain information about all sellers offering a specific product on Mercado Livre.
New! Scrape all seller offers at once with Mercado Livre Price Offer Scraper
We now offer a more convenient way to scrape seller offers with the Mercado Livre Price Offer Scraper. This works better because it extracts all the seller offers for a product with a single request unlike this API which requires you to loop over the page numbers manually. It can be used via API or our No-Code application.
Example
To get seller information for a specific product, use the following command:
1 |
|
Note
Ensure to URL-encode the product URL and include the -L
option with curl
to handle redirects automatically.
Query Parameters
To retrieve seller information, the following query parameters are required:
Seller Query Parameters
url
Required
The URL of the product on Mercado Livre for which you want to retrieve seller information. Must be URL-encoded.
page
Optional
The page number of the search results to retrieve. Each page contains up to 10 sellers.
Other Required Parameters
platform
Required
The platform for which you want to retrieve seller information. Set this to mercado_sellers.
api_key
Required
Your unique API key, obtainable by registering on our platform.
Results
The response includes detailed information about each seller offering the specified product:
Attributes Returned | Data Type | Information Represented |
---|---|---|
price |
string | Price offered by the seller |
bulk_pricing |
string | Bulk pricing options, if available |
condition |
string | Condition of the product (e.g., New, Used) |
shipping |
string | Shipping options provided by the seller |
seller_name |
string | Seller's name or store name |
seller_id |
integer | Unique identifier for the seller |
offer_url |
string | URL of the seller's offer for the product |
sold_quantity |
integer | Number of units sold by the seller (null if not available) |
past_sales |
string | Indication of past sales volume by the seller |
seller_rating |
string | Seller's rating category on Mercado Livre, if available |
Response Example
Here's an example of what you can expect to receive for the request showcased above:
{
"success": true,
"product_url": "https://www.mercadolivre.com.br/kit-shampoo-condicionador-plastica-capilar-inoar-cicatrifios-squeeze-1l-cada/p/MLB19200337",
"product_image_url": "https://http2.mlstatic.com/D_Q_NP_901561-MLU74226103081_012024-O.webp",
"product_name": "Inoar kit shampoo + condicionador plástica capilar cicatrifios squeeze 1 litro cada",
"page": 1,
"no_of_pages": 4,
"result_count": 10,
"sellers": [
{
"price": "R$45,93",
"bulk_pricing": "Pague parcelado",
"condition": "Novo",
"shipping": "Envio para todo o país",
"seller_name": "SOFTMIX_",
"seller_id": 1052966817,
"offer_url": "https://www.mercadolivre.com.br/kit-shampoo-condicionador-plastica-capilar-inoar-cicatrifios-squeeze-1l-cada/p/MLB19200337?pdp_filters=seller_id:1052966817",
"sold_quantity": null,
"past_sales": "+50mil vendas",
"seller_rating": "MercadoLíder"
},
{
"price": "R$45,99",
"bulk_pricing": "12xR$4,46",
"condition": "Novo",
"shipping": null,
"seller_name": "Resilifarma",
"seller_id": 544554429,
"offer_url": "https://www.mercadolivre.com.br/kit-shampoo-condicionador-plastica-capilar-inoar-cicatrifios-squeeze-1l-cada/p/MLB19200337?pdp_filters=seller_id:544554429",
"sold_quantity": null,
"past_sales": "+100mil vendas",
"seller_rating": null
},
{
"price": "R$47,33",
"bulk_pricing": "12xR$4,59",
"condition": "Novo",
"shipping": "Envio para todo o país",
"seller_name": "PERFUMARIA_LUMISTORE",
"seller_id": 683859141,
"offer_url": "https://www.mercadolivre.com.br/kit-shampoo-condicionador-plastica-capilar-inoar-cicatrifios-squeeze-1l-cada/p/MLB19200337?pdp_filters=seller_id:683859141",
"sold_quantity": null,
"past_sales": "+10mil vendas",
"seller_rating": "MercadoLíder"
},
{
"price": "R$50",
"bulk_pricing": "12xR$4,86",
"condition": "Novo",
"shipping": null,
"seller_name": "Mambre Store",
"seller_id": 256658275,
"offer_url": "https://www.mercadolivre.com.br/kit-shampoo-condicionador-plastica-capilar-inoar-cicatrifios-squeeze-1l-cada/p/MLB19200337?pdp_filters=seller_id:256658275",
"sold_quantity": null,
"past_sales": "+10mil vendas",
"seller_rating": null
},
{
"price": "R$54,11",
"bulk_pricing": "Pague parcelado",
"condition": "Novo",
"shipping": "Envio para todo o país",
"seller_name": "L.ASHOPS",
"seller_id": 53516779,
"offer_url": "https://www.mercadolivre.com.br/kit-shampoo-condicionador-plastica-capilar-inoar-cicatrifios-squeeze-1l-cada/p/MLB19200337?pdp_filters=seller_id:53516779",
"sold_quantity": null,
"past_sales": "+10mil vendas",
"seller_rating": "MercadoLíder"
},
{
"price": "R$54,79",
"bulk_pricing": "Pague parcelado",
"condition": "Novo",
"shipping": null,
"seller_name": "G3COSMETICOS",
"seller_id": 7833368,
"offer_url": "https://www.mercadolivre.com.br/kit-shampoo-condicionador-plastica-capilar-inoar-cicatrifios-squeeze-1l-cada/p/MLB19200337?pdp_filters=seller_id:7833368",
"sold_quantity": null,
"past_sales": "+10mil vendas",
"seller_rating": "MercadoLíder"
},
{
"price": "R$54,90",
"bulk_pricing": "12xR$5,34",
"condition": "Novo",
"shipping": "Envio para todo o país",
"seller_name": "KDUSK_",
"seller_id": 1026261061,
"offer_url": "https://www.mercadolivre.com.br/kit-shampoo-condicionador-plastica-capilar-inoar-cicatrifios-squeeze-1l-cada/p/MLB19200337?pdp_filters=seller_id:1026261061",
"sold_quantity": null,
"past_sales": "+5mil vendas",
"seller_rating": "MercadoLíder"
},
{
"price": "R$54,90",
"bulk_pricing": "Pague parcelado sem juros",
"condition": "Novo",
"shipping": "Envio para todo o país",
"seller_name": "Resilifarma",
"seller_id": 544554429,
"offer_url": "https://www.mercadolivre.com.br/kit-shampoo-condicionador-plastica-capilar-inoar-cicatrifios-squeeze-1l-cada/p/MLB19200337?pdp_filters=seller_id:544554429",
"sold_quantity": null,
"past_sales": "+100mil vendas",
"seller_rating": null
},
{
"price": "R$54,99",
"bulk_pricing": "Pague parcelado",
"condition": "Novo",
"shipping": "Envio para todo o país",
"seller_name": "CMEMPORIUM",
"seller_id": 1474520743,
"offer_url": "https://www.mercadolivre.com.br/kit-shampoo-condicionador-plastica-capilar-inoar-cicatrifios-squeeze-1l-cada/p/MLB19200337?pdp_filters=seller_id:1474520743",
"sold_quantity": null,
"past_sales": "+50 vendas",
"seller_rating": null
},
{
"price": "R$55,90",
"bulk_pricing": "12xR$5,43",
"condition": "Novo",
"shipping": "Envio para todo o país",
"seller_name": "Olist",
"seller_id": 285668612,
"offer_url": "https://www.mercadolivre.com.br/kit-shampoo-condicionador-plastica-capilar-inoar-cicatrifios-squeeze-1l-cada/p/MLB19200337?pdp_filters=seller_id:285668612",
"sold_quantity": null,
"past_sales": "+100mil vendas",
"seller_rating": null
}
],
"message": null,
"remaining_credits": 646753
}
Request Cost
Each request to the Mercado Livre Sellers API costs 1 credit per seller returned in the response or 10 credits per request, whichever is higher.
Support
For additional parameters, questions, or feedback, please contact us at support@unwrangle.com.
This documentation is designed to provide all the necessary information to utilize the Mercado Livre Sellers API effectively. If there are any specific details or features you would like to see included or expanded upon, please let us know!