Mercado Livre

API de produto do Mercado Livre

Um produto de catálogo ou anúncio do Mercado Livre por URL, product_id ou item_id: título, preço, preço de lista e desconto, parcelas, promoções, o vendedor do buy box com o nível de reputação e a categoria do vendedor, estoque, frete, unidades vendidas como valor mínimo, nota com a distribuição de estrelas, variações com os product ids irmãos, ficha técnica, descrição, fotos e categorias. Custa 2 créditos por requisição.

POST/api/v1/mercadolibre/product

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).

Body

application/json

product_idstring

Id do produto de catálogo, como a busca o retorna em product_id (ou numa URL /p/). O prefixo define o país: MLM México, MLB Brasil, MLA Argentina, MCO Colômbia. Passe exatamente um entre product_id, item_id ou url.

Example: MLM1027172667

item_idstring

Id do item (anúncio), como a busca o retorna em item_id. MLM-3571336480 também é aceito.

Example: MLM3571336480

urlstring

Uma URL de produto (/p/), de user product (/up/) ou de página de anúncio do Mercado Libre ou do Mercado Livre de um país suportado.

Example: https://www.mercadolibre.com.mx/apple-iphone-15-128-gb-azul-distribuidor-autorizado/p/MLM1027172667

Notes

Só o vendedor do buy box. seller é o vendedor que está ganhando o buy box no momento, com seller_id, apelido, nível de reputação, categoria do vendedor (power_seller_status) e rótulo de vendas. A lista de todos os outros vendedores que oferecem o mesmo produto de catálogo não está disponível. Passe seller.seller_id para a Busca para listar o catálogo desse vendedor.

Unidades vendidas são valores mínimos. sold_quantity_min é a faixa que o Mercado Livre mostra (1000 para "+1000 vendidos"), não um número exato; sold_label é o texto como aparece.

Não há parâmetro de país: o prefixo do id (ou o domínio da URL) o define. MLM é México, MLB Brasil, MLA Argentina, MCO Colômbia. Ids do Chile (MLC) retornam 400.
rating.distribution e rating.count são os totais de avaliações; Avaliações pagina o texto das avaliações.
variations lista cada opção (cor, tamanho, capacidade) com o product_id irmão para pedir em seguida.
category_id alimenta Mais vendidos, e best_seller_position vem preenchido quando o produto está no ranking da categoria.
Alguns campos são null quando o anúncio não os mostra (aqui, brand e user_product_id). Os preços vêm na moeda do site, com casas decimais quando o site as mostra.
Um id que não existe retorna 404 e é cobrado. Falhas temporárias (502/503) nunca são cobradas.

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")

res = client.mercadolibre.product(product_id="MLM1027172667")

p = res["data"]
print(p["title"], p["price"], p["currency"], p["sold_label"])
print("Buy box:", p["seller"]["nickname"], p["seller"]["reputation_level"])
print("Stars:", p["rating"]["average"], p["rating"]["distribution"])

Response

"country": "mx",

"site_id": "MLM",

"product_id": "MLM1027172667",

"item_id": "MLM3571336480",

"user_product_id": null,

"url": "https://www.mercadolibre.com.mx/apple-iphone-15-128-gb-azul-distribuidor-autorizado/p/MLM1027172667",

"title": "Apple iPhone 15 (128 GB) - Azul - Distribuidor Autorizado",

"brand": null,

"condition": "new",

"sold_quantity_min": 1000,

"sold_label": "+1000 vendidos",

"price": 15690.53,

"original_price": 16999,

"discount_percent": 7,

"currency": "MXN",

"promotions": [],

"description": "Este IPhone es compatible con eSIM. Contacta a tu operador móvil para conocer cómo activarla.",

"category_id": "MLM1055",

"domain_id": "MLM-CELLPHONES",

"best_seller_position": null

"response_time": 8374

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") res = client.mercadolibre.product(product_id="MLM1027172667") p = res["data"] print(p["title"], p["price"], p["currency"], p["sold_label"]) print("Buy box:", p["seller"]["nickname"], p["seller"]["reputation_level"]) print("Stars:", p["rating"]["average"], p["rating"]["distribution"])