Documentação do Mercado Livre

Confira todas as informações necessárias sobre as APIs Mercado Livre.
circulos azuis em degrade

Documentação do

Última atualização em 30/12/2025

Domínios e Categorias

Os seguintes exemplos servirão para você trabalhar com as opções da árvore de categorias e listas do Mercado Livre. Alguns conceitos importantes a ter em conta:

  • Site: site onde o Mercado Livre está disponível para operações comerciais, identificado com três letras maiúsculas, por exemplo: MLA para a Argentina, MLB para o Brasil ou MLM para o México.
  • Domínio: o domínio indica a que família de produtos pertence a publicação, como CELLPHONES, SNEAKERS ou BICYCLES.
  • Categoría: secções jerárquicas que compõem um domínio, para permitir que os produtos sejam classificados corretamente de acordo com atributos e especificações comuns, por exemplo, COVERS_CELFONE ou SLIPPERS.
Recurso Descrição Exemplo
/sites Devuelve información sobre los sitios donde Mercado Libre está disponible. GET
/sites/$SITE_ID/listing_types Devuelve diferentes niveles de exposición asociados con todos los listing types en Mercado Libre. GET
/sites/$SITE_ID/listing_prices?price=$PRICE Devuelve la lista de precios para vender y comprar en Mercado Libre. GET
/sites/$SITE_ID/categories Devuelve las categorías disponibles en el sitio. GET
/categories/$CATEGORY_ID Devuelve información sobre la categoría. GET
/categories/$CATEGORY_ID/attributes Muestra los atributos y reglas con el fin de describir los elementos que se almacenan en cada categoría. GET
/sites/$SITE_ID/domain_discovery/search?q=$Q Predictor de categorías. Devuelve la categoría correspondente para enumerar un artículo basándose en el título, dominio e/ou atributos. GET
/categories/$CATEGORY_ID/classifieds_promotion_packs Recupera packs de promociones clasificadas por categoría. GET
/domains/$DOMAIN_ID/technical_specs Devuelve detalle de la información técnica del dominio. GET

Recategorização automática

Importante:
A partir de 29/10/2025, implementamos um processo de recategorização automática para itens publicados via API.

É possível que alguns itens sejam recategorizados automaticamente pelo nosso sistema, especialmente se detectarmos que a categoria selecionada originalmente não é a mais precisa.

Por isso, recomendamos que sua integração esteja escutando ativamente as mudanças nos itens. Assim você poderá detectar alterações de categoria em tempo real e agir de forma adequada.

Por exemplo, para determinar o preço, custos logísticos, comissões ou condições de publicação, sugerimos que avalie o impacto que uma recategorização automática pode ter. Em particular:

  • Valide se seu sistema precisa recalcular ou atualizar o preço quando a categoria do item muda.
  • Considere revisar outras lógicas sensíveis à categoria, como condições de envio ou filtros de visibilidade.

Seguinte: Localização e moedas.