Skip to content

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
curl 'https://data.unwrangle.com/api/getter/?platform=mercado_sellers&url=https%3A%2F%2Fwww.mercadolivre.com.br%2Fkit-shampoo-condicionador-plastica-capilar-inoar-cicatrifios-squeeze-1l-cada%2Fp%2FMLB19200337&page=1&api_key=API_KEY'

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!