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.

Example

To get seller information for a specific product, use the following command:

1
curl -v -L 'https://data.unwrangle.com/api/getter/?platform=mercado_sellers&url=https%3A%2F%2Fwww.mercadolivre.com.br%2Fbanho-de-creme-bio-extratus-umectante-oleo-de-coco-1kg%2Fp%2FMLB19513027&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 string Seller's name or store name
past_sales string Number of past sales by the seller
seller_rating string Seller's rating 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/banho-de-creme-bio-extratus-umectante-oleo-de-coco-1kg/p/MLB19513027",
    "product_image_url": "https://http2.mlstatic.com/D_Q_NP_996167-MLU72731731773_112023-O.webp",
    "product_name": "Banho De Creme Bio Extratus Umectante Óleo De Coco 1kg",
    "page": 1,
    "no_of_pages": 6,
    "result_count": 10,
    "sellers": [
        {
            "price": "R$48,30",
            "bulk_pricing": "Pague parcelado",
            "condition": "Novo",
            "shipping": null,
            "seller": "CHARMYPERFUMARIAECOSMETICOS",
            "past_sales": "+5mil vendas",
            "seller_rating": "MercadoLíder"
        },
        {
            "price": "R$50,91",
            "bulk_pricing": "Pague parcelado sem juros",
            "condition": "Novo",
            "shipping": "Envio para todo o país",
            "seller": "FARMILDISTRIBUIDORA",
            "past_sales": "+500 vendas",
            "seller_rating": "MercadoLíder"
        },
        {
            "price": "R$51,92",
            "bulk_pricing": "Pague parcelado",
            "condition": "Novo",
            "shipping": "Envio para todo o país",
            "seller": "Drogaria Nhá Chica",
            "past_sales": "+100mil vendas",
            "seller_rating": null
        },
        ...
        {
            "price": "R$58,90",
            "bulk_pricing": "Pague parcelado",
            "condition": "Novo",
            "shipping": "Envio para todo o país",
            "seller": "AUREA COSMETICOS",
            "past_sales": "+100 vendas",
            "seller_rating": null
        },
        {
            "price": "R$59,99",
            "bulk_pricing": "Pague parcelado",
            "condition": "Novo",
            "shipping": "Envio para todo o país",
            "seller": "DIVA COSMÉTICOSS",
            "past_sales": "+10mil vendas",
            "seller_rating": null
        }
    ],
    "remaining_credits": 631222
}

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!