Publicação de imóveis

Agora que já analisamos os principais assuntos, acreditamos que você esteja pronto para realizar sua primeira publicação. Leia o tutorial e aprenda a fazer isso:

Assuntos:

Princípios básicos

De modo geral, imóveis e classificados constituem o único tipo de publicação que permite aos usuários mostrarem suas informações de contato ao público; por isso, toda vez que os usuários buscam imóveis para alugar ou comprar e se interessam por uma de suas publicações, podem entrar em contato com você imediatamente. Desse modo você não venderá nem alugará seu imóvel diretamente de nosso site, mas vai mostrá-la a todos os usuários que estiverem buscando imóveis na Web.

Resultados das publicações

Cada imóvel que você publicar aparecerá nos resultados das publicações de uma determinada busca. Por exemplo, quando um usuário estiver buscando a consulta “Casa em Mar del Plata”, ele obterá como resultado uma lista de todos os itens relacionados. Seu imóvel pode estar incluído nessa lista.
Quando alguém clica em um imóvel, ele é exibido na página de detalhes junto com todas as informações sobre ele que tenham sido fornecidas no momento da publicação. Para obter mais informações, continue lendo a respeito.

Campos do imóvel

Vamos consultar um imóvel pela API. Isso é fácil, pois você só precisa conhecer o item_id associado a tal item e, como ele é público, pode ser obtido na página do item. O itemd_id é encontrado na parte superior da página. É preciso acrescentar o site_id antes do número que está vendo e pronto. Agora você pode chamar o recurso Items para obter todas as informações de que precisa:

Chamada:

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

Exemplo:

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

Resposta:

 {
  "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_Mercado Pago": 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"
}

A resposta JSON contém muitas informações. A seguir, você encontrará a descrição de alguns desses campos.

Definição de atributos

É necessário saber que, ao criar um JSON para seu anúncio, alguns dos campos são obrigatórios, enquanto outros podem ser omitidos ou serão automaticamente adicionados pelo ML. Eles definirão o modo como o anúncio será exibido e sua posição nos resultados da busca.
Abaixo mencionamos os campos mais importantes que devem ser enviados. Lembre-se que além deles, devem também ser enviados os campos complementadores (atributos) no array de atributos. Para maiores informações, leia o guia de categorias e atributos.

Title

Embora você possa enviar um título que será exibido na página de detalhes do produto, nos itens classificados, os usuários que estiverem fazendo uma busca visualizarão um título na lista, o qual é gerado pelo Mercado Livre com base nos atributos que você configurou para tal produto.

Description

Uma descrição detalhada irá melhorar suas possibilidades de alugar ou vender seu imóvel e fará com que você poupe tempo, já que não terá de responder a perguntas desnecessárias. Ao trabalhar com descrições, há algumas considerações a serem levadas em conta. Se você estiver interessado em saber mais sobre o assunto, consulte nosso guia Trabalhando com descrições.

Pictures

Imagens de boa qualidade podem fazer com que seu imóvel seja mais atrativo e dão aos usuários uma ideia mais precisa de como ele é. Basicamente, você deve adicionar um conjunto de até seis imagens URL no 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"}
 ]
 ...
}

Recomendamos não usar servidores lentos para hospedar suas imagens, pois pode gerar inconvenientes ao fazer a publicação.
Você também pode adicionar ou alterar as imagens de seu produto aqui posteriormente. Leia mais sobre isso para saber quais são os tipos de imagens permitidas e como trabalhar com elas.

Category

Os vendedores deverão definir uma categoria no site do Mercado Livre. Esse atributo é obrigatório e somente aceita IDs pré-estabelecidos. Para obter mais informações, leia o guia de categorias e atributos.

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

Price

Este atributo é obrigatório. Ao definir um novo anúncio, ele deve ter um preço. Se você já tiver definido um preço, mas não está satisfeito com ele, poderá alterá-lo posteriormente.

Currency

Além do preço, você deverá definir uma moeda. Esse atributo também é obrigatório. A moeda deverá ser definida usando um ID pré-estabelecido. Veja exemplos do recurso moedas aqui.

Listing type

Basicamente é o plano contratado pelo seu cliente. Trata-se de outro caso de atributo obrigatório que só aceita valores pré-definidos e é muito importante que você entenda isso.
Existem diferentes tipos de publicação disponíveis para cada site. Você deve fazer uma chamada mista através dos sites e dos recursos listing_types para saber quais são os listing_types aceitos. Siga nosso guia para saber qual o tipo de publicação mais conveniente para seu anúncio.

Chamada:

 curl https://api.mercadolibre.com/sites/{Site_id}/listing_types

Exemplo:

 curl https://api.mercadolibre.com/sites/MLA/listing_types

Resposta:

 [
  {
    "site_id": "MLA",
    "id": "gold_pro",
    "name": "Oro Premium Full"
  },
  {
    "site_id": "MLA",
    "id": "gold_premium",
    "name": "Oro Premium"
  },
  {
    "site_id": "MLA",
    "id": "gold_special",
    "name": "Oro Profesional"
  },
  {
    "site_id": "MLA",
    "id": "gold",
    "name": "Oro"
  },
  {
    "site_id": "MLA",
    "id": "silver",
    "name": "Plata"
  },
  {
    "site_id": "MLA",
    "id": "bronze",
    "name": "Bronce"
  },
  {
    "site_id": "MLA",
    "id": "free",
    "name": "Gratuita"
  }
]

Available_quantity

Deve ser sempre enviado “1”. Representa a quantidade de itens deste anúncio. No Mercado Livre, os anúncios classificados não trabalham com estoque, cada anúncio representa um registro de imóvel / veículo / serviço único.

Condition

Pode ser “new” ou “used”, dependendo da condição do anúncio a ser enviado.

Publicação de um imóvel

Agora você já está pronto para publicar seu primeiro imóvel. Lembre de que, para isso, você vai precisar de um access_token. Se tiver dúvidas sobre como obter seu token de acesso, consulte o tutorial Autenticação e Autorização. Além disso, recomendamos validar o JSON que estiver enviando antes de realizar a solicitação POST; por isso, é melhor consultar nosso tutorial de validação de anúncios. É fácil e rápido.
Você pode criar um JSON para seu imóvel com base no exemplo abaixo, ou simplesmente enviá-lo, e você estará publicando um imóvel de exemplo no 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": {plain_text: "This is the real estate property description. \n"},
}
https://api.mercadolibre.com/items?access_token=$ACCESS_TOKEN

Observe que o exemplo acima só funciona no MLA (Argentina). Caso você esteja trabalhando em qualquer outro país, deverá substituir os valores de category_id, currency_id e talvez listing_type_id.

Você receberá a seguinte resposta JSON:

 {
  "id":"MLA430387888",
  "site_id":"MLA",
  "title":"Anteojos Ray Ban Wayfare",
  "sold_quantity":0,
  "permalink":"http://articulo.mercadolibre.com.ar/MLA-430387888-anteojos-ray-ban-wayfare-_JM",
  ...
}

Modificar a localização de imóveis

Para realizar alterações na publicação, deve ser enviado um PUT com os novos campos a serem alterados. No exemplo abaixo, é enviada uma nova localização:

 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



Próximo:
Sincronização de publicações.

Qualifique entre 1 e 5