List properties

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

Contents:

    Basics

    Real estate and classified items in general are the only kind of listing that allows users to display their contact information to the public, so when users are browsing properties to rent or buy and they have an interest on one of the properties you own, they can get in contact with you right away. So, basically, there aren’t any kind of transactions made on classified items, so you won’t sale or rent your property directly from our site, but you’ll expose it to every user that’s browsing the web for properties.

    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 “Casa en Mar del Plata”, as a result he will get a list of all items related. Your property can be on this list.
    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

    Real estate item fields

    Let’s see a regular real estate item by 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’s 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/MLA603335359

    Response:

    {
      "id": "MLA603335359",
      "site_id": "MLA",
      "title": "Semana.santa 190 Por Capacidad Deptos Complejo Angel Del Sol",
      "subtitle": null,
      "seller_id": 50152177,
      "category_id": "MLA50283",
      "official_store_id": null,
      "price": 190,
      "base_price": 190,
      "original_price": null,
      "currency_id": "ARS",
      "initial_quantity": 1,
      "available_quantity": 1,
      "sold_quantity": 0,
      "buying_mode": "classified",
      "listing_type_id": "gold_premium",
      "start_time": "2016-01-31T14:16:20.000Z",
      "stop_time": "2017-01-30T14:16:20.000Z",
      "condition": "used",
      "permalink": "http://inmueble.mercadolibre.com.ar/MLA-603335359-semanasanta-190-por-capacidad-deptos-complejo-angel-del-sol-_JM",
      "thumbnail": "http://mla-s1-p.mlstatic.com/23423-MLA20248368790_022015-I.jpg",
      "secure_thumbnail": "https://a248.e.akamai.net/mla-s1-p.mlstatic.com/23423-MLA20248368790_022015-I.jpg",
      "pictures": [
        {
          "id": "23423-MLA20248368790_022015",
          "url": "http://mla-s1-p.mlstatic.com/23423-MLA20248368790_022015-O.jpg",
          "secure_url": "https://a248.e.akamai.net/mla-s1-p.mlstatic.com/23423-MLA20248368790_022015-O.jpg",
          "size": "500x375",
          "max_size": "1200x900",
          "quality": ""
        },
        {
          "id": "23447-MLA20248368829_022015",
          "url": "http://mla-s2-p.mlstatic.com/23447-MLA20248368829_022015-O.jpg",
          "secure_url": "https://a248.e.akamai.net/mla-s2-p.mlstatic.com/23447-MLA20248368829_022015-O.jpg",
          "size": "500x375",
          "max_size": "1200x900",
          "quality": ""
        },
        {
          "id": "23431-MLA20248368726_022015",
          "url": "http://mla-s2-p.mlstatic.com/23431-MLA20248368726_022015-O.jpg",
          "secure_url": "https://a248.e.akamai.net/mla-s2-p.mlstatic.com/23431-MLA20248368726_022015-O.jpg",
          "size": "500x375",
          "max_size": "1200x900",
          "quality": ""
        },
        {
          "id": "23451-MLA20248368762_022015",
          "url": "http://mla-s2-p.mlstatic.com/23451-MLA20248368762_022015-O.jpg",
          "secure_url": "https://a248.e.akamai.net/mla-s2-p.mlstatic.com/23451-MLA20248368762_022015-O.jpg",
          "size": "500x375",
          "max_size": "1200x900",
          "quality": ""
        },
        {
          "id": "23446-MLA20248368859_022015",
          "url": "http://mla-s1-p.mlstatic.com/23446-MLA20248368859_022015-O.jpg",
          "secure_url": "https://a248.e.akamai.net/mla-s1-p.mlstatic.com/23446-MLA20248368859_022015-O.jpg",
          "size": "500x375",
          "max_size": "1200x900",
          "quality": ""
        },
        {
          "id": "23449-MLA20248368490_022015",
          "url": "http://mla-s2-p.mlstatic.com/23449-MLA20248368490_022015-O.jpg",
          "secure_url": "https://a248.e.akamai.net/mla-s2-p.mlstatic.com/23449-MLA20248368490_022015-O.jpg",
          "size": "500x375",
          "max_size": "1200x900",
          "quality": ""
        },
        {
          "id": "23466-MLA20248368893_022015",
          "url": "http://mla-s1-p.mlstatic.com/23466-MLA20248368893_022015-O.jpg",
          "secure_url": "https://a248.e.akamai.net/mla-s1-p.mlstatic.com/23466-MLA20248368893_022015-O.jpg",
          "size": "500x375",
          "max_size": "1200x900",
          "quality": ""
        },
        {
          "id": "23475-MLA20248368922_022015",
          "url": "http://mla-s2-p.mlstatic.com/23475-MLA20248368922_022015-O.jpg",
          "secure_url": "https://a248.e.akamai.net/mla-s2-p.mlstatic.com/23475-MLA20248368922_022015-O.jpg",
          "size": "500x375",
          "max_size": "1200x900",
          "quality": ""
        },
        {
          "id": "23425-MLA20248370717_022015",
          "url": "http://mla-s1-p.mlstatic.com/23425-MLA20248370717_022015-O.jpg",
          "secure_url": "https://a248.e.akamai.net/mla-s1-p.mlstatic.com/23425-MLA20248370717_022015-O.jpg",
          "size": "500x375",
          "max_size": "1200x900",
          "quality": ""
        },
        {
          "id": "23448-MLA20248370762_022015",
          "url": "http://mla-s1-p.mlstatic.com/23448-MLA20248370762_022015-O.jpg",
          "secure_url": "https://a248.e.akamai.net/mla-s1-p.mlstatic.com/23448-MLA20248370762_022015-O.jpg",
          "size": "500x375",
          "max_size": "1200x900",
          "quality": ""
        },
        {
          "id": "23403-MLA20248370781_022015",
          "url": "http://mla-s2-p.mlstatic.com/23403-MLA20248370781_022015-O.jpg",
          "secure_url": "https://a248.e.akamai.net/mla-s2-p.mlstatic.com/23403-MLA20248370781_022015-O.jpg",
          "size": "500x375",
          "max_size": "1200x900",
          "quality": ""
        },
        {
          "id": "23480-MLA20248371283_022015",
          "url": "http://mla-s2-p.mlstatic.com/23480-MLA20248371283_022015-O.jpg",
          "secure_url": "https://a248.e.akamai.net/mla-s2-p.mlstatic.com/23480-MLA20248371283_022015-O.jpg",
          "size": "500x375",
          "max_size": "1200x900",
          "quality": ""
        }
      ],
      "video_id": null,
      "descriptions": [
        {
          "id": "MLA603335359-1022043551"
        }
      ],
      "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": 153363213,
        "comment": "ferreteria antartida",
        "address_line": "av3 y paseo127 111111",
        "zip_code": "7165",
        "city": {
          "id": "TUxBQ1ZJTGU4OGM3",
          "name": "Villa Gesell"
        },
        "state": {
          "id": "AR-B",
          "name": "Buenos Aires"
        },
        "country": {
          "id": "AR",
          "name": "Argentina"
        },
        "latitude": -37.25747514,
        "longitude": -56.97445905,
        "search_location": {
          "neighborhood": {
            "id": "",
            "name": ""
          },
          "city": {
            "id": "TUxBQ1ZJTGU4OGM3",
            "name": "Villa Gesell"
          },
          "state": {
            "id": "TUxBUENPU2ExMmFkMw",
            "name": "Bs.As. Costa Atlántica"
          }
        }
      },
      "seller_contact": {
        "contact": "",
        "other_info": "",
        "area_code": "",
        "phone": "",
        "area_code2": "",
        "phone2": "",
        "email": "",
        "webpage": ""
      },
      "location": {
        "address_line": "PASEO 141 BIS Y 4 4100",
        "zip_code": "",
        "neighborhood": {
          "id": "",
          "name": ""
        },
        "city": {
          "id": "TUxBQ1ZJTGU4OGM3",
          "name": "Villa Gesell"
        },
        "state": {
          "id": "TUxBUENPU2ExMmFkMw",
          "name": "Bs.as. Costa Atlántica"
        },
        "country": {
          "id": "AR",
          "name": "Argentina"
        },
        "latitude": -37.2598939,
        "longitude": -56.9714194,
        "open_hours": ""
      },
      "geolocation": {
        "latitude": -37.2598939,
        "longitude": -56.9714194
      },
      "coverage_areas": [
      ],
      "attributes": [
        {
          "id": "CAPPERSO",
          "name": "Capacidad de personas",
          "value_id": "CAPPERSO-5",
          "value_name": "5",
          "attribute_group_id": "ADICIONALES",
          "attribute_group_name": "Adicionales"
        },
        {
          "id": "CKECKIN",
          "name": "Check in",
          "value_id": "CKECKIN-11:00",
          "value_name": "11:00",
          "attribute_group_id": "ADICIONALES",
          "attribute_group_name": "Adicionales"
        },
        {
          "id": "CKECKOUT",
          "name": "Check out",
          "value_id": "CKECKOUT-09:00",
          "value_name": "09:00",
          "attribute_group_id": "ADICIONALES",
          "attribute_group_name": "Adicionales"
        },
        {
          "id": "FECHADESDE",
          "name": "Desde",
          "value_id": "",
          "value_name": "1 de nero",
          "attribute_group_id": "ADICIONALES",
          "attribute_group_name": "Adicionales"
        },
        {
          "id": "FECHAHASTA",
          "name": "Hasta",
          "value_id": "",
          "value_name": "TODO EL AÑO",
          "attribute_group_id": "ADICIONALES",
          "attribute_group_name": "Adicionales"
        },
        {
          "id": "MLA50283-CUADRCENT",
          "name": "A cuantas cuadras del centro",
          "value_id": "MLA50283-CUADRCENT-1",
          "value_name": "1",
          "attribute_group_id": "ADICIONALES",
          "attribute_group_name": "Adicionales"
        },
        {
          "id": "MLA50283-CUADRMAR",
          "name": "A cuantas cuadras del mar",
          "value_id": "MLA50283-CUADRMAR-4",
          "value_name": "4",
          "attribute_group_id": "ADICIONALES",
          "attribute_group_name": "Adicionales"
        },
        {
          "id": "MLA50283-NUMVAJI",
          "name": "Vajilla para # de personas",
          "value_id": "MLA50283-NUMVAJI-6",
          "value_name": "6",
          "attribute_group_id": "ADICIONALES",
          "attribute_group_name": "Adicionales"
        },
        {
          "id": "MLA50283-SEÑA",
          "name": "% de seña",
          "value_id": "MLA50283-SEÑA-MAS-DE-50%",
          "value_name": "Más de 50%",
          "attribute_group_id": "ADICIONALES",
          "attribute_group_name": "Adicionales"
        },
        {
          "id": "NUMEROCAMA",
          "name": "Número de camas",
          "value_id": "NUMEROCAMA-6",
          "value_name": "6",
          "attribute_group_id": "ADICIONALES",
          "attribute_group_name": "Adicionales"
        },
        {
          "id": "PERIOTEMPO",
          "name": "Estadía Mínima",
          "value_id": "PERIOTEMPO-15",
          "value_name": "15",
          "attribute_group_id": "ADICIONALES",
          "attribute_group_name": "Adicionales"
        },
        {
          "id": "TIPOHABITA",
          "name": "Tipo de habitación",
          "value_id": "TIPOHABITA-HABPRIVA",
          "value_name": "Habitación privada",
          "attribute_group_id": "ADICIONALES",
          "attribute_group_name": "Adicionales"
        },
        {
          "id": "BALTERR",
          "name": "Balcón",
          "value_id": "BALTERR-N",
          "value_name": "No",
          "attribute_group_id": "AMBIENTES",
          "attribute_group_name": "Ambientes"
        },
        {
          "id": "COCI",
          "name": "Cocina",
          "value_id": "COCI-Y",
          "value_name": "Si",
          "attribute_group_id": "AMBIENTES",
          "attribute_group_name": "Ambientes"
        },
        {
          "id": "COME",
          "name": "Comedor diario",
          "value_id": "COME-Y",
          "value_name": "Si",
          "attribute_group_id": "AMBIENTES",
          "attribute_group_name": "Ambientes"
        },
        {
          "id": "DEPSERV",
          "name": "Dependencia de servicio",
          "value_id": "DEPSERV-N",
          "value_name": "No",
          "attribute_group_id": "AMBIENTES",
          "attribute_group_name": "Ambientes"
        },
        {
          "id": "DORMSUIT",
          "name": "Dormitorio en suite",
          "value_id": "DORMSUIT-Y",
          "value_name": "Si",
          "attribute_group_id": "AMBIENTES",
          "attribute_group_name": "Ambientes"
        },
        {
          "id": "ESCRITORIO",
          "name": "Escritorio",
          "value_id": "ESCRITORIO-N",
          "value_name": "No",
          "attribute_group_id": "AMBIENTES",
          "attribute_group_name": "Ambientes"
        },
        {
          "id": "ESTAR",
          "name": "Estar",
          "value_id": "ESTAR-N",
          "value_name": "No",
          "attribute_group_id": "AMBIENTES",
          "attribute_group_name": "Ambientes"
        },
        {
          "id": "LAVA",
          "name": "Lavadero",
          "value_id": "LAVA-Y",
          "value_name": "Si",
          "attribute_group_id": "AMBIENTES",
          "attribute_group_name": "Ambientes"
        },
        {
          "id": "LIVCOM",
          "name": "Living comedor",
          "value_id": "LIVCOM-Y",
          "value_name": "Si",
          "attribute_group_id": "AMBIENTES",
          "attribute_group_name": "Ambientes"
        },
        {
          "id": "LIVI",
          "name": "Living",
          "value_id": "LIVI-N",
          "value_name": "No",
          "attribute_group_id": "AMBIENTES",
          "attribute_group_name": "Ambientes"
        },
        {
          "id": "PAT",
          "name": "Patio",
          "value_id": "PAT-Y",
          "value_name": "Si",
          "attribute_group_id": "AMBIENTES",
          "attribute_group_name": "Ambientes"
        },
        {
          "id": "PLAYROOM",
          "name": "Playroom",
          "value_id": "PLAYROOM-N",
          "value_name": "No",
          "attribute_group_id": "AMBIENTES",
          "attribute_group_name": "Ambientes"
        },
        {
          "id": "TERRA",
          "name": "Terraza",
          "value_id": "TERRA-N",
          "value_name": "No",
          "attribute_group_id": "AMBIENTES",
          "attribute_group_name": "Ambientes"
        },
        {
          "id": "TOIL",
          "name": "Toilette",
          "value_id": "TOIL-N",
          "value_name": "No",
          "attribute_group_id": "AMBIENTES",
          "attribute_group_name": "Ambientes"
        },
        {
          "id": "VEST",
          "name": "Vestidor",
          "value_id": "VEST-N",
          "value_name": "No",
          "attribute_group_id": "AMBIENTES",
          "attribute_group_name": "Ambientes"
        },
        {
          "id": "AIRCEN",
          "name": "Aire acondicionado",
          "value_id": "AIRCEN-N",
          "value_name": "No",
          "attribute_group_id": "COMODIDADES",
          "attribute_group_name": "Comodidades"
        },
        {
          "id": "AMOBL",
          "name": "Amoblado",
          "value_id": "AMOBL-Y",
          "value_name": "Si",
          "attribute_group_id": "COMODIDADES",
          "attribute_group_name": "Comodidades"
        },
        {
          "id": "APTOFAMILY",
          "name": "Apto para familias/niños",
          "value_id": "APTOFAMILY-Y",
          "value_name": "Si",
          "attribute_group_id": "COMODIDADES",
          "attribute_group_name": "Comodidades"
        },
        {
          "id": "APTOFUMA",
          "name": "Apto para fumadores",
          "value_id": "APTOFUMA-Y",
          "value_name": "Si",
          "attribute_group_id": "COMODIDADES",
          "attribute_group_name": "Comodidades"
        },
        {
          "id": "BAR",
          "name": "Bar",
          "value_id": "BAR-N",
          "value_name": "No",
          "attribute_group_id": "COMODIDADES",
          "attribute_group_name": "Comodidades"
        },
        {
          "id": "CAJASEG",
          "name": "Caja de seguridad",
          "value_id": "CAJASEG-N",
          "value_name": "No",
          "attribute_group_id": "COMODIDADES",
          "attribute_group_name": "Comodidades"
        },
        {
          "id": "CALCEN",
          "name": "Calefacción",
          "value_id": "CALCEN-N",
          "value_name": "No",
          "attribute_group_id": "COMODIDADES",
          "attribute_group_name": "Comodidades"
        },
        {
          "id": "CANCHAGOLF",
          "name": "Cancha de golf",
          "value_id": "CANCHAGOLF-N",
          "value_name": "No",
          "attribute_group_id": "COMODIDADES",
          "attribute_group_name": "Comodidades"
        },
        {
          "id": "CANCHAPADD",
          "name": "Cancha de paddle",
          "value_id": "CANCHAPADD-N",
          "value_name": "No",
          "attribute_group_id": "COMODIDADES",
          "attribute_group_name": "Comodidades"
        },
        {
          "id": "CANFUT",
          "name": "Cancha de fútbol",
          "value_id": "CANFUT-N",
          "value_name": "No",
          "attribute_group_id": "COMODIDADES",
          "attribute_group_name": "Comodidades"
        },
        {
          "id": "CONINT",
          "name": "Conexión a internet",
          "value_id": "CONINT-Y",
          "value_name": "Si",
          "attribute_group_id": "COMODIDADES",
          "attribute_group_name": "Comodidades"
        },
        {
          "id": "DESAYUNOINCLU",
          "name": "Desayuno incluido",
          "value_id": "DESAYUNOINCLU-N",
          "value_name": "No",
          "attribute_group_id": "COMODIDADES",
          "attribute_group_name": "Comodidades"
        },
        {
          "id": "ESTACIOINCLU",
          "name": "Estacionamiento",
          "value_id": "ESTACIOINCLU-N",
          "value_name": "No",
          "attribute_group_id": "COMODIDADES",
          "attribute_group_name": "Comodidades"
        },
        {
          "id": "HIDRO",
          "name": "Hidromasaje",
          "value_id": "HIDRO-N",
          "value_name": "No",
          "attribute_group_id": "COMODIDADES",
          "attribute_group_name": "Comodidades"
        },
        {
          "id": "JARD",
          "name": "Jardín",
          "value_id": "JARD-Y",
          "value_name": "Si",
          "attribute_group_id": "COMODIDADES",
          "attribute_group_name": "Comodidades"
        },
        {
          "id": "LAVASECA",
          "name": "Lavarropa/Secarropa",
          "value_id": "LAVASECA-N",
          "value_name": "No",
          "attribute_group_id": "COMODIDADES",
          "attribute_group_name": "Comodidades"
        },
        {
          "id": "MLA50283-CALE",
          "name": "Calefón",
          "value_id": "MLA50283-CALE-Y",
          "value_name": "Si",
          "attribute_group_id": "COMODIDADES",
          "attribute_group_name": "Comodidades"
        },
        {
          "id": "MLA50283-DEPOGA",
          "name": "Depósito en garantía $",
          "value_id": "",
          "value_name": "3000",
          "attribute_group_id": "COMODIDADES",
          "attribute_group_name": "Comodidades"
        },
        {
          "id": "MLA50283-DVD",
          "name": "DVD",
          "value_id": "MLA50283-DVD-N",
          "value_name": "No",
          "attribute_group_id": "COMODIDADES",
          "attribute_group_name": "Comodidades"
        },
        {
          "id": "MLA50283-GASNAT",
          "name": "Gas natural",
          "value_id": "MLA50283-GASNAT-Y",
          "value_name": "Si",
          "attribute_group_id": "COMODIDADES",
          "attribute_group_name": "Comodidades"
        },
        {
          "id": "MLA50283-ROPABL",
          "name": "Ropa blanca",
          "value_id": "MLA50283-ROPABL-N",
          "value_name": "No",
          "attribute_group_id": "COMODIDADES",
          "attribute_group_name": "Comodidades"
        },
        {
          "id": "MLA50283-TERMO",
          "name": "Termotanque",
          "value_id": "MLA50283-TERMO-N",
          "value_name": "No",
          "attribute_group_id": "COMODIDADES",
          "attribute_group_name": "Comodidades"
        },
        {
          "id": "MLA50283-VENTITE",
          "name": "Ventilador de techo",
          "value_id": "MLA50283-VENTITE-Y",
          "value_name": "Si",
          "attribute_group_id": "COMODIDADES",
          "attribute_group_name": "Comodidades"
        },
        {
          "id": "PARR",
          "name": "Parrilla",
          "value_id": "PARR-Y",
          "value_name": "Si",
          "attribute_group_id": "COMODIDADES",
          "attribute_group_name": "Comodidades"
        },
        {
          "id": "PERMIMASCO",
          "name": "Permite mascotas",
          "value_id": "PERMIMASCO-Y",
          "value_name": "Si",
          "attribute_group_id": "COMODIDADES",
          "attribute_group_name": "Comodidades"
        },
        {
          "id": "PHONETEPAN",
          "name": "Linea telefónica",
          "value_id": "PHONETEPAN-N",
          "value_name": "No",
          "attribute_group_id": "COMODIDADES",
          "attribute_group_name": "Comodidades"
        },
        {
          "id": "PILNAT",
          "name": "Pileta",
          "value_id": "PILNAT-N",
          "value_name": "No",
          "attribute_group_id": "COMODIDADES",
          "attribute_group_name": "Comodidades"
        },
        {
          "id": "QUINCHO",
          "name": "Quincho",
          "value_id": "QUINCHO-N",
          "value_name": "No",
          "attribute_group_id": "COMODIDADES",
          "attribute_group_name": "Comodidades"
        },
        {
          "id": "RESTAUR",
          "name": "Restaurante",
          "value_id": "RESTAUR-N",
          "value_name": "No",
          "attribute_group_id": "COMODIDADES",
          "attribute_group_name": "Comodidades"
        },
        {
          "id": "SAUNA",
          "name": "Sauna",
          "value_id": "SAUNA-N",
          "value_name": "No",
          "attribute_group_id": "COMODIDADES",
          "attribute_group_name": "Comodidades"
        },
        {
          "id": "SOLARI",
          "name": "Solarium",
          "value_id": "SOLARI-N",
          "value_name": "No",
          "attribute_group_id": "COMODIDADES",
          "attribute_group_name": "Comodidades"
        },
        {
          "id": "SOM",
          "name": "SUM",
          "value_id": "SOM-N",
          "value_name": "No",
          "attribute_group_id": "COMODIDADES",
          "attribute_group_name": "Comodidades"
        },
        {
          "id": "SPA",
          "name": "Spa",
          "value_id": "SPA-N",
          "value_name": "No",
          "attribute_group_id": "COMODIDADES",
          "attribute_group_name": "Comodidades"
        },
        {
          "id": "TVXCABLE",
          "name": "TV por cable",
          "value_id": "TVXCABLE-Y",
          "value_name": "Si",
          "attribute_group_id": "COMODIDADES",
          "attribute_group_name": "Comodidades"
        },
        {
          "id": "VIGI",
          "name": "Seguridad",
          "value_id": "VIGI-N",
          "value_name": "No",
          "attribute_group_id": "COMODIDADES",
          "attribute_group_name": "Comodidades"
        },
        {
          "id": "WIFI",
          "name": "Wifi",
          "value_id": "WIFI-Y",
          "value_name": "Si",
          "attribute_group_id": "COMODIDADES",
          "attribute_group_name": "Comodidades"
        },
        {
          "id": "MLA1459-HORPREF",
          "name": "Horario de contacto",
          "value_id": "",
          "value_name": "de 8 a 22",
          "attribute_group_id": "FIND",
          "attribute_group_name": "Ficha técnica"
        },
        {
          "id": "MLA1459-INMUEBLE",
          "name": "Inmueble",
          "value_id": "MLA1459-INMUEBLE-OTRO_INMUEBLE",
          "value_name": "Otros Inmuebles",
          "attribute_group_id": "FIND",
          "attribute_group_name": "Ficha técnica"
        },
        {
          "id": "MLA1459-OPERACION",
          "name": "Operación",
          "value_id": "MLA1459-OPERACION-ALQUILER_DE_TEMPORADA",
          "value_name": "Alquiler Temporario",
          "attribute_group_id": "FIND",
          "attribute_group_name": "Ficha técnica"
        },
        {
          "id": "MLA1892-ANTIG",
          "name": "Antigüedad",
          "value_id": "MLA1892-ANTIG-MAX_10_ANOS",
          "value_name": "Max 10 años",
          "attribute_group_id": "FIND",
          "attribute_group_name": "Ficha técnica"
        },
        {
          "id": "MLA1892-ESTADO",
          "name": "Estado",
          "value_id": "MLA1892-ESTADO-MUY_BUENO",
          "value_name": "Muy bueno",
          "attribute_group_id": "FIND",
          "attribute_group_name": "Ficha técnica"
        },
        {
          "id": "MLA1892-MTRS",
          "name": "Superficie cubierta (m²)",
          "value_id": "",
          "value_name": "35",
          "attribute_group_id": "FIND",
          "attribute_group_name": "Ficha técnica"
        },
        {
          "id": "MLA1892-MTRSTOTAL",
          "name": "Superficie total (m²)",
          "value_id": "",
          "value_name": "44",
          "attribute_group_id": "FIND",
          "attribute_group_name": "Ficha técnica"
        },
        {
          "id": "MLA1892-TIPOINMUEB",
          "name": "Tipo de inmueble",
          "value_id": "",
          "value_name": "petit hotel",
          "attribute_group_id": "FIND",
          "attribute_group_name": "Ficha técnica"
        }
      ],
      "warnings": [
      ],
      "listing_source": "",
      "variations": [
      ],
      "status": "active",
      "sub_status": [
      ],
      "tags": [
      ],
      "warranty": null,
      "catalog_product_id": null,
      "parent_item_id": null,
      "differential_pricing": null,
      "deal_ids": [
      ],
      "automatic_relist": false,
      "date_created": "2016-01-31T14:16:20.000Z",
      "last_updated": "2016-02-01T05:46:48.000Z"
    }


    There’s a lot of information in the Json response. Below you’ll find some important guidelines.

    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

    On classified items, even though you can send a title that’s gonna be displayed on the item details page, users who are browsing classifieds will see on the list a titled that’s generated by us basing on the attributes you setted on the item.

    Description

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

    Pictures

    Good pictures can make your property 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 types

    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 property best.

    List a real estate property

    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 product on the site:

    curl -X POST -H "Content-Type: application/json" -d {
    "title": "Property title",
    "category_id": "MLA401686",
    "price": 100000,
    "currency_id": "ARS",
    "available_quantity": 1,
    "buying_mode": "classified",
    "listing_type_id": "silver",
    "condition": "not_specified",
    "pictures": [
    {
    "source":"http://mla-d2-p.mlstatic.com/item-de-test-no-ofertar-543605-MLA25041518406_092016-O.jpg?square=false"
    }
    ],
    "seller_contact": {
    "contact": "Contact name",
    "other_info": "Additional contact info",
    "area_code": "011",
    "phone": "4444-5555",
    "area_code2": "",
    "phone2": "",
    "email": "contact-email@somedomain.com",
    "webmail": ""
    },
    "location": {
    "address_line": "My property address 1234",
    "zip_code": "01234567",
    "neighborhood": {
    "id": "TUxBQlBBUzgyNjBa"
    },
    "latitude": -34.48755,
    "longitude": -58.56987
    },
    "attributes": [
    {
    "id": "ROOMS",
    "value_name": "2"
    },
    {
    "id": "FULL_BATHROOMS",
    "value_name": "1"
    },
    {
    "id": "PARKING_LOTS",
    "value_name": "1"
    },
    {
    "id": "BEDROOMS",
    "value_name": "4"
    },
    {
    "id": "COVERED_AREA",
    "value_name": "30 m²"
    },
    {
    "id": "TOTAL_AREA",
    "value_name": "40 m²"
    }
    ],
    "description": "This is the real estate property descritpion."
    }
    https://api.mercadolibre.com/items?access_token=$ACCESS_TOKEN

    Modify the location of your property

     curl -X PUT -d '{
    	"location": {
    		"address_line": "My property address NEW 111",
    		"zip_code": "5000",
    		"neighborhood": {
    			"id": "TUxBQk9UUjI3MjVa",
    			"name": "Otros Barrios"
    		},
    		"city": {
    			"id": "TUxBQ0NBUGNiZGQx",
    			"name": "Córdoba"
    		}
    	}
    }' https://api.mercadolibre.com/items/{item_id}?access_token=$ACCESS_TOKEN



    Next topic: Sync your listings.

    Please rate this