Documentação do Mercado Livre

Confira todas as informações necessárias sobre as APIs Mercado Livre.
circulos azuis em degrade
Última atualização em 12/07/2023

Dump de categorias

A árvore de categorias é uma estrutura na qual o Mercado Livre organiza suas listagens. Cada um dos países tem sua própria árvore de categorias diferente das outras. As listagens só podem ser realizadas nas categorias folha da árvore. Às vezes, mudamos a árvore de categorias, seja porque uma nova categoria é criada, seja porque uma categoria existente é dividida em duas ou mais categorias. Todos os anúncios incluídos na categoria anterior são automaticamente deslocados para a nova.

Conteúdos

→Descargar árvore de categorias
→Descargar categorías com atributos


Descargar árvore de categorias

A API retorna a árvore de categorias no formato JSON dentro de uma resposta codificada com gzip. Por exemplo, para obter as categorias do Brasil, ele utiliza a seguinte URL:

curl https://api.mercadolibre.com/sites/MLB/categories/all categoriesMLB.gz

Essa URL contém dois cabeçalhos que podem ser utilizados para verificar quando foi gerado o último dump.

  • X-Content-Created: contém a data da última geração.
  • X-Content-MD5: contém a soma de verificação MD5 da última geração.
curl -I  https://api.mercadolibre.com/sites/MLB/categories/all
HTTP/1.1 200 OK
Server: nginx/1.0.4
Date: Tue, 24 Jul 2012 15:14:58 GMT
Content-Type: application/json;charset=UTF-8
Connection: keep-alive
X-MLAPI-Version: 1.9.5
Content-Encoding: gzip
X-Content-Created: 2012-07-24T14:00:59.716Z
X-Content-MD5: 943541196986770119b4af1e66bda2dc

Descargar categorías com atributos

Exemplo:

curl https://api.mercadolibre.com/sites/MLA/categories/all?withAttributes=true > mla.gz