Skip to content

Mercado Livre Product Details API

A GET request to our /api/getter/?platform="mercado_detail" endpoint allows you to extract product data for any product listing URL on Mercado Livre's marketplace in real-time.

Example

To scrape details about a shampoo product from Mercado Livre, you can use the following command:

1
curl -L 'https://data.unwrangle.com/api/getter/?platform=mercado_detail&url=https%3A%2F%2Fproduto.mercadolivre.com.br%2FMLB-3670297668-shampoo-bio-extratus-jaborandi-crescimento-saudavel-1l-_JM&api_key=API_KEY'

Note

When using curl, it is necessary to add the option -L to get the data back. This is because in some cases our server responds with a 301 and curl does not follow the redirect by default.

Query Parameters

As you can see in the example above, our endpoint needs the following query parameters:

Product URL

url

Required

Product listing's URL on Mercado Livre. Remove unnecessary query parameters and encode the URL.

Other Required Parameters

platform

Required

Specifies the scraping engine you wish to invoke. In this case, the value should be mercado_detail.

api_key

Required

Your account's token—which can be obtained by signing up here.

Note

The value of the query parameter url must be URL or percent encoded. If you're using Python, this can be done with the function urlencode.

Results

The response will include the following attributes for the product:

Attributes Returned Data Type Information Represented
producto string Name of the product
producto_url string URL of the product listing
imagen_url string URL of the product's main image
precio string Price of the product
estado string Condition of the product (new/used)
marca string Brand of the product
descripcion string Description of the product
vendido_por string Name of the seller
seller_sales string Number of sales made by the seller
seller_info list Additional information about the seller

Response Example

Here's an example of the response you can expect to receive for the request showcased above:

{
    "success": true,
    "product_url": "https://produto.mercadolivre.com.br/MLB-3670297668-shampoo-bio-extratus-jaborandi-crescimento-saudavel-1l-_JM",
    "result_count": 1,
    "detail": {
        "producto": "Shampoo Bio Extratus Jaborandi Crescimento Saudável 1l",
        "producto_url": "https://www.mercadolivre.com.br/bioextratus-shampoo-jaborandi-antiqueda-1-litro-profissional/p/MLB19589845",
        "imagen_url": "https://http2.mlstatic.com/D_Q_NP_925643-MLB69623845034_052023-R.webp",
        "precio": "R$69.89",
        "estado": "Novo",
        "marca": "Bio Extratus",
        "descripcion": "Limpa e revitaliza o cabelo. A associação balanceada dos extratos e vitaminas nutre o bulbo capilar e tonifica o couro cabeludo, proporcionando força e saúde ao cabelo. pH 6,0.\n \nModo de usar: Distribua uniformemente sobre o cabelo molhado, massageando suavemente sem esfregar os fios. Enxágue bem e, se necessário, repita a aplicação.",
        "vendido_por": "Clique Bela",
        "seller_sales": "+10mil",
        "seller_info": [
            "MercadoLíder Platinum",
            "É um dos melhores do site!",
            "Vendas concluídas",
            "Ofereça um bom atendimento"
        ]
    },
    "remaining_credits": 600746
}

Request Cost

Each request to this endpoint costs 10 credits.

Support

If you want to add a parameter to our response, or have any question or feedback, please write to us at support@unwrangle.com