Documentación Mercado Libre

Descubre toda la información que debes conocer sobre las APIs de Mercado Libre.
circulos azuis em degrade

Documentación

Última actualización 21/12/2022

Descarga de categorías

El árbol de categorías es una estructura en la cual Mercado Libre organiza sus publicaciones. Cada país tiene su propio árbol de categorías diferente de los demás. Las publicaciones solo se pueden realizar en las categorías hoja [leaf] del árbol. En ocasiones, modificamos el árbol porque creamos categorías o una existente se divide en dos o más categorías. Todas las publicaciones incluidas en la categoría anterior se trasladan automáticamente a la nueva categoría.

Contenidos

→Descargar árbol de categorías
→Descargar categorías con atributos



Descargar árbol de categorías

La API devuelve el árbol de categorías en formato JSON dentro de una respuesta codificada con gzip. Solo debes seleccionar el sitio correspondiente (site_id).

Por ejemplo, para obtener las categorías de Brasil utiliza este URL:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/MLB/categories/all <https://api.mercadolibre.com/sites/MLB/categories/all> > categoriesMLB.gz

Este URL contiene 2 encabezados que se pueden utilizar para verificar cuándo se generó la última descarga.

  • X-Content-Created: contiene la fecha de la última generación.
  • X-Content-MD5: contiene la suma de comprobación MD5 de la última generación.
    • curl -I -H 'Authorization: Bearer $ACCESS_TOKEN'  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 con atributos

    Dado que las categorías tienen atributos propios es necesario hacer la siguiente llamada para buscar un archivo que contiene el árbol de categorías con cada uno de sus atributos.

    Ejemplo:

    curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN'  https://api.mercadolibre.com/sites/MLA/categories/all?withAttributes=true > mla.gz