📚 Referência de APIs

Todos os endpoints disponíveis por plataforma — o que pedir ao se cadastrar

🛒

Mercado Livre

API REST pública com autenticação OAuth 2.0. Afiliados via programa separado (sem API oficial).

Base URL:https://api.mercadolibre.com📖 Documentação oficial →

TIPO DE AUTH

OAuth 2.0 (Bearer Token)

CREDENCIAIS NECESSÁRIAS

Client IDClient SecretAccess Token (OAuth)Refresh TokenUser IDTag de Afiliado
Legenda:PúblicoAuthAfiliadoDeprecated
Busca e Produtos
GET
/sites/MLB/search?q={query}

Busca produtos por palavra-chave

Público
GET
/sites/MLB/search?category={id}

Busca por categoria

Público
GET
/items/{item_id}

Detalhe de um produto

Público
GET
/items?ids={ids}

Múltiplos produtos (até 20)

Público
GET
/items/{id}/description

Descrição do produto

Público
GET
/items/{id}/pictures/{pic_id}

Imagens do produto

Público
Promoções e Deals
GET
/sites/MLB/search?sort=price_asc

Ordenar por menor preço

Público
GET
/sites/MLB/search?deals=MLB

Produtos em promoção

⚠️ Parâmetro deals pode variar

Público
GET
/highlights/MLB

Produtos em destaque

Auth
GET
/seller-promotions/{user_id}/items

Promoções do vendedor

Auth
Categorias
GET
/sites/MLB/categories

Todas as categorias

Público
GET
/categories/{category_id}

Detalhe de categoria

Público
GET
/categories/{id}/attributes

Atributos da categoria

Público
Preços e Ofertas
GET
/items/{id}/prices

Preços e histórico

Auth
GET
/prices/items?ids={ids}

Preços de múltiplos itens

Auth
Afiliados
Link manual com ?mt_source=

Rastreio via parâmetro UTM

⚠️ Não há API REST oficial de afiliados. Links gerados manualmente no painel.

Afiliado
afiliados.mercadolive.com.br

Portal do programa de afiliados

Afiliado
Autenticação OAuth
POST
/oauth/token

Obter/renovar access token

Auth
GET
/users/me

Dados do usuário autenticado

Auth
💡 Observações e Links
  • •O programa de afiliados ML NÃO tem API REST — links são gerados manualmente no painel de afiliados
  • •Busca pública não exige autenticação (ideal para monitorar preços)
  • •Rate limit: 180 requisições/minuto em apps autenticados
  • •Cadastro: developers.mercadolivre.com.br | Afiliados: afiliados.mercadolive.com.br