Última actualización 15/03/2023

Referencias de dominios, productos y atributos para Autopartes


Dominios disponibles

País Dominio
ARGENTINA MLA-CARS_AND_VANS
BRASIL MLB-CARS_AND_VANS
MÉXICO MLM-CARS_AND_VANS_FOR_COMPATIBILITIES

Atributos principales (PARENT_PK)

Descripción de atributos Atributos de Latam (excepto México) Atributos de México
MARCA BRAND BRAND
MODELO MODEL CAR_AND_VAN_MODEL
AÑO VEHICLE_YEAR YEAR
SUBMODELO TRIM CAR_AND_VAN_SUBMODEL

Atributos secundarios (CHILD_PK)

Descripción de atributos Atributos de Latam (excepto México) Atributos de México
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

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": "TRIM",
           "value_id": "2228234"
       }
   ]
}
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": []
        }
    ]
}

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.