Documentação do Mercado Livre
Confira todas as informações necessárias sobre as APIs Mercado Livre.
Documentação do
Publicação de serviços
Princípios básicos
De modo geral, serviços constitui 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 serviços 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 serviço diretamente de nosso site, mas vai mostrá-la a todos os usuários que estiverem buscando serviços 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 serviço 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 serviço
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 serviço
Vamos ver um serviço 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 -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/$ITEM_IDExemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/MLA603335359Resposta:
{
"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.
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' http://developers.mercadolibre.com/list-your-item/ - listing-type-attributeA 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 serviço 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 serviço 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. Saiba como modificar produtos.
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 -H 'Authorization: Bearer $ACCESS_TOKEN' -d '{"seller_custom_field": "21000093"}' https://api.mercadolibre.com/items/MLA599074368
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 serviço.
Chamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/$SITE_ID/listing_typesExemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/MLA/listing_typesResposta:
[
{
"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 serviço
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. 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 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d{
title: "Property title",
category_id: "MLA1474",
price: 100000,
currency_id: "ARS",
available_quantity: 1,
buying_mode: "classified",
listing_type_id: "silver",
condition: "not_specified",
pictures: [
{
id: "MLA2096545948_102011"
},
{
source:"http://media.point2.com/p2a/htmltext/f2a4/590f/3627/f49be256595a86c91457/original.jpg"
}
],
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: "MLA1472-ANTIG",
value_id: "MLA1472-ANTIG-A_ESTRENAR"
},
{
id: "MLA1472-DISPOSIC",
value_id: "MLA1472-DISPOSIC-FRENTE"
},
{
id: "MLA1472-AMBQTY",
value_id: "MLA1472-AMBQTY-2"
},
{
id: "MLA1472-BATHQTY",
value_id: "MLA1472-BATHQTY-1"
},
{
id: "MLA1472-DORMQTY",
value_id: "MLA1472-DORMQTY-2"
},
{
id: "MLA1472-EDIFIC",
value_id: "MLA1472-EDIFIC-DEPARTAMENTO"
},
{
id: "MLA1472-MTRS",
value_name: "80"
},
{
id: "MLA1472-MTRSTOTAL",
value_name: "100"
}
],
description : "This is the real estate property description."
}
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. 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",
...
}Parabéns! Você publicou seu primeiro produto! Acesse a página Detalhes do produto por meio do permalink. Para calcular os feeds de venda de um produto por diferentes parâmetros, acompanhar o guia da Calculadora de preços de publicações.
Lojas Oficiais para Veículos e Imóveis
Consulte a seguinte documentação Lojas Oficiais para Veículos e Imóveis.
Próximo: Sincronização de publicações