Publicação de imóveis

Agora que já analisamos os assuntos autenticação, usuários e categorias, 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, podem entrar em contato com você imediatamente. Portanto, nos produtos classificados nenhum tipo de transação é realizado; 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 produto 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 produto, ele é exibido na página de detalhes do produto 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.

Página Detalhes do produto

Esta é a página principal de nosso Mercado para cada produto.
Quando um usuário seleciona um produto do resultado, essa página exibe os seguintes detalhes:

  • Item_id
  • Title
  • Category
  • Pictures
  • Price
  • City
  • Sold quantity
  • Questions
  • Seller’s reputation
  • Detailed description

Campos do imóvel

Vamos ver um imóvel normal 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. Na Argentina, isso é 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"
}

Obtenção da resposta usando nossos SDKs.

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 produto, 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 produto será exibido e sua posição nos resultados da busca.

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. Pode ser uma descrição somente com texto, ou você pode adicionar seu próprio HTML personalizado. 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 Para obter uma sugestão de categorias, acesse leia o artigo.

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

Price

Este atributo é obrigatório. Ao definir um novo produto, ele deve ter um preço. Sugerimos que você busque produtos similares em nosso Marketplace para saber qual é o melhor preço e aumentar sua competitividade. 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. Você vai saber qual é o ID a enviar chamando para o recurso Moedas.

Seller Custom Field

Apesar de não ser obrigatório, o campo personalizável do vendedor, é muito útil porque não há valores pré-estabelecidos e você pode enviar tudo que quiser como uma cadeia de caracteres. A maior parte dos vendedores utiliza esse campo para colocar seus próprios SKUs para seus produtos para identificar o produto vendido no pedido.
Exemplo:

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

Listing type

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 imóvel.

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"
  }
]

Publicação de um imóvel

Agora você já está pronto para publicar seu primeiro item classificado. 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 Primeiros passos. Além isso, 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 produto com base no exemplo abaixo, ou simplesmente enviá-lo, e você estará publicando um produto de amostra 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": "This is the real estate property descritpion."
}
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.
Vamos fazer isso com nosso SDK:
[Exemplos de SDK] A API Produtos baixará automaticamente as imagens fornecidas no Mercado Livre Storage, criando uma publicação para seu produto. 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

 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