Skip to content

Mercado Livre Product Details API

Scrape Mercado Livre product details instantly with a simple API call

Last Updated: February 10, 2025

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.

New! Scrape product data for multiple listings with Mercado Livre Product Scraper

We now offer a more convenient way to scrape product data from Mercado Livre using the Mercado Livre Product Scraper. This will be preferable if you want to scrape product data for multiple products at once. It can be used via API or our No-Code application. If speed is a priority and the attriubtes listed below are fine for your use-case than the API is fitting.

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'

1
2
3
4
5
import requests

url = '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'
response = requests.get(url)
print(response.json())

1
2
3
const response = await fetch('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')
const data = await response.json()
console.log(data)

1
2
3
4
5
6
<?php
$url = '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';
$response = file_get_contents($url);
$data = json_decode($response, true);
print_r($data);
?>

1
2
3
4
5
6
require 'net/http'
require 'uri'

uri = URI.parse('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')
response = Net::HTTP.get(uri)
puts response

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
name string Name of the product
url string URL of the product listing
image string URL of the product's main image
price float Current price of the product
listing_price float Original listing price
currency string Currency code (e.g. BRL)
currency_symbol string Currency symbol (e.g. R$)
brand string Brand of the product
description string Detailed description of the product
rating float Average rating out of 5
total_ratings integer Total number of ratings
images list List of product image URLs
specifications list Product specifications
features list Product features
reviews list Product reviews
is_available boolean Whether product is in stock
state string Condition of product (new/used)
sold_by string Name of the seller
seller_sales string Number of sales by seller
seller_labels list Seller status labels

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": {
        "name": "Shampoo Bio Extratus Jaborandi Crescimento Saudável 1l",
        "url": "https://www.mercadolivre.com.br/bioextratus-shampoo-jaborandi-antiqueda-1-litro-profissional/p/MLB19589845",
        "image": "https://http2.mlstatic.com/D_NQ_NP_925643-MLB69623845034_052023-F.webp",
        "price": 64.58,
        "listing_price": 82.8,
        "currency": "BRL",
        "currency_symbol": "R$",
        "brand": "Bio Extratus",
        "description": "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.   Modo 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.",
        "rating": 4.0,
        "total_ratings": 3,
        "images": [
            "https://http2.mlstatic.com/D_NQ_NP_925643-MLB69623845034_052023-F.webp"
        ],
        "specifications": [],
        "features": [],
        "reviews": [],
        "is_available": true,
        "state": "Novo",
        "sold_by": "Clique Bela",
        "seller_sales": "+10mil vendas",
        "seller_labels": [
            "MercadoLíder"
        ]
    },
    "remaining_credits": 1939054.0
}

Request Cost

10 credits are deducted for each successful request

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