Mercado Libre

API de más vendidos de Mercado Libre

El top 20 de más vendidos, en orden de ranking, de una categoría de Mercado Libre en México, Argentina o Colombia, con precio, precio de lista y descuento, cuotas, calificación, unidades vendidas como mínimo, indicadores de envío y vendedor cuando se muestra. No disponible para Brasil. Cuesta 2 créditos por solicitud.

POST/api/v1/mercadolibre/best-sellers

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

countryenum<string>required

El sitio de Mercado Libre. No disponible para Brasil.

Example: mx

mx — México (mercadolibre.com.mx), precios en MXN.
ar — Argentina (mercadolibre.com.ar), precios en ARS.
co — Colombia (mercadolibre.com.co), precios en COP.

category_idstringrequired

Id de categoría, tal como lo devuelve Búsqueda en category_id o category_path, o Producto en category_id. Su prefijo debe coincidir con el país: MLM México, MLA Argentina, MCO Colombia.

Example: MLM1055

Notes

Top 20 por categoría. Cada llamada devuelve la lista en orden de ranking que Mercado Libre publica para una categoría, rank del 1 al 20, con el nombre y la ruta de la categoría. Haz una llamada por categoría; toma los ids de Búsqueda (category_id, category_path) o de Producto.

México, Argentina y Colombia. Más vendidos no está disponible para Brasil (Mercado Livre), y Chile no está soportado. El prefijo de la categoría debe coincidir con el país, así que MLA1055 con country: "mx" es un 400.

sold_quantity_min es un mínimo (10000 para "+10mil vendidos"), y highlight trae la insignia de posición tal como aparece.
Los resultados tienen el mismo formato que los de Búsqueda; category_id y domain_id son null en cada resultado porque la lista misma es la categoría.
Una categoría desconocida 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.best_sellers("MLM1055", country="mx")

data = res["data"]
print(data["category_name"])
for r in data["results"]:
    print(r["rank"], r["title"], r["price"], r["currency"], r["sold_label"])

Response

"country": "mx",

"site_id": "MLM",

"category_id": "MLM1055",

"category_name": "Celulares y Smartphones",

"count": 20,

"response_time": 4929

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") res = client.mercadolibre.best_sellers("MLM1055", country="mx") data = res["data"] print(data["category_name"]) for r in data["results"]: print(r["rank"], r["title"], r["price"], r["currency"], r["sold_label"])