Documentação do Mercado Livre

Confira todas as informações necessárias sobre as APIs Mercado Livre.

Última atualização em 01/11/2023

Referências de domínios, produtos e atributos para Autopeças

Nota:

A partir de 27 de setembro, com o recurso GET para /catalog_compatibilities/products_search/new, você poderá saber quais são os veículos que foram adicionados ao catálogo nos últimos 30 dias.

Domínios disponíveis

País	Domínio
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 principais

Descrição dos atributos	Atributos de de CARS_AND_VANS (MLA, MLB y MLU)	Atributos de CARS_AND_VANS_FOR_COMPATIBILITIES (MLM y MLC)
MARCA	BRAND	BRAND
MODELO	MODEL	CAR_AND_VAN_MODEL
ANO	VEHICLE_YEAR	YEAR
VERSIÓN	SHORT_VERSION	CAR_AND_VAN_SUBMODEL

Atributos secundários

Descrição dos 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
CARROÇARIA	VEHICLE_BODY_TYPE	CAR_AND_VAN_BODY_TYPE
TRANSMISSÃO	TRANSMISSION_CONTROL_TYPE	TRANSMISSION_CONTROL_TYPE
TIPO DE TRANSMISSÃO	TRANSMISSION	CAR_AND_VAN_TRANSMISSION_TYPE
TIPO DE TRAÇÃO	DRIVE_TYPE	DRIVE_TYPE
TIPO DE COMBUSTÍVEL	FUEL_TYPE	FUEL_TYPE

Atributos por domínio

Lembre-se que o detalhe dos atributos de cada domínio pode ser conseguido com a seguinte chamada:

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

Exemplo:

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

Atributos por categoria

O detalhe dos atributos de cada categoria pode ser conseguido com a seguinte chamada:

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

Exemplo:

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

Product search

Por meio dos atributos do domínio, você pode identificar produtos de catálogo. Para mais informações consulte o recurso Buscador de produtos.

Exemplo all sites (exceto 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

Resposta:

{
    "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": []
        }
    ]
}

Exemplo 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

Response:

{
    "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": []
        }
    ]
}

Obter novos produtos do catálogo

Para manter atualizadas as compatibilidades das suas publicações, o seguinte recurso permitesaber quais são os novos veículos que foram acrescentados ao catálogo nos últimos 30 dias.

Chamada:

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

Query Params

categoryId
filterParents
limit

Exemplo chamada:

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

Exemplo resposta:

[
     {
         "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 obrigatório, onde devem enviar uma categoria que tenha a experiência de compatibilidades ativada.

filterParents: parâmetro opcional que indica se devem ou não ser filtrados os produtos pais; se pretender obter todos os produtos, incluindo os pais, deve enviar false. O seu valor predefinido é true.

limit: parâmetro opcional que indica o número de produtos a devolver, se pretender obter todos os produtos deve enviar zero (0). Seu valor padrão é 10.

Posibles errores:

Error_code	Mensagem de erro	Descrição
400	There is no configured compatibility for the category $categoryId	A categoria consultada não está habilitada a comunicar compatibilidades.
401	Invalid access token.	Access Token inválido.
403	Domain is not active.	Domínio inativo em buybox.

400: formato incorreto/mais de 200 produtos para o domínio especificado / mais de 10 domínios especificados.

403: token inválido ou falta de permissões para o item.

404: o item ou a compatibilidade não existe.

Top values

Agora você pode ver como implementar por meio do recurso Top values a funcionalidade de conseguir listas diferentes com valores de atributos e filtrar os resultados.
Com o seguinte recurso você pode obter os valores de cada combinação e refinar a pesquisa a cada vez.

Chamada:

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

Exemplo "BRAND":

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

Resposta:

[
   {
       "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
   },
[…]
]

Exemplo para filtrar modelos (MODEL) de uma marca (BRAND):

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

Resposta:

[
   {
       "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
   },
…
]

Exemplo para obter os anos disponíveis (VEHICLE_YEAR) filtrando por marca e modelo:

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

Resposta:

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

Voltar: Compatibilidades entre itens e produtos de Autopeças.