Mercado Libre

API de producto de Mercado Libre

Un producto de catálogo o una publicación de Mercado Libre por URL, product_id o item_id: título, precio, precio de lista y descuento, cuotas, promociones, el vendedor del buy box con su nivel de reputación y su categoría de vendedor, stock, envío, unidades vendidas como mínimo, calificación con su distribución de estrellas, variaciones con los ids de producto hermanos, ficha técnica, descripción, imágenes y categorías. Cuesta 2 créditos por solicitud.

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 de producto de catálogo, tal como lo devuelve Búsqueda en product_id (o como aparece en una URL /p/). Su prefijo define el país: MLM México, MLB Brasil, MLA Argentina, MCO Colombia. Pasa exactamente uno de product_id, item_id o url.

Example: MLM1027172667

item_idstring

Id del artículo (publicación), tal como lo devuelve Búsqueda en item_id. También se acepta MLM-3571336480.

Example: MLM3571336480

urlstring

Una URL de producto (/p/), de producto de usuario (/up/) o de página de publicación de Mercado Libre o Mercado Livre de un país soportado.

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

Notes

Solo el vendedor del buy box. seller es el vendedor que gana el buy box en ese momento, con seller_id, nickname, nivel de reputación, categoría de vendedor (power_seller_status) y etiqueta de ventas. La lista de los demás vendedores que ofrecen el mismo producto de catálogo no está disponible. Pasa seller.seller_id a Búsqueda para listar el catálogo de ese vendedor.

Las unidades vendidas son mínimos. sold_quantity_min es el rango que muestra Mercado Libre (1000 para "+1000 vendidos"), no un número exacto; sold_label es el texto tal como aparece.

No hay parámetro de país: lo define el prefijo del id (o el dominio de la URL). MLM es México, MLB Brasil, MLA Argentina, MCO Colombia. Los ids de Chile (MLC) devuelven 400.
rating.distribution y rating.count son los totales de opiniones; Opiniones pagina el texto de las opiniones.
variations lista cada opción (color, talla, capacidad) con el product_id hermano para pedir a continuación.
category_id alimenta Más vendidos, y best_seller_position tiene valor cuando el producto está en el ranking de su categoría.
Algunos campos son null cuando la publicación no los muestra (aquí brand y user_product_id). Los precios vienen en la moneda del sitio, con decimales cuando el sitio los muestra.
Un id que no existe devuelve 404 y se cobra. Las fallas temporales (502/503) nunca se cobran.

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"])