List vehicles

This guide will help you to list your first classified item on MercadoLibre using our API

Contents:

Basics

Classified listings are the only kind of items that allows users to display their contact information to the public, so when users are browsing classifieds and they have an interest on one of yours, they can get in contact with you right away. So, basically, there aren’t any kind of transactions or exchanges made on our site for this kind of items, but you’ll be exposing your listing to every user that’s browsing classifieds on our platform.

Listing results

Each item you list will appear in the listing results of a given search. For example, when a user search for the query “Peluquería” or “Camioneta”, as a result he will get a list of all items related, that can include yours.
When someone clicks on an item, the item details page is displayed showing all the information about the item that was provided at the time of listing, keep reading to know more about it.

Item details page

This is the page on the frontend of our Marketplace for each item.
When a user chooses an item from the result, this page displays the following item details:

  • Item_id
  • Title
  • City
  • Pictures
  • Price
  • Contact information
  • Contact form
  • Attributes
  • Detailed description

Motors item fields

Let’s see a regular motors listing Json from our API. This is easy since you only need to know the item_id associated to that item, and since it’s public you can get it from the item details page. In Argentina, you will find it at the top of the page. You just need to add the site_id before the number you see and that’s it. Now you can call the Items resource to get all the information you need:

Call:

curl - X GET https://api.mercadolibre.com/items/{Item_id}

Example:

curl  -X GET https://api.mercadolibre.com/items/MLA599268216

Response:

{
  "id": "MLA599268216",
  "site_id": "MLA",
  "title": "Peugeot 208 - $38.000",
  "subtitle": null,
  "seller_id": 153559604,
  "category_id": "MLA119052",
  "official_store_id": null,
  "price": 38000,
  "base_price": 38000,
  "original_price": null,
  "currency_id": "ARS",
  "initial_quantity": 1,
  "available_quantity": 1,
  "sold_quantity": 0,
  "buying_mode": "classified",
  "listing_type_id": "gold",
  "start_time": "2016-01-08T16:55:56.000Z",
  "stop_time": "2016-03-01T18:56:53.000Z",
  "condition": "not_specified",
  "permalink": "http://auto.mercadolibre.com.ar/MLA-599268216-peugeot-208-38000-sin-sorteo-ni-licitacion-_JM",
  "thumbnail": "http://mla-s1-p.mlstatic.com/22262-MLA20226682909_012015-I.jpg",
  "secure_thumbnail": "https://a248.e.akamai.net/mla-s1-p.mlstatic.com/22262-MLA20226682909_012015-I.jpg",
  "pictures": [
    {
      "id": "22262-MLA20226682909_012015",
      "url": "http://mla-s1-p.mlstatic.com/22262-MLA20226682909_012015-O.jpg",
      "secure_url": "https://a248.e.akamai.net/mla-s1-p.mlstatic.com/22262-MLA20226682909_012015-O.jpg",
      "size": "500x351",
      "max_size": "1000x703",
      "quality": ""
    },
    {
      "id": "22238-MLA20226683506_012015",
      "url": "http://mla-s1-p.mlstatic.com/22238-MLA20226683506_012015-O.jpg",
      "secure_url": "https://a248.e.akamai.net/mla-s1-p.mlstatic.com/22238-MLA20226683506_012015-O.jpg",
      "size": "500x353",
      "max_size": "1000x707",
      "quality": ""
    },
    {
      "id": "22224-MLA20226683429_012015",
      "url": "http://mla-s1-p.mlstatic.com/22224-MLA20226683429_012015-O.jpg",
      "secure_url": "https://a248.e.akamai.net/mla-s1-p.mlstatic.com/22224-MLA20226683429_012015-O.jpg",
      "size": "500x321",
      "max_size": "1000x643",
      "quality": ""
    },
    {
      "id": "22285-MLA20226683480_012015",
      "url": "http://mla-s2-p.mlstatic.com/22285-MLA20226683480_012015-O.jpg",
      "secure_url": "https://a248.e.akamai.net/mla-s2-p.mlstatic.com/22285-MLA20226683480_012015-O.jpg",
      "size": "500x318",
      "max_size": "1000x636",
      "quality": ""
    },
    {
      "id": "22222-MLA20226684012_012015",
      "url": "http://mla-s2-p.mlstatic.com/22222-MLA20226684012_012015-O.jpg",
      "secure_url": "https://a248.e.akamai.net/mla-s2-p.mlstatic.com/22222-MLA20226684012_012015-O.jpg",
      "size": "500x353",
      "max_size": "1000x707",
      "quality": ""
    },
    {
      "id": "22251-MLA20226682930_012015",
      "url": "http://mla-s1-p.mlstatic.com/22251-MLA20226682930_012015-O.jpg",
      "secure_url": "https://a248.e.akamai.net/mla-s1-p.mlstatic.com/22251-MLA20226682930_012015-O.jpg",
      "size": "500x316",
      "max_size": "1000x633",
      "quality": ""
    },
    {
      "id": "22283-MLA20226708119_012015",
      "url": "http://mla-s1-p.mlstatic.com/22283-MLA20226708119_012015-O.jpg",
      "secure_url": "https://a248.e.akamai.net/mla-s1-p.mlstatic.com/22283-MLA20226708119_012015-O.jpg",
      "size": "500x280",
      "max_size": "703x394",
      "quality": ""
    },
    {
      "id": "22217-MLA20226708129_012015",
      "url": "http://mla-s2-p.mlstatic.com/22217-MLA20226708129_012015-O.jpg",
      "secure_url": "https://a248.e.akamai.net/mla-s2-p.mlstatic.com/22217-MLA20226708129_012015-O.jpg",
      "size": "500x272",
      "max_size": "726x396",
      "quality": ""
    },
    {
      "id": "22216-MLA20226707252_012015",
      "url": "http://mla-s2-p.mlstatic.com/22216-MLA20226707252_012015-O.jpg",
      "secure_url": "https://a248.e.akamai.net/mla-s2-p.mlstatic.com/22216-MLA20226707252_012015-O.jpg",
      "size": "500x300",
      "max_size": "703x422",
      "quality": ""
    },
    {
      "id": "22212-MLA20226708164_012015",
      "url": "http://mla-s1-p.mlstatic.com/22212-MLA20226708164_012015-O.jpg",
      "secure_url": "https://a248.e.akamai.net/mla-s1-p.mlstatic.com/22212-MLA20226708164_012015-O.jpg",
      "size": "500x243",
      "max_size": "900x439",
      "quality": ""
    },
    {
      "id": "22225-MLA20226708173_012015",
      "url": "http://mla-s1-p.mlstatic.com/22225-MLA20226708173_012015-O.jpg",
      "secure_url": "https://a248.e.akamai.net/mla-s1-p.mlstatic.com/22225-MLA20226708173_012015-O.jpg",
      "size": "499x244",
      "max_size": "899x440",
      "quality": ""
    },
    {
      "id": "22242-MLA20226708183_012015",
      "url": "http://mla-s2-p.mlstatic.com/22242-MLA20226708183_012015-O.jpg",
      "secure_url": "https://a248.e.akamai.net/mla-s2-p.mlstatic.com/22242-MLA20226708183_012015-O.jpg",
      "size": "500x251",
      "max_size": "884x444",
      "quality": ""
    }
  ],
  "video_id": null,
  "descriptions": [
    {
      "id": "MLA599268216-1004133312"
    }
  ],
  "accepts_mercadopago": false,
  "non_mercado_pago_payment_methods": [
  ],
  "shipping": {
    "mode": "not_specified",
    "local_pick_up": false,
    "free_shipping": false,
    "methods": [
    ],
    "dimensions": null,
    "tags": [
    ]
  },
  "international_delivery_mode": "none",
  "seller_address": {
    "id": 131655971,
    "comment": "",
    "address_line": "juan b justo 27",
    "zip_code": "1669",
    "city": {
      "id": "TUxBQ1BJTDQ3NDE",
      "name": "Pilar"
    },
    "state": {
      "id": "AR-B",
      "name": "Buenos Aires"
    },
    "country": {
      "id": "AR",
      "name": "Argentina"
    },
    "latitude": -34.45636084,
    "longitude": -58.90555502,
    "search_location": {
      "neighborhood": {
        "id": "",
        "name": ""
      },
      "city": {
        "id": "TUxBQ1BJTGFyMTIz",
        "name": "Pilar"
      },
      "state": {
        "id": "TUxBUEdSQWU4ZDkz",
        "name": "Bs.As. G.B.A. Norte"
      }
    }
  },
  "seller_contact": {
    "contact": "",
    "other_info": "",
    "area_code": "",
    "phone": "",
    "area_code2": "",
    "phone2": "",
    "email": "",
    "webpage": ""
  },
  "location": {
    "address_line": "",
    "zip_code": "",
    "neighborhood": {
      "id": "TUxBQkdSQTMyNTla",
      "name": "Grand Bourg"
    },
    "city": {
      "id": "TUxBQ01BTHZpbmFz",
      "name": "Malvinas Argentinas"
    },
    "state": {
      "id": "TUxBUEdSQWU4ZDkz",
      "name": "Bs.as. G.b.a. Norte"
    },
    "country": {
      "id": "AR",
      "name": "Argentina"
    },
    "latitude": "",
    "longitude": "",
    "open_hours": ""
  },
  "geolocation": {
    "latitude": "",
    "longitude": ""
  },
  "coverage_areas": [
  ],
  "attributes": [
    {
      "id": "MLA1743-HORPREF",
      "name": "Horario de contacto",
      "value_id": "",
      "value_name": "9 a 19 hs.",
      "attribute_group_id": "ADICIONALES",
      "attribute_group_name": "Adicionales"
    },
    {
      "id": "MLA1744-COLOREXT",
      "name": "Color",
      "value_id": "MLA1744-COLOREXT-OTRO",
      "value_name": "Otro",
      "attribute_group_id": "ADICIONALES",
      "attribute_group_name": "Adicionales"
    },
    {
      "id": "MLA1744-DIREC",
      "name": "Dirección",
      "value_id": "MLA1744-DIREC-ASISTIDA",
      "value_name": "Asistida",
      "attribute_group_id": "ADICIONALES",
      "attribute_group_name": "Adicionales"
    },
    {
      "id": "MLA1744-OWNER",
      "name": "Único dueño",
      "value_id": "MLA1744-OWNER-SI",
      "value_name": "Sí",
      "attribute_group_id": "ADICIONALES",
      "attribute_group_name": "Adicionales"
    },
    {
      "id": "MLA1744-AIRACON",
      "name": "Aire acondicionado",
      "value_id": "MLA1744-AIRACON-Y",
      "value_name": "Sí",
      "attribute_group_id": "CONFORT",
      "attribute_group_name": "Confort"
    },
    {
      "id": "MLA1744-ALARMLUC",
      "name": "Alarma de luces encendidas",
      "value_id": "MLA1744-ALARMLUC-N",
      "value_name": "No",
      "attribute_group_id": "CONFORT",
      "attribute_group_name": "Confort"
    },
    {
      "id": "MLA1744-APERBAUL",
      "name": "Apertura remota de baúl",
      "value_id": "MLA1744-APERBAUL-Y",
      "value_name": "Sí",
      "attribute_group_id": "CONFORT",
      "attribute_group_name": "Confort"
    },
    {
      "id": "MLA1744-ASIENELEC",
      "name": "Asientos eléctricos",
      "value_id": "MLA1744-ASIENELEC-Y",
      "value_name": "Sí",
      "attribute_group_id": "CONFORT",
      "attribute_group_name": "Confort"
    },
    {
      "id": "MLA1744-ASREBAT",
      "name": "Asiento trasero rebatible",
      "value_id": "MLA1744-ASREBAT-N",
      "value_name": "No",
      "attribute_group_id": "CONFORT",
      "attribute_group_name": "Confort"
    },
    {
      "id": "MLA1744-ASREGULA",
      "name": "Asiento conductor regulable en altura",
      "value_id": "MLA1744-ASREGULA-N",
      "value_name": "No",
      "attribute_group_id": "CONFORT",
      "attribute_group_name": "Confort"
    },
    {
      "id": "MLA1744-BLQCNTDOOR",
      "name": "Cierre centralizado de puertas",
      "value_id": "MLA1744-BLQCNTDOOR-Y",
      "value_name": "Sí",
      "attribute_group_id": "CONFORT",
      "attribute_group_name": "Confort"
    },
    {
      "id": "MLA1744-CLIMAUT",
      "name": "Climatizador automático",
      "value_id": "MLA1744-CLIMAUT-Y",
      "value_name": "Sí",
      "attribute_group_id": "CONFORT",
      "attribute_group_name": "Confort"
    },
    {
      "id": "MLA1744-COMPABO",
      "name": "Computadora de abordo",
      "value_id": "MLA1744-COMPABO-Y",
      "value_name": "Sí",
      "attribute_group_id": "CONFORT",
      "attribute_group_name": "Confort"
    },
    {
      "id": "MLA1744-CTRLVEL",
      "name": "Control de velocidad de crucero",
      "value_id": "MLA1744-CTRLVEL-N",
      "value_name": "No",
      "attribute_group_id": "CONFORT",
      "attribute_group_name": "Confort"
    },
    {
      "id": "MLA1744-ESPELEC",
      "name": "Espejos eléctricos",
      "value_id": "MLA1744-ESPELEC-Y",
      "value_name": "Sí",
      "attribute_group_id": "CONFORT",
      "attribute_group_name": "Confort"
    },
    {
      "id": "MLA1744-ESTACIONAM",
      "name": "Sensor de estacionamiento",
      "value_id": "MLA1744-ESTACIONAM-N",
      "value_name": "No",
      "attribute_group_id": "CONFORT",
      "attribute_group_name": "Confort"
    },
    {
      "id": "MLA1744-FAROREG",
      "name": "Faros regulables desde el interior",
      "value_id": "MLA1744-FAROREG-N",
      "value_name": "No",
      "attribute_group_id": "CONFORT",
      "attribute_group_name": "Confort"
    },
    {
      "id": "MLA1744-GPS",
      "name": "GPS",
      "value_id": "MLA1744-GPS-N",
      "value_name": "No",
      "attribute_group_id": "CONFORT",
      "attribute_group_name": "Confort"
    },
    {
      "id": "MLA1744-SENSLL",
      "name": "Sensor de lluvia",
      "value_id": "MLA1744-SENSLL-N",
      "value_name": "No",
      "attribute_group_id": "CONFORT",
      "attribute_group_name": "Confort"
    },
    {
      "id": "MLA1744-SENSLUZ",
      "name": "Sensor de luz",
      "value_id": "MLA1744-SENSLUZ-N",
      "value_name": "No",
      "attribute_group_id": "CONFORT",
      "attribute_group_name": "Confort"
    },
    {
      "id": "MLA1744-TAPCUERO",
      "name": "Tapizado de cuero",
      "value_id": "MLA1744-TAPCUERO-Y",
      "value_name": "Sí",
      "attribute_group_id": "CONFORT",
      "attribute_group_name": "Confort"
    },
    {
      "id": "MLA1744-TECHOCORR",
      "name": "Techo corredizo",
      "value_id": "MLA1744-TECHOCORR-Y",
      "value_name": "Sí",
      "attribute_group_id": "CONFORT",
      "attribute_group_name": "Confort"
    },
    {
      "id": "MLA1744-VIDELEC",
      "name": "Cristales eléctricos",
      "value_id": "MLA1744-VIDELEC-Y",
      "value_name": "Sí",
      "attribute_group_id": "CONFORT",
      "attribute_group_name": "Confort"
    },
    {
      "id": "MLA1744-LIMPIA_LAV",
      "name": "Limpia/lava luneta",
      "value_id": "MLA1744-LIMPIA/LAV-N",
      "value_name": "No",
      "attribute_group_id": "EXTERIOR",
      "attribute_group_name": "Exterior"
    },
    {
      "id": "MLA1744-LLANALEAC",
      "name": "Llantas de aleación",
      "value_id": "MLA1744-LLANALEAC-Y",
      "value_name": "Sí",
      "attribute_group_id": "EXTERIOR",
      "attribute_group_name": "Exterior"
    },
    {
      "id": "MLA1744-PARAGOLPES",
      "name": "Paragolpes pintados",
      "value_id": "MLA1744-PARAGOLPES-N",
      "value_name": "No",
      "attribute_group_id": "EXTERIOR",
      "attribute_group_name": "Exterior"
    },
    {
      "id": "MLA1744-VIDPOLARIZ",
      "name": "Vidrios polarizados",
      "value_id": "MLA1744-VIDPOLARIZ-Y",
      "value_name": "Sí",
      "attribute_group_id": "EXTERIOR",
      "attribute_group_name": "Exterior"
    },
    {
      "id": "MLA119052-VERS",
      "name": "Versión",
      "value_id": "",
      "value_name": "208 ACTIVE 1.5 5PTAS",
      "attribute_group_id": "FIND",
      "attribute_group_name": "Ficha técnica"
    },
    {
      "id": "MLA1744-COMBUS",
      "name": "Combustible",
      "value_id": "MLA1744-COMBUS-NAFTA",
      "value_name": "Nafta",
      "attribute_group_id": "FIND",
      "attribute_group_name": "Ficha técnica"
    },
    {
      "id": "MLA1744-DOOR",
      "name": "Cant. de puertas",
      "value_id": "MLA1744-DOOR-5",
      "value_name": "5",
      "attribute_group_id": "FIND",
      "attribute_group_name": "Ficha técnica"
    },
    {
      "id": "MLA1744-KMTS",
      "name": "Kilómetros",
      "value_id": "",
      "value_name": "0",
      "attribute_group_id": "FIND",
      "attribute_group_name": "Ficha técnica"
    },
    {
      "id": "MLA1744-MARC",
      "name": "Marca",
      "value_id": "MLA1744-MARC-PEUGEOT",
      "value_name": "Peugeot",
      "attribute_group_id": "FIND",
      "attribute_group_name": "Ficha técnica"
    },
    {
      "id": "MLA1744-MODL",
      "name": "Modelo",
      "value_id": "MLA1744-MODL-208",
      "value_name": "208",
      "attribute_group_id": "FIND",
      "attribute_group_name": "Ficha técnica"
    },
    {
      "id": "MLA1744-TRANS",
      "name": "Transmisión",
      "value_id": "MLA1744-TRANS-MANUAL",
      "value_name": "Manual",
      "attribute_group_id": "FIND",
      "attribute_group_name": "Ficha técnica"
    },
    {
      "id": "MLA1744-YEAR",
      "name": "Año",
      "value_id": "a9f0a06",
      "value_name": "2015",
      "attribute_group_id": "FIND",
      "attribute_group_name": "Ficha técnica"
    },
    {
      "id": "MLA1744-3LUZSTOP",
      "name": "Tercer stop",
      "value_id": "MLA1744-3LUZSTOP-N",
      "value_name": "No",
      "attribute_group_id": "SECURITY",
      "attribute_group_name": "Seguridad"
    },
    {
      "id": "MLA1744-ABS",
      "name": "Frenos ABS",
      "value_id": "MLA1744-ABS-Y",
      "value_name": "Sí",
      "attribute_group_id": "SECURITY",
      "attribute_group_name": "Seguridad"
    },
    {
      "id": "MLA1744-AIR1",
      "name": "Airbag conductor",
      "value_id": "MLA1744-AIR1-Y",
      "value_name": "Sí",
      "attribute_group_id": "SECURITY",
      "attribute_group_name": "Seguridad"
    },
    {
      "id": "MLA1744-AIR2",
      "name": "Airbag pasajero",
      "value_id": "MLA1744-AIR2-Y",
      "value_name": "Sí",
      "attribute_group_id": "SECURITY",
      "attribute_group_name": "Seguridad"
    },
    {
      "id": "MLA1744-AIR3",
      "name": "Airbag laterales",
      "value_id": "MLA1744-AIR3-N",
      "value_name": "No",
      "attribute_group_id": "SECURITY",
      "attribute_group_name": "Seguridad"
    },
    {
      "id": "MLA1744-AIRBAGCORT",
      "name": "Airbag de cortina",
      "value_id": "MLA1744-AIRBAGCORT-N",
      "value_name": "No",
      "attribute_group_id": "SECURITY",
      "attribute_group_name": "Seguridad"
    },
    {
      "id": "MLA1744-ALAR",
      "name": "Alarma",
      "value_id": "MLA1744-ALAR-Y",
      "value_name": "Sí",
      "attribute_group_id": "SECURITY",
      "attribute_group_name": "Seguridad"
    },
    {
      "id": "MLA1744-APCABEZA",
      "name": "Apoya cabeza en asientos traseros",
      "value_id": "MLA1744-APCABEZA-N",
      "value_name": "No",
      "attribute_group_id": "SECURITY",
      "attribute_group_name": "Seguridad"
    },
    {
      "id": "MLA1744-BLIND",
      "name": "Blindado",
      "value_id": "MLA1744-BLIND-N",
      "value_name": "No",
      "attribute_group_id": "SECURITY",
      "attribute_group_name": "Seguridad"
    },
    {
      "id": "MLA1744-CNTTRACC",
      "name": "Control de tracción",
      "value_id": "MLA1744-CNTTRACC-N",
      "value_name": "No",
      "attribute_group_id": "SECURITY",
      "attribute_group_name": "Seguridad"
    },
    {
      "id": "MLA1744-CONTR",
      "name": "Control de estabilidad",
      "value_id": "MLA1744-CONTR-N",
      "value_name": "No",
      "attribute_group_id": "SECURITY",
      "attribute_group_name": "Seguridad"
    },
    {
      "id": "MLA1744-DOBTRACC",
      "name": "Doble tracción",
      "value_id": "MLA1744-DOBTRACC-N",
      "value_name": "No",
      "attribute_group_id": "SECURITY",
      "attribute_group_name": "Seguridad"
    },
    {
      "id": "MLA1744-FARANTI",
      "name": "Faros antinieblas delanteros",
      "value_id": "MLA1744-FARANTI-Y",
      "value_name": "Sí",
      "attribute_group_id": "SECURITY",
      "attribute_group_name": "Seguridad"
    },
    {
      "id": "MLA1744-FAROXEN",
      "name": "Faros de xenón",
      "value_id": "MLA1744-FAROXEN-Y",
      "value_name": "Sí",
      "attribute_group_id": "SECURITY",
      "attribute_group_name": "Seguridad"
    },
    {
      "id": "MLA1744-INMOVMOT",
      "name": "Inmovilizador de motor",
      "value_id": "MLA1744-INMOVMOT-N",
      "value_name": "No",
      "attribute_group_id": "SECURITY",
      "attribute_group_name": "Seguridad"
    },
    {
      "id": "MLA1744-ISOFIX",
      "name": "Isofix",
      "value_id": "MLA1744-ISOFIX-N",
      "value_name": "No",
      "attribute_group_id": "SECURITY",
      "attribute_group_name": "Seguridad"
    },
    {
      "id": "MLA1744-NEBLTRAS",
      "name": "Faros antinieblas traseros",
      "value_id": "MLA1744-NEBLTRAS-Y",
      "value_name": "Sí",
      "attribute_group_id": "SECURITY",
      "attribute_group_name": "Seguridad"
    },
    {
      "id": "MLA1744-REPFUERZA",
      "name": "Repartidor electrónico de fuerza de frenado",
      "value_id": "MLA1744-REPFUERZA-N",
      "value_name": "No",
      "attribute_group_id": "SECURITY",
      "attribute_group_name": "Seguridad"
    },
    {
      "id": "MLA1744-AM_FM",
      "name": "AM/FM",
      "value_id": "MLA1744-AM/FM-N",
      "value_name": "No",
      "attribute_group_id": "SONIDO",
      "attribute_group_name": "Sonido"
    },
    {
      "id": "MLA1744-BLUETOOTH",
      "name": "Bluetooth",
      "value_id": "MLA1744-BLUETOOTH-Y",
      "value_name": "Sí",
      "attribute_group_id": "SONIDO",
      "attribute_group_name": "Sonido"
    },
    {
      "id": "MLA1744-CAJACD",
      "name": "Caja de CD",
      "value_id": "MLA1744-CAJACD-N",
      "value_name": "No",
      "attribute_group_id": "SONIDO",
      "attribute_group_name": "Sonido"
    },
    {
      "id": "MLA1744-CARGADORCD",
      "name": "Cargador de CD",
      "value_id": "MLA1744-CARGADORCD-N",
      "value_name": "No",
      "attribute_group_id": "SONIDO",
      "attribute_group_name": "Sonido"
    },
    {
      "id": "MLA1744-CASET",
      "name": "Pasacassette",
      "value_id": "MLA1744-CASET-N",
      "value_name": "No",
      "attribute_group_id": "SONIDO",
      "attribute_group_name": "Sonido"
    },
    {
      "id": "MLA1744-COMANDOSAT",
      "name": "Comando satelital de stereo",
      "value_id": "MLA1744-COMANDOSAT-N",
      "value_name": "No",
      "attribute_group_id": "SONIDO",
      "attribute_group_name": "Sonido"
    },
    {
      "id": "MLA1744-DVD",
      "name": "DVD",
      "value_id": "MLA1744-DVD-N",
      "value_name": "No",
      "attribute_group_id": "SONIDO",
      "attribute_group_name": "Sonido"
    },
    {
      "id": "MLA1744-ENTAUXILIA",
      "name": "Entrada auxiliar",
      "value_id": "MLA1744-ENTAUXILIA-Y",
      "value_name": "Sí",
      "attribute_group_id": "SONIDO",
      "attribute_group_name": "Sonido"
    },
    {
      "id": "MLA1744-MP3",
      "name": "MP3",
      "value_id": "MLA1744-MP3-Y",
      "value_name": "Sí",
      "attribute_group_id": "SONIDO",
      "attribute_group_name": "Sonido"
    },
    {
      "id": "MLA1744-REPRODCD",
      "name": "CD",
      "value_id": "MLA1744-REPRODCD-Y",
      "value_name": "Sí",
      "attribute_group_id": "SONIDO",
      "attribute_group_name": "Sonido"
    },
    {
      "id": "MLA1744-TARJETASD",
      "name": "Tarjeta SD",
      "value_id": "MLA1744-TARJETASD-Y",
      "value_name": "Sí",
      "attribute_group_id": "SONIDO",
      "attribute_group_name": "Sonido"
    },
    {
      "id": "MLA1744-USB",
      "name": "Entrada USB",
      "value_id": "MLA1744-USB-Y",
      "value_name": "Sí",
      "attribute_group_id": "SONIDO",
      "attribute_group_name": "Sonido"
    }
  ],
  "warnings": [
  ],
  "listing_source": "",
  "variations": [
  ],
  "status": "active",
  "sub_status": [
  ],
  "tags": [
    "dragged_visits"
  ],
  "warranty": null,
  "catalog_product_id": null,
  "parent_item_id": "MLA595529146",
  "differential_pricing": null,
  "deal_ids": [
  ],
  "automatic_relist": false,
  "date_created": "2016-01-08T16:55:57.000Z",
  "last_updated": "2016-01-29T18:59:04.000Z"
}

 

There’s a lot of information about the vehicle this user is selling. Is very important you send the most attributes you can so user’s get the whole picture right away. You can click on the permalink attribute on an item to see how it looks on our Marketplace.

Listing motors

There are some considerations when listings motors items. When you list a vehicle on MLV (MercadoLibre Venezuela) or MCO(MercadoLibre Colombia), your items will automatically be listed on http://www.tucarro.com also. The example below will result on a successful listing on both marketplaces of MCO. For MLV is exactly the same structure, you just have to replace the values for accepted site values.

Defining attributes

You must know some of the fields are mandatory when you create a Json for your item, while some others can be skipped or will be automatically added by us.They will define how the item is displayed and the position on search results.

Title

You must send a title for your vehicle but have in mind that since the motors’s search is attribute based, we’ll be displaying your vehicle on the list basing on the attributes you’ve sent. This make it easier for users to find exactly what they’re looking for.

Description

A detailed description will improve your chances to buy your vehicle and will save you time from answering unnecessary question. It can be a text-only description or you can add your own personalized HTML. There are some considerations when working with descriptions. If you are interested in increasing your knowledge about this topic, check our item description guide.

Pictures

Good pictures can make your vehicle more appealing and give other users a better idea of how it looks like. Basically, you should add an array of up to six URL pictures on the Json.

 {
 ....
 "pictures":[
  {"source":"http://yourServer/path/to/your/picture.jpg"},
  {"source":"http://yourServer/path/to/your/otherPicture.gif"},
  {"source":"http://yourServer/path/to/your/anotherPicture.png"}
 ]
 ...
}

We highly recommend not to use slow servers to host your pictures since this can lead to disadvantages when listing.
You can also add or change pictures to your item later on, please read more about this topic to know which kind of pictures are allowed and how to work with them on our Working with pictures guide.

Category & attributes

Sellers must define a category in MercadoLibre site. This attribute is mandatory and only accepts pre-established ids. Each category has it’s own attributes for you to work with. To get the details see our Categories guide.

{
 ....
  "category_id":"MLA12683",
 ...
}

 

Price

Price is mandatory, if you’re open to negotiate the price for rent or sale with other users you can set it as to be agreed.

Currency

This one is a mandatory attribute. You need to define it using a pre-established id. You’ll find available currency ids calling the category where you want to list your item. Learn how by following our category guide.

Seller Custom Field

The seller custom field is not mandatory but is very useful since there aren’t any pre-established values and you can send anything as a String. Most sellers use this field to associate their own SKUs to their products, to identify the product sold on the order.
Example:

curl -X PUT -d '{"seller_custom_field": "21000093"}' https://api.mercadolibre.com/items/MLA599074368?access_token=¢ACCESS_TOKEN

Listing type

This is another case of a mandatory attribute that only accepts pre-defined values and is very important for you to understand about it.
There are different listing types available for each site. You should make a mixed call through sites and listing_types resources to know which listing_types are supported. Follow our guide to know which listing type will suite your vehicle best.

List a motors item

You’re ready to list your first classified item. Notice you’ll need an access_token to make it. If you have questions regarding how to get your access token, please go back to the Getting Started tutorial. In addition, we highly recommended you validate the Json you’re sending before making a POST, so you better check out this really easy and quick item validation tutorial.
You can create a Json for your item basing on the following example, or just send it and you’ll be listing a sample vehicle on the site:

curl -X POST -H "Content-Type: application/json" -d '{
    "site_id": "MCO",
    "title": "Item De Testeo",
    "category_id": "MCO64499",
    "official_store_id": null,
    "price": 1200000,
    "currency_id": "COP",
    "available_quantity": 1,
    "buying_mode": "classified",
    "listing_type_id": "free",
    "condition": "used",
    "pictures": [
        {
            "id": "10792-MCO20033261630_012014",
            "url": "http://mco-s2-p.mlstatic.com/10792-MCO20033261630_012014-O.jpg",
            "secure_url": "https://a248.e.akamai.net/mco-s2-p.mlstatic.com/10792-MCO20033261630_012014-O.jpg",
            "size": "250x250",
            "max_size": "250x250",
            "quality": ""
        }
    ],
    "video_id": null,
    "accepts_mercadopago": false,
    "non_mercado_pago_payment_methods": [],
    "shipping": {
        "profile_id": null,
        "mode": "not_specified",
        "local_pick_up": false,
        "free_shipping": false,
        "methods": [],
        "dimensions": null
    },
    "seller_address": {
        "id": null,
        "comment": "",
        "address_line": "Test Address 123",
        "zip_code": "",
        "city": {
            "id": "",
            "name": "Bogota"
        },
        "state": {
            "id": "CO-DC",
            "name": "Bogota D.C."
        },
        "country": {
            "id": "CO",
            "name": "Colombia"
        },
        "latitude": "",
        "longitude": "",
        "search_location": {
            "neighborhood": {
                "id": "",
                "name": ""
            },
            "city": {
                "id": "",
                "name": ""
            },
            "state": {
                "id": "",
                "name": ""
            }
        }
    },
    "seller_contact": {
        "contact": "",
        "other_info": "",
        "area_code": "",
        "phone": "121312",
        "area_code2": "",
        "phone2": "",
        "email": "",
        "webpage": ""
    },
    "location": {
        "address_line": "",
        "zip_code": "",
        "neighborhood": {
            "id": "",
            "name": ""
        },
        "city": {
            "id": "TUNPQ0FCRTg3MTJl",
            "name": "Abejorral"
        },
        "state": {
            "id": "TUNPUEFOVGFiZWI3",
            "name": "Antioquia"
        },
        "country": {
            "id": "CO",
            "name": "Colombia"
        },
        "latitude": "",
        "longitude": ""
    },
    "coverage_areas": [],
    "attributes": [
        {
            "id": "MCO1744-ABS",
            "name": "Frenos ABS",
            "value_id": "",
            "value_name": "",
            "attribute_group_id": "ADICIONALES",
            "attribute_group_name": "Características generales"
        },
        {
            "id": "MCO1744-AIRACON",
            "name": "Aire Acondicionado",
            "value_id": "MCO1744-AIRACON-SI",
            "value_name": "Sí",
            "attribute_group_id": "ADICIONALES",
            "attribute_group_name": "Características generales"
        },
        {
            "id": "MCO1744-AIRBAG",
            "name": "Airbag",
            "value_id": "",
            "value_name": "",
            "attribute_group_id": "ADICIONALES",
            "attribute_group_name": "Características generales"
        },
        {
            "id": "MCO1744-ASIENTOS",
            "name": "Asientos",
            "value_id": "MCO1744-ASIENTOS-CUERO",
            "value_name": "Cuero",
            "attribute_group_id": "ADICIONALES",
            "attribute_group_name": "Características generales"
        },
        {
            "id": "MCO1744-CILIND",
            "name": "Nro. de cilindros",
            "value_id": "",
            "value_name": "",
            "attribute_group_id": "ADICIONALES",
            "attribute_group_name": "Características generales"
        },
        {
            "id": "MCO1744-DIREC",
            "name": "Dirección",
            "value_id": "MCO1744-DIREC-ASISTIDA",
            "value_name": "Asistida",
            "attribute_group_id": "ADICIONALES",
            "attribute_group_name": "Características generales"
        },
        {
            "id": "MCO1744-FINANC",
            "name": "Doy financiamiento",
            "value_id": "",
            "value_name": "",
            "attribute_group_id": "ADICIONALES",
            "attribute_group_name": "Características generales"
        },
        {
            "id": "MCO1744-MOTOR",
            "name": "Motor",
            "value_id": "",
            "value_name": "",
            "attribute_group_id": "ADICIONALES",
            "attribute_group_name": "Características generales"
        },
        {
            "id": "MCO1744-NEGOC",
            "name": "Negociable",
            "value_id": "MCO1744-NEGOC-SI",
            "value_name": "Sí",
            "attribute_group_id": "ADICIONALES",
            "attribute_group_name": "Características generales"
        },
        {
            "id": "MCO1744-RMOTOR",
            "name": "Motor recién reparado",
            "value_id": "",
            "value_name": "",
            "attribute_group_id": "ADICIONALES",
            "attribute_group_name": "Características generales"
        },
        {
            "id": "MCO1744-SONIDO",
            "name": "Sonido",
            "value_id": "",
            "value_name": "",
            "attribute_group_id": "ADICIONALES",
            "attribute_group_name": "Características generales"
        },
        {
            "id": "MCO1744-TRAC",
            "name": "Camp",
            "value_id": "",
            "value_name": "",
            "attribute_group_id": "ADICIONALES",
            "attribute_group_name": "Características generales"
        },
        {
            "id": "MCO1744-TRANS",
            "name": "Transmisión",
            "value_id": "MCO1744-TRANS-AUTOMATICA",
            "value_name": "Automática",
            "attribute_group_id": "ADICIONALES",
            "attribute_group_name": "Características generales"
        },
        {
            "id": "MCO1744-VID",
            "name": "Vidrios",
            "value_id": "MCO1744-VID-MANUALES",
            "value_name": "Manuales",
            "attribute_group_id": "ADICIONALES",
            "attribute_group_name": "Características generales"
        },
        {
            "id": "MCO1744-BLOQUEOCEN",
            "name": "Bloqueo central",
            "value_id": "MCO1744-BLOQUEOCEN-N",
            "value_name": "No",
            "attribute_group_id": "EQUIPAMIENTO",
            "attribute_group_name": "Accesorios Internos"
        },
        {
            "id": "MCO1744-FORDELVOL",
            "name": "Forro del volante",
            "value_id": "MCO1744-FORDELVOL-N",
            "value_name": "No",
            "attribute_group_id": "EQUIPAMIENTO",
            "attribute_group_name": "Accesorios Internos"
        },
        {
            "id": "MCO1744-FORROSAS",
            "name": "Forros de asientos",
            "value_id": "MCO1744-FORROSAS-N",
            "value_name": "No",
            "attribute_group_id": "EQUIPAMIENTO",
            "attribute_group_name": "Accesorios Internos"
        },
        {
            "id": "MCO1744-VOLANDEP",
            "name": "Volante deportivo",
            "value_id": "MCO1744-VOLANDEP-N",
            "value_name": "No",
            "attribute_group_id": "EQUIPAMIENTO",
            "attribute_group_name": "Accesorios Internos"
        },
        {
            "id": "MCO1744-ESTRIBOS",
            "name": "Estribos",
            "value_id": "MCO1744-ESTRIBOS-N",
            "value_name": "No",
            "attribute_group_id": "EXTERIOR",
            "attribute_group_name": "Exterior"
        },
        {
            "id": "MCO1744-FORROLLAN",
            "name": "Forro llanta de repuesto",
            "value_id": "MCO1744-FORROLLAN-N",
            "value_name": "No",
            "attribute_group_id": "EXTERIOR",
            "attribute_group_name": "Exterior"
        },
        {
            "id": "MCO1744-LANTINIEB",
            "name": "Luces anti niebla",
            "value_id": "MCO1744-LANTINIEB-N",
            "value_name": "No",
            "attribute_group_id": "EXTERIOR",
            "attribute_group_name": "Exterior"
        },
        {
            "id": "MCO1744-LLANTASN",
            "name": "Llantas nuevas",
            "value_id": "MCO1744-LLANTASN-N",
            "value_name": "No",
            "attribute_group_id": "EXTERIOR",
            "attribute_group_name": "Exterior"
        },
        {
            "id": "MCO1744-PELICUSEG",
            "name": "Película de Seguridad",
            "value_id": "MCO1744-PELICUSEG-N",
            "value_name": "No",
            "attribute_group_id": "EXTERIOR",
            "attribute_group_name": "Exterior"
        },
        {
            "id": "MCO1744-RETROELEC",
            "name": "Retrovisores eléctricos",
            "value_id": "MCO1744-RETROELEC-N",
            "value_name": "No",
            "attribute_group_id": "EXTERIOR",
            "attribute_group_name": "Exterior"
        },
        {
            "id": "MCO1744-REVISION",
            "name": "Revision tecnomecánica",
            "value_id": "MCO1744-REVISION-N",
            "value_name": "No",
            "attribute_group_id": "EXTERIOR",
            "attribute_group_name": "Exterior"
        },
        {
            "id": "MCO1744-RINES",
            "name": "Rines de lujo",
            "value_id": "MCO1744-RINES-N",
            "value_name": "No",
            "attribute_group_id": "EXTERIOR",
            "attribute_group_name": "Exterior"
        },
        {
            "id": "MCO1744-ROOF",
            "name": "Sun Roof (Quemacoco)",
            "value_id": "MCO1744-ROOF-N",
            "value_name": "No",
            "attribute_group_id": "EXTERIOR",
            "attribute_group_name": "Exterior"
        },
        {
            "id": "MCO1744-SPOILER",
            "name": "Spoiler",
            "value_id": "MCO1744-SPOILER-N",
            "value_name": "No",
            "attribute_group_id": "EXTERIOR",
            "attribute_group_name": "Exterior"
        },
        {
            "id": "MCO1744-COLOREXT",
            "name": "Color",
            "value_id": "MCO1744-COLOREXT-AZUL",
            "value_name": "Azul",
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
        },
        {
            "id": "MCO1744-COMBUS",
            "name": "Combustible",
            "value_id": "",
            "value_name": "",
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
        },
        {
            "id": "MCO1744-KMTS",
            "name": "Recorrido",
            "value_id": "",
            "value_name": "9999999999",
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
        },
        {
            "id": "MCO1744-MARC",
            "name": "Marca",
            "value_id": "MCO1744-MARC-OTRAS_MARCAS",
            "value_name": "Otras Marcas",
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
        },
        {
            "id": "MCO1744-MODL",
            "name": "Modelo",
            "value_id": "MCO1744-MODL-OTROS_MODELOS",
            "value_name": "Otros Modelos",
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
        },
        {
            "id": "MCO1744-OWNER",
            "name": "Único dueño",
            "value_id": "",
            "value_name": "",
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
        },
        {
            "id": "MCO1744-PLACAS",
            "name": "Placa",
            "value_id": "",
            "value_name": "11111",
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
        },
        {
            "id": "MCO1744-YEAR",
            "name": "Año",
            "value_id": "MCO1744-YEAR-1969",
            "value_name": "1969",
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
        },
        {
            "id": "MCO64499-VERS",
            "name": "Versión",
            "value_id": "",
            "value_name": "",
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha Técnica"
        },
        {
            "id": "MCO1743-CMG_SITE",
            "name": "sitio de origen",
            "value_id": "",
            "value_name": "TUC",
            "attribute_group_id": "HIDDEN",
            "attribute_group_name": ""
        },
        {
            "id": "MCO1744-ALARCCTRL",
            "name": "Alarma con control",
            "value_id": "MCO1744-ALARCCTRL-N",
            "value_name": "No",
            "attribute_group_id": "SECURITY",
            "attribute_group_name": "Seguridad"
        },
        {
            "id": "MCO1744-ASEGURADO",
            "name": "Asegurado",
            "value_id": "MCO1744-ASEGURADO-N",
            "value_name": "No",
            "attribute_group_id": "SECURITY",
            "attribute_group_name": "Seguridad"
        },
        {
            "id": "MCO1744-RASTREO",
            "name": "Rastreo satelital",
            "value_id": "MCO1744-RASTREO-N",
            "value_name": "No",
            "attribute_group_id": "SECURITY",
            "attribute_group_name": "Seguridad"
        },
        {
            "id": "MCO1744-CAJACD",
            "name": "Caja de CDs",
            "value_id": "MCO1744-CAJACD-N",
            "value_name": "No",
            "attribute_group_id": "SONIDO",
            "attribute_group_name": "Sonido"
        },
        {
            "id": "MCO1744-DVD",
            "name": "DVD",
            "value_id": "MCO1744-DVD-N",
            "value_name": "No",
            "attribute_group_id": "SONIDO",
            "attribute_group_name": "Sonido"
        },
        {
            "id": "MCO1744-PLANTA",
            "name": "Planta",
            "value_id": "MCO1744-PLANTA-N",
            "value_name": "No",
            "attribute_group_id": "SONIDO",
            "attribute_group_name": "Sonido"
        },
        {
            "id": "MCO1744-SUBBUFFER",
            "name": "Sub-Buffer (Bajos)",
            "value_id": "MCO1744-SUBBUFFER-N",
            "value_name": "No",
            "attribute_group_id": "SONIDO",
            "attribute_group_name": "Sonido"
        }
    ],
    "variations": [],
    "status": "active",
    "warranty": null,
    "catalog_product_id": null,
    "automatic_relist": false
}' https://api.mercadolibre.com/items?access_token=$ACCESS_TOKEN



Next topic: Sync your listings.

Please rate this