Mercado Livre

API de busca do Mercado Livre

Busque anúncios no Mercado Libre México, no Mercado Livre Brasil e no Mercado Libre Argentina ou Colômbia por palavra-chave ou vendedor, com filtros de condição, faixa de preço, desconto, frete grátis, Full, lojas oficiais e parcelas sem juros, ordenados por relevância ou preço. Cada resultado traz preço, preço de lista e desconto, parcelas, vendedor e marcação de loja oficial quando aparecem, marca, nota, número de avaliações, unidades vendidas como valor mínimo, indicadores de frete, uma marcação de patrocinado e ids de catálogo. Cerca de 48 anúncios por página, até 42 páginas. Custa 2 créditos por requisição.

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

O site do Mercado Livre em que buscar. O Chile não é suportado.

Example: mx

mx — México (mercadolibre.com.mx), preços em MXN.
br — Brasil, Mercado Livre (mercadolivre.com.br), preços em BRL.
ar — Argentina (mercadolibre.com.ar), preços em ARS.
co — Colômbia (mercadolibre.com.co), preços em COP.

querystring

Palavras-chave, de 1 a 200 caracteres. Passe pelo menos um entre query, seller_id ou seller_nickname. O Mercado Livre pode restringir uma busca a uma categoria, marca ou linha por conta própria; auto_applied_filters lista o que ele aplicou.

Example: iphone 15

seller_idstring

Só os anúncios deste vendedor: o id numérico que o endpoint de produto retorna em seller.seller_id. Combina com query, filtros, ordenação e página.

Example: 527927603

seller_nicknamestring

O apelido público de um vendedor. Retorna a primeira página de anúncios do vendedor sem filtros, junto com o seller_id dele; use seller_id para filtros, ordenação e as páginas seguintes.

Example: MERCADOLIBRE ELECTRONICA_MX

conditionenum<string>

Condição do item. Sem ela, o Mercado Livre pode mostrar só itens novos em algumas buscas (listado em auto_applied_filters).

Example: used

new — Novo.
used — Usado.
refurbished — Recondicionado.
open_box — Caixa aberta.

min_priceinteger

Preço mínimo na moeda do país (MXN, BRL, ARS ou COP).

Example: 5000

max_priceinteger

Preço máximo na moeda do país. Não pode ser menor que min_price.

Example: 30000

min_discountenum<integer>

Só anúncios com pelo menos esse percentual de desconto.

Example: 20

5 — 5% de desconto ou mais.
10 — 10% de desconto ou mais.
15 — 15% de desconto ou mais.
20 — 20% de desconto ou mais.
25 — 25% de desconto ou mais.
30 — 30% de desconto ou mais.
40 — 40% de desconto ou mais.

free_shippingbooleandefault:false

Só anúncios com frete grátis.

Example: true

full_fulfillmentbooleandefault:false

Só anúncios enviados pelo Full do Mercado Livre.

Example: true

official_stores_onlybooleandefault:false

Só anúncios de lojas oficiais de marcas.

Example: true

interest_free_installmentsbooleandefault:false

Só anúncios que podem ser pagos em parcelas sem juros (meses sin intereses, parcelas sem juros).

Example: true

sortenum<string>default:relevance

Ordem dos resultados. O Mercado Livre não oferece ordenação por mais novos nem por mais vendidos.

Example: price_asc

relevance — A ordem de relevância do Mercado Livre.
price_asc — Preço, do menor para o maior.
price_desc — Preço, do maior para o menor.

pageintegerdefault:1

Página de resultados, de 1 a 42, com cerca de 48 anúncios por página.

Example: 2

Notes

Cerca de 2.000 resultados por busca. O Mercado Livre mostra cerca de 48 anúncios por página e até 42 páginas para uma mesma busca. total e total_pages dizem quantos anúncios correspondem; no exemplo capturado, "iphone 15" no México correspondeu a 950 anúncios em 20 páginas. Para ler mais de 2.000, divida a busca em faixas de min_price/max_price, por condition ou por seller_id e faça uma busca por fatia.

Unidades vendidas são valores mínimos. sold_quantity_min é a faixa que o Mercado Livre mostra (1000 significa "+1000 vendidos"), não um número exato, e sold_label traz o texto do próprio site quando o card o mostra. Os dois são null quando o card não mostra nenhum número de vendas.

Marca e número de avaliações em todo resultado orgânico. brand e review_count vêm da lista de produtos que o Mercado Livre publica na página de resultados, então você pode acompanhar marcas e totais de avaliações numa busca inteira sem uma chamada de Produto por anúncio. Em 16 de outubro de 2026, uma busca no Brasil por "fone bluetooth" retornou a marca nos 48 resultados orgânicos e o número de avaliações em 43. A cobertura de review_count varia conforme a busca (17 de 48 para "iphone 15" no México, onde muitos resultados são anúncios recondicionados): é null, nunca 0, quando a página não publica um total para o anúncio, mesmo que o card mostre uma nota em estrelas. A maioria dos resultados patrocinados retorna review_count: null e mantém a marca exibida no card; na Colômbia, só o primeiro resultado traz esses campos. Em produtos de catálogo que juntam avaliações de vários países, review_count pode ser menor que o rating.count do endpoint de produto.

Ordenação só por relevância ou preço. Não há ordenação por mais novos nem por mais vendidos. Para os mais vendidos de uma categoria, use Mais vendidos (México, Argentina e Colômbia).

No Brasil, o preço da busca costuma ser o preço no Pix. No Mercado Livre, o price de um resultado de busca costuma ser o preço no Pix, cerca de 5% abaixo do preço normal. O endpoint de produto retorna o preço normal e costuma listar a oferta no Pix em promotions. Em 11 de outubro de 2026, um iPhone 15 aparecia por R$ 4.009 na busca e por R$ 4.220,84 em Produto, então compare a mesma fonte antes de apontar uma mudança de preço.

Filtros que o Mercado Livre aplica por conta própria. Uma busca pode ser restringida a uma categoria, marca ou linha sem que você peça (a busca capturada por "iphone 15" foi restringida à marca Apple e à linha iPhone 15), e no Brasil e na Argentina algumas buscas mostram só itens novos, a menos que você passe condition. auto_applied_filters lista o que foi aplicado automaticamente, e available_filters lista os filtros disponíveis com o número de resultados de cada um.

seller traz o nome do vendedor e a marcação de loja oficial só quando o card do resultado os mostra (null nos outros casos). Produto retorna o vendedor do buy box completo, com seller_id e reputação.
Os anúncios patrocinados vêm marcados no lugar com sponsored: true e mantêm a posição.
Uma busca sem resultados retorna 200 com count: 0 e é cobrada. Um apelido de vendedor desconhecido retorna 404 e é cobrado. Falhas temporárias (502/503) nunca são cobradas.
category_id e category_path alimentam Mais vendidos; product_id e item_id alimentam Produto, Avaliações e Perguntas.

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