Developers

Documentación Mercado Libre

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

Última actualización 01/11/2023

Referencias de dominios, productos y atributos para Autopartes

Nota:

A partir del 27 de septiembre con el recurso GET a /catalog_compatibilities/products_search/new podrás conocer cuáles son los vehículos que fueron añadidos al catálogo en los últimos 30 días.

Dominios disponibles

País	Dominio
ARGENTINA	MLA-CARS_AND_VANS
BRASIL	MLB-CARS_AND_VANS
MÉXICO	MLM-CARS_AND_VANS_FOR_COMPATIBILITIES
URUGUAY	MLU-CARS_AND_VANS
CHILE	MLC-CARS_AND_VANS_FOR_COMPATIBILITIES

Atributos principales

Descripción de atributos	Atributos de CARS_AND_VANS (MLA, MLB, MLU)	Atributos de CARS_AND_VANS_FOR_COMPATIBILITIES (MLM y MLC)
MARCA	BRAND	BRAND
MODELO	MODEL	CAR_AND_VAN_MODEL
AÑO	VEHICLE_YEAR	YEAR
VERSIÓN	SHORT_VERSION	CAR_AND_VAN_SUBMODEL

Atributos secundarios

Descripción de atributos	Atributos de CARS_AND_VANS (MLA, MLB y MLU)	Atributos de CARS_AND_VANS_FOR_COMPATIBILITIES (MLM y MLC)
MOTOR	ENGINE	CAR_AND_VAN_ENGINE
CARROCERÍA	VEHICLE_BODY_TYPE	CAR_AND_VAN_BODY_TYPE
TRANSMISIÓN	TRANSMISSION_CONTROL_TYPE	TRANSMISSION_CONTROL_TYPE
TIPO DE TRANSMISIÓN	TRANSMISSION	CAR_AND_VAN_TRANSMISSION_TYPE
TIPO DE TRACCIÓN	DRIVE_TYPE	DRIVE_TYPE
TIPO DE COMBUSTIBLE	FUEL_TYPE	FUEL_TYPE

Atributos por dominio

Recuerda que el detalle de los atributos por cada dominio lo puedes obtener con la siguiente llamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/catalog_domains/$DOMAIN_ID

Ejemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/catalog_domains/MLA-CARS_AND_VANS

Atributos por categoría

Recuerda que el detalle de los atributos por cada categoría lo puedes obtener con la siguiente llamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/categories/$CATEGORY_ID/attributes

Ejemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/categories/MLA12345/attributes

Product search

Por medio de los atributos del dominio puedes identificar productos de catálogo. Para más información consulta el recurso Buscador de productos.

Ejemplo all sites (excepto MLM):

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H 'Content-Type: application/json' -d 
{
   "domain_id": "MLA-CARS_AND_VANS",
   "site_id": "MLA",
   "attributes": [
       {
           "id": "BRAND",
           "value_id": "60249"
       },
       {
           "id": "VEHICLE_YEAR",
           "value_id": "6730991"
       },
       {
           "id": "MODEL",
           "value_id": "1252874"
       },
       {
          "id": "SHORT_VERSION",
          "value_id": "2164329"
       }   
       ]
}
https://api.mercadolibre.com/products/search

Respuesta:

{
    "domain_id": "MLA-CARS_AND_VANS",
    "paging": {
        "total": 1,
        "limit": 10,
        "offset": 0
    },
    "results": [
        {
            "id": "MLA15520719",
            "status": "inactive",
            "domain_id": "MLA-CARS_AND_VANS",
            "name": "Volkswagen Gol Trend 1.6 Serie 101cv 5p 2020",
            "attributes": [...
            ],
            "pictures": []
        }
    ]
}

Ejemplo MLM:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H 'Content-Type: application/json' -d
{
   "domain_id":"MLM-CARS_AND_VANS_FOR_COMPATIBILITIES",
   "site_id":"MLM",
   "attributes":  [
        {
            "id": "BRAND",
            "value_id": "60249"
        },
        {
             "id": "YEAR",
            "value_id": "64314"
        },
        {
            "id": "CAR_AND_VAN_MODEL",
            "value_id": "8237019"
        }
   ]
}
https://api.mercadolibre.com/products/search

Respuesta:

{
    "domain_id": "MLM-CARS_AND_VANS_FOR_COMPATIBILITIES",
    "paging": {
        "total": 1,
        "limit": 10,
        "offset": 0
    },
    "results": [
        {
            "id": "MLM15858556",
            "status": "inactive",
            "domain_id": "MLM-CARS_AND_VANS_FOR_COMPATIBILITIES",
            "settings": {
                "listing_strategy": "open"
            },
            "name": "Volkswagen Sedan 1964 Base",
            "attributes": [...
            ],
            "pictures": []
        }
    ]
}

Obtener los productos nuevos del catálogo

Para poder mantener actualizadas siempre las compatibilidades de tus publicaciones, con el siguiente recurso podrás conocer cuáles son los vehículos nuevos que fueron agregados al catálogo en los últimos 30 días.

Llamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/catalog_compatibilities/products_search/new?categoryId=$categoryId

Query Params

categoryId
filterParents
limit

Ejemplo llamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/catalog_compatibilities/products_search/new?categoryId=MLA1234

Ejemplo respuesta:

[
     {
         "id": "MLB25867468",
          "attributes": [
           {
                    "id": "BRAND",
                     "name": "Marca",
                     "value_id": "60285",
                    "value_name": "Subaru",
                    "values": [
                           {
                             "id": "60285",
                              "name": "Subaru"
                          }
                      ]
            } ], 
           "date_created": "2023-08-08T20:08:28Z"
   },
   {      
         "id": "MLB25867467",
          "attributes": [
           {
                    "id": "BRAND",
                     "name": "Marca",
                     "value_id": "60285",
                    "value_name": "Subaru",
                    "values": [
                           {
                             "id": "60285",
                              "name": "Subaru"
                          }
                      ]
            } ], 
           "date_created": "2023-08-09T20:08:28Z"
   }
]

Parámetros:

categoryId: parámetro requerido, donde deben enviar una categoría que tenga habilitada la experiencia de compatibilidades.

filterParents: parámetro opcional que indica si filtra productos padres o no, si desean obtener todos los productos incluyendo padres deben enviar false. Su valor por defecto es true.

limit: parámetro opcional que indica la cantidad de productos a devolver, si desean obtener todos los productos deben enviar cero (0). Su valor por defecto es de 10 .

Posibles errores:

Error_code	Mensaje del error	Descripción
400	There is no configured compatibility for the category $categoryId	La categoría consultada no está habilitada para informar compatibilidades.
401	Invalid access token.	Access Token inválido.
403	Domain is not active.	Dominio inactivo en buybox.

400: formato incorrecto / más de 200 productos para el dominio especificado / más de 10 dominios especificados.

403: token inválido o falta de permisos sobre el ítem.

404: el ítem o la compatibilidad no existen.

Top values

A continuación puedes ver cómo implementar por medio del recurso Top values la funcionalidad para cargar distintas listas con valores de atributos e ir filtrando los resultados.
Con el siguiente recurso se pueden obtener los valores de cada combinación e ir refinando cada vez la búsqueda.

Llamada:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/catalog_domains/$DOMAIN_ID/attributes/$ATTRIBUTE_ID/top_values

Ejemplo "BRAND":

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/catalog_domains/MLA-CARS_AND_VANS/attributes/BRAND/top_values

Respuesta:

[
   {
       "id": "60249",
       "name": "Volkswagen",
       "metric": 7781
   },
   {
       "id": "66432",
       "name": "Ford",
       "metric": 5616
   },
   {
       "id": "9909",
       "name": "Renault",
       "metric": 4327
   },
   {
       "id": "60279",
       "name": "Peugeot",
       "metric": 4250
   },
   {
       "id": "67781",
       "name": "Fiat",
       "metric": 4172
   },
[…]
]

Ejemplo para filtrar modelos (MODEL) de una marca (BRAND):

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/catalog_domains/MLA-CARS_AND_VANS/attributes/MODEL/top_values 
{
   "known_attributes": [
       {
           "id": "BRAND",
           "value_id": "60249"
       }
   ]
}

Respuesta:

[
   {
       "id": "63686",
       "name": "Amarok",
       "metric": 1516
   },
   {
       "id": "1252874",
       "name": "Gol Trend",
       "metric": 925
   },
   {
       "id": "62109",
       "name": "Gol",
       "metric": 684
   },
   {
       "id": "1252871",
       "name": "Suran",
       "metric": 604
   },
   {
       "id": "64016",
       "name": "Vento",
       "metric": 585
   },
…
]

Ejemplo para obtener los años disponibles (VEHICLE_YEAR) filtrando por marca y modelo:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/catalog_domains/MLA-CARS_AND_VANS/attributes/VEHICLE_YEAR/top_values
{
   "known_attributes": [
       {
           "id": "BRAND",
           "value_id": "60249"
       },
       {
           "id": "MODEL",
           "value_id": "63686"
       }
   ]
}

Respuesta:

[
   {
       "id": "6730991",
       "name": "2020",
       "metric": 732
   },
   {
       "id": "423549",
       "name": "2015",
       "metric": 130
   },
   {
       "id": "436694",
       "name": "2017",
       "metric": 115
   },
   {
       "id": "2451646",
       "name": "2019",
       "metric": 104
   },
[…]
]

Volver: Compatibilidades entre ítems y productos de Autopartes.