Mercado Libre

API de búsqueda de Mercado Libre

Busca publicaciones de Mercado Libre en México, Brasil (Mercado Livre), Argentina o Colombia por palabra clave o por vendedor, con filtros de condición, rango de precio, descuento, envío gratis, Full, tiendas oficiales y meses sin intereses, ordenadas por relevancia o por precio. Cada resultado trae precio, precio de lista y descuento, cuotas, vendedor e indicador de tienda oficial cuando se muestran, marca, calificación, número de opiniones, unidades vendidas como mínimo, indicadores de envío, una marca de patrocinado e ids de catálogo. Unas 48 publicaciones por página, hasta 42 páginas. Cuesta 2 créditos por solicitud.

POST/api/v1/mercadolibre/search

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 en el que buscar. Chile no está soportado.

Example: mx

mx — México (mercadolibre.com.mx), precios en MXN.
br — Brasil, Mercado Livre (mercadolivre.com.br), precios en BRL.
ar — Argentina (mercadolibre.com.ar), precios en ARS.
co — Colombia (mercadolibre.com.co), precios en COP.

querystring

Palabras clave, de 1 a 200 caracteres. Pasa al menos uno de query, seller_id o seller_nickname. Mercado Libre puede acotar una búsqueda por su cuenta a una categoría, marca o línea; auto_applied_filters lista lo que aplicó.

Example: iphone 15

seller_idstring

Solo las publicaciones de este vendedor: el id numérico que Producto devuelve como seller.seller_id. Se combina con query, filtros, orden y página.

Example: 527927603

seller_nicknamestring

El nickname público de un vendedor. Devuelve la primera página de publicaciones del vendedor sin filtros, más su seller_id; usa seller_id para filtros, orden y páginas siguientes.

Example: MERCADOLIBRE ELECTRONICA_MX

conditionenum<string>

Condición del artículo. Sin este parámetro, Mercado Libre puede mostrar solo artículos nuevos en algunas búsquedas (aparece en auto_applied_filters).

Example: used

new — Nuevo.
used — Usado.
refurbished — Reacondicionado.
open_box — Caja abierta.

min_priceinteger

Precio mínimo en la moneda del país (MXN, BRL, ARS o COP).

Example: 5000

max_priceinteger

Precio máximo en la moneda del país. No puede ser menor que min_price.

Example: 30000

min_discountenum<integer>

Solo publicaciones con al menos este porcentaje de descuento.

Example: 20

5 — 5% de descuento o más.
10 — 10% de descuento o más.
15 — 15% de descuento o más.
20 — 20% de descuento o más.
25 — 25% de descuento o más.
30 — 30% de descuento o más.
40 — 40% de descuento o más.

free_shippingbooleandefault:false

Solo publicaciones con envío gratis.

Example: true

full_fulfillmentbooleandefault:false

Solo publicaciones enviadas con Mercado Libre Full.

Example: true

official_stores_onlybooleandefault:false

Solo publicaciones de tiendas oficiales de marca.

Example: true

interest_free_installmentsbooleandefault:false

Solo publicaciones que se pueden pagar en cuotas sin interés (meses sin intereses, parcelas sem juros).

Example: true

sortenum<string>default:relevance

Orden de los resultados. Mercado Libre no ofrece orden por más nuevos ni por más vendidos.

Example: price_asc

relevance — El orden por relevancia de Mercado Libre.
price_asc — Precio, de menor a mayor.
price_desc — Precio, de mayor a menor.

pageintegerdefault:1

Página de resultados, de 1 a 42, unas 48 publicaciones por página.

Example: 2

Notes

Unos 2,000 resultados por búsqueda. Mercado Libre muestra unas 48 publicaciones por página y hasta 42 páginas para cualquier búsqueda. total y total_pages te dicen cuántas coinciden; en el ejemplo capturado, "iphone 15" en México coincidió con 950 publicaciones en 20 páginas. Para leer más de 2,000, divide la búsqueda por rangos de min_price/max_price, por condition o por seller_id y haz una búsqueda por segmento.

Las unidades vendidas son mínimos. sold_quantity_min es el rango que muestra Mercado Libre (1000 significa "+1000 vendidos"), no un número exacto, y sold_label trae el texto del propio sitio cuando la tarjeta lo muestra. Ambos son null cuando la tarjeta no muestra ninguna cifra de ventas.

Marca y número de opiniones en cada resultado orgánico. brand y review_count vienen de la lista de productos que Mercado Libre publica en la página de resultados, así que puedes seguir marcas y totales de opiniones en toda una búsqueda sin una llamada a Producto por publicación. El 16 de octubre de 2026, una búsqueda de "fone bluetooth" en Brasil devolvió marca en los 48 resultados orgánicos y número de opiniones en 43. La cobertura de review_count varía según la búsqueda (17 de 48 para "iphone 15" en México, donde muchos resultados son publicaciones reacondicionadas): es null, nunca 0, cuando la página no publica un total para una publicación, aunque la tarjeta muestre una calificación con estrellas. La mayoría de los resultados patrocinados devuelven review_count: null y conservan la etiqueta de marca de la tarjeta; en Colombia solo el primer resultado los trae. En productos de catálogo que juntan opiniones de varios países, review_count puede ser menor que el rating.count de Producto.

Orden solo por relevancia o por precio. No hay orden por más nuevos ni por más vendidos. Para los más vendidos de una categoría, usa Más vendidos (México, Argentina y Colombia).

En Brasil, el precio de búsqueda suele ser el precio con Pix. En Mercado Livre, el price de un resultado de búsqueda suele ser el precio con Pix, cerca de 5% por debajo del precio normal. Producto devuelve el precio normal y suele listar la oferta con Pix en promotions. El 11 de octubre de 2026 un iPhone 15 mostraba R$4,009 en la búsqueda y R$4,220.84 en Producto, así que compara valores equivalentes antes de marcar un cambio de precio.

Filtros que Mercado Libre aplica por su cuenta. Una búsqueda puede acotarse a una categoría, marca o línea sin que lo pidas (la búsqueda capturada de "iphone 15" se acotó a la marca Apple y la línea iPhone 15), y en Brasil y Argentina algunas búsquedas muestran solo artículos nuevos a menos que pases condition. auto_applied_filters lista lo que se aplicó automáticamente, y available_filters lista las facetas con su número de resultados.

seller trae el nombre del vendedor y el indicador de tienda oficial solo cuando la tarjeta del resultado los muestra (null en otro caso). Producto devuelve el vendedor del buy box completo, con seller_id y reputación.
Las publicaciones patrocinadas se marcan en su lugar con sponsored: true y conservan su posición.
Una búsqueda sin resultados devuelve 200 con count: 0 y se cobra. Un nickname de vendedor desconocido devuelve 404 y se cobra. Las fallas temporales (502/503) nunca se cobran.
category_id y category_path alimentan Más vendidos; product_id e item_id alimentan Producto, Opiniones y Preguntas.

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")

res = client.mercadolibre.search("iphone 15", country="mx", condition="new", free_shipping=True)

data = res["data"]
print(data["total"], "matches,", data["total_pages"], "pages")
for r in data["results"]:
    print(r["position"], r["title"], r["price"], r["currency"], r["sold_quantity_min"], r["sponsored"])

Response

"country": "mx",

"site_id": "MLM",

"query": "iphone 15",

"seller_id": null,

"seller_nickname": null,

"page": 1,

"page_size": 48,

"total": 950,

"total_pages": 20,

"sort": "relevance",

"category_id": "MLM1055",

"count": 48,

"response_time": 3163

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") res = client.mercadolibre.search("iphone 15", country="mx", condition="new", free_shipping=True) data = res["data"] print(data["total"], "matches,", data["total_pages"], "pages") for r in data["results"]: print(r["position"], r["title"], r["price"], r["currency"], r["sold_quantity_min"], r["sponsored"])