Gerenciamento de contatos

Toda vez que os usuários fazem uma busca nos produtos classificados, eles podem contatar o proprietário do produto por meio de um formulário exibido na publicação ou podem ver o telefone do proprietário. 
Existe uma diferença de funcionamento para usuários que fizeram login e convidados. Quando usuários convidados fazem uma pergunta sobre seu produto, o contato é dirigido diretamente à caixa de entrada de seu correio eletrônico e é exibido em nosso recurso de contatos, pois não está seguindo o fluxo habitual das perguntas. Quando um usuário que já tem conta em nosso site e já fez login faz uma pergunta, ele segue o fluxo habitual das perguntas e a API de perguntas pode ser usada.

Para ver como trabalhar com perguntas feitas por usuários conectados, consulte nosso guia de Gerenciamento de perguntas e respostas.

Este guia ajudará você a coletar dados sobre perguntas e visualizações de telefone em seus produtos classificados. É uma API somente leitura, muito útil para fazer métricas de seus produtos classificados. Você pode consultar dados sobre perguntas e fazer um registro de quantos cliques a opção “Ver telefone” teve. Você pode consultar por usuário, produto, datas e períodos.

Assuntos:

 

Descrição de parâmetros

Tipo Parâmetro Descrição
Integer {userId} ID de usuário.
Integer {itemId} ID do produto.
Date {dateFrom} Data, no formato ISO, que define o início da consulta.
Date {dateTo} Data, no formato ISO, que define o final da consulta.
Integer {limit} Opcional. Quantidade máxima de produtos a devolver.
Integer {offset} Opcional. Paginação.
Integer {last} Opcional. Denota quantas horas/dias a amostra abrangerá.
String {unit} Unidade de consulta, valores possíveis: [“dia”, “hora”].
Date {ending} Opcional. Data, em formato ISO, estabelecendo o tempo de finalização da amostra; por padrão, deve ser a data e a hora atuais.
String {order} Opcional. Classifica os resultados por data: [“desc”, “asc”] (por padrão, “asc”).

Total de perguntas

Você pode acessar o total de perguntas que um produto teve, ou o total de perguntas recebidas por um vendedor em todos os seus produtos, em um intervalo de tempo.

Por produto

GET https://api.mercadolibre.com/items/{Item_id}/contacts/questions?date_from={Date_from}&date_to={Date_to}

Por usuário

curl -X GET https://api.mercadolibre.com/users/{User_id}/contacts/questions?date_from={Date_from}&date_to={Date_to}

Exemplo:

curl -X GET https://api.mercadolibre.com/items/MLV421672596/contacts/questions?date_from=2014-08-01T00:00:00.000-03:00&date_to=2014-08-02T23:59:59.999

Resposta:

{
    "date_from": "2014-08-01T00:00:00.000-03:00",
    "date_to": "2014-08-02T23:59:59.999",
    "item_id": "MLV421672596",
    "total": 9
}

Perguntas por data

Este recurso permite acessar as perguntas sobre um determinado produto ou vendedor durante um intervalo de tempo especificado. Além disso, você obtém detalhes sobre contatos feitos em modo convidado (usuários que não fizeram login ou não são cadastrados), em intervalos de tempo, por hora ou por dia.

Por produto

curl -X GET https://api.mercadolibre.com/items/{Item_id}/contacts/questions/time_window?last={Last}&unit={Unit}

Caso você precise concatenar produtos, faça o seguinte:

curl -X GET https://api.mercadolibre.com/items/{Item_id}/contacts/questions/time_window?ids={id1,id2}&last={Last}&unit={Unit}&ending={Ending_date}

Por usuário

curl -X GET https://api.mercadolibre.com/users/{User_id}/contacts/questions/time_window?last={Last}&unit={Unit}

Exemplo:

curl -X GET https://api.mercadolibre.com/items/MLA510272257/contacts/questions/time_window?last=2&unit=hour

Resposta:

{
    "item_id": "MLA510272257",
    "total": 0,
    "date_from": "2014-08-06T12:00:00Z",
    "date_to": "2014-08-06T14:00:00Z",
    "last": 2,
    "unit": "hour",
    "results": [
        {
            "date": "2014-08-06T12:00:00Z",
            "total": 0
        },
        {
            "date": "2014-08-06T13:00:00Z",
            "total": 0
        }
    ]
}


Total de telefones de contato

Você pode acessar o total de cliques da opção “Ver telefone“ de um produto, ou para cada um dos produtos de um usuário, em intervalos de tempo.

Por produto

curl -X GET https://api.mercadolibre.com/items/{Item_id}/contacts/phone_views?date_from={Date_from}&date_to={Date_to}

Por usuário

curl -X GET https://api.mercadolibre.com/users/{User_id}/contacts/phone_views?date_from={Date_from}&date_to={Date_to}

Exemplo:

curl -X GET https://api.mercadolibre.com/users/52366166/contacts/phone_views?date_from=2014-05-28T00:00:00.000-03:00&date_to=2014-05-29T23:59:59.999

Resposta:

{
    "date_from": "2014-05-28T00:00:00.000-03:00",
    "date_to": "2014-05-29T23:59:59.999",
    "total": 71,
    "user_id": "52366166"
}

Telefones de contato por data

Você pode acessar o total de cliques da opção “Ver telefone” de um produto, ou para cada um dos produtos de um usuário, durante um determinado intervalo de tempo. Além de fornecer o total de visitas, as informações são listadas e agrupadas por intervalos de tempo.

Por produto

curl -X GET https://api.mercadolibre.com/items/{Item_id}/contacts/phone_views/time_window?last={Last}&unit={Unit}

Caso você precise concatenar produtos, faça o seguinte:

curl -X GET https://api.mercadolibre.com/items/contacts/phone_views/time_window?ids={Id1,Id2}&last={Last}&unit={Unit}&ending={Ending_date}

Por usuário

curl -X GET https://api.mercadolibre.com/users/{User_id}/contacts/phone_views/time_window?last={Last}&unit={Unit}

Exemplo:

curl -X GET https://api.mercadolibre.com/items/contacts/phone_views/time_window?ids=MLA510272257,MLA489747739&last=2&unit=hour&ending=2014-05-28T00:00:00.000-03:00

Resposta:

[
    {
        "item_id": "MLA510272257",
        "total": 0,
        "date_from": "2014-05-28T02:00:00Z",
        "date_to": "2014-05-28T04:00:00Z",
        "last": 2,
        "unit": "hour",
        "results": [
            {
                "date": "2014-05-28T02:00:00Z",
                "total": 0
            },
            {
                "date": "2014-05-28T03:00:00Z",
                "total": 0
            }
        ]
    },
    {
        "item_id": "MLA489747739",
        "total": 0,
        "date_from": "2014-05-28T02:00:00Z",
        "date_to": "2014-05-28T04:00:00Z",
        "last": 2,
        "unit": "hour",
        "results": [
            {
                "date": "2014-05-28T02:00:00Z",
                "total": 0
            },
            {
                "date": "2014-05-28T03:00:00Z",
                "total": 0
            }
        ]
    }
]




Próximo:
Recebimento de notificações.

Please rate this

Consultas avançadas

Se sua intenção é que os vendedores usem o aplicativo que você desenvolveu para potencializar seus negócios, leve em conta que existem muitíssimas informações para consumir no mercado e que elas serão úteis para ajudar vendedores a criarem estratégias de venda e tomarem decisões certas em tempo hábil. Você também poderá desenvolver um sistema para comparar preços e atributos entre diversos tipos de anúncios.

Acompanhe nossos guias para saber como aproveitar todos os recursos!

Consultas avançadas

Ajude seus anunciantes a ficarem sempre um passo à frente em seus negócios. Primeiramente, você deve saber que não poderá obter dados privados de usuários que não tiverem concedido permissões para seu aplicativo. No entanto, existem dados públicos que você poderá obter sobre tais usuários, como quem publica nas mesmas categorias que você, a quantidade de anúncios publicados, quais são os preços e atributos que eles praticam em seus anúncios, em quais categorias eles publicam e quantos contatos e visitas eles recebem por dia.

Comparar preços e atributos

Com seu sistema, você pode sugerir aos vendedores qual é o melhor preço para vender seus produtos, mantendo sua competitividade ao analisar o preço do mesmo tipo de produto publicado no Mercado Livre. Para isso, é conveniente aprender a buscar produtos por categoria, consultar o campo de preço desses produtos e calcular a média.

Você também pode desenvolver um sistema para analisar preços e atributos dos produtos classificados, para que compradores possam comparar, localizar e encontrar exatamente aquilo que estão buscando.



Próximo:

Buscar anúncios de um vendedor.
Tirar medidas de visitas e contatos.

Please rate this

Consulta de usuário avançado

Agora que você já sabe como trabalhar com usuários do Mercado Livre, está na hora de entrarmos nas características especiais deles:

Assuntos

Please rate this

Guia para veículos

As publicações de veículos são classificados nos quais os dados de contato dos vendedores são públicos, facilitando aos compradores a comunicação direta com eles. O pagamento e a entrega são coordenados entre as contrapartes sem que haja uma oferta.

Você pode criar aplicativos que publiquem veículos e façam comparativos de preços e características entre itens similares, realizem medidas dos contatos, salvem favoritos, enviem lembretes etc.

Acompanhe os guias que apresentamos a seguir para aprender a automatizar cada uma dessas tarefas.


Próximo:
Autorização.

Please rate this

Sincronização de publicações

Assim que você tiver publicações ativas em nosso Marketplace, é provável que você tenha de fazer atualizações e alterações periodicamente para sincronizar o estoque com outras plataformas com as quais você trabalha, pausar publicações, melhorar descrições, atualizar preços etc.
Leia o guia a seguir e saiba como fazer isso:

Assuntos

Considerações

Nem todos os campos podem ser atualizados, e isso irá variar se o produto já tiver vendas ou não. Além disso, lembre-se de que para poder alterar um produto, ele deve estar ativo. Você pode alterar valores para:

  • Title
  • Available_quantity
  • Price
  • Video
  • Pictures
  • Description
  • Shipping

Se o produto tiver vendas, nenhum dos seguintes campos poderá ser alterado:

  • Title
  • Condition
  • Buying mode
  • Non Mercado Pago Payment Methods
  • Shipping dimensions
  • Warranty

Você também deve lembrar que:

  • A categoria não pode ser alterada através da API.
  • O tipo de publicação só pode ser alterado uma vez.
  • O título não pode ser alterado em um produto que já tenha vendas, a menos que você faça parte das lojas oficiais do Mercado Livre.

Atualização de seu produto

Vejamos um exemplo básico de atualização do título e do preço de um produto. Você só precisará do item_id do produto publicado e do access_token do vendedor.
Exemplo:

curl -X PUT -H "Content-Type: application/json" -H "Accept: application/json" -d
{
  "title": "Your new title",
  "price": 1000
}
https://api.mercadolibre.com/items/ITEM_ID?access_token=YOUR_ACCESS_TOKEN

Pronto. O título e o preço de seu produto foram atualizados, e você deverá receber um status de resposta com código 200 OK para confirmar que não houve inconvenientes.
Lembre de que pode demorar um pouco até que as informações atualizadas fiquem visíveis.

Descrições

Atualizar uma descrição é muito simples, e você pode fazer isso independentemente do produto ter ou não alguma oferta. No entanto, como há algumas considerações que você deve lembrar ao adicionar ou substituir descrições, leia o artigo consulte o nosso artigo sobre descrições para ter certeza de que entendeu.

Imagens

Você sempre pode adicionar ou substituir imagens dos produtos. Leia consulte o nosso tutorial Trabalhar com imagens para saber qual a melhor maneira de fazer isso.

Tipos de publicação

Caso você queira dar mais exposição a seu produto, você deve atualizar o tipo de publicação. Conheça os detalhes e as considerações, e aprenda a fazer uma atualização em nosso tutorial Tipos de publicações e upgrades.

Mudança de status das publicações

Qualquer produto publicado em nosso Marketplace pode ter diferentes status; a seguir, analise a descrição de cada um deles:

  • encerrado: finaliza sua publicação. Uma vez encerrada, a publicação não poderá ser ativada novamente, mas pode ser publicada novamente.
  • pausado: pausa sua publicação. Uma vez pausado, o produto não poderá ser visualizado pelos outros usuários do Mercado Livre, mas não será encerrado e poderá ser reativado depois.
  • ativo: reativa um produto previamente pausado.

Se você precisar fazer alterações no status do produto, deverá enviar um desses valores para o campo “status”. Lembre de que o valor diferencia entre letras maiúsculas e minúsculas e deve ser enviado em letras minúsculas.

Para pausar um produto ativo, veja o exemplo a seguir:
Exemplo:

 curl -X PUT -H "Content-Type: application/json" -H "Accept: application/json" -d
{
  "status":"paused"
}
https://api.mercadolibre.com/items/ITEM_ID?access_token=YOUR_ACCESS_TOKEN

Excelente! Seu produto já foi pausado. Agora você já pode tentar reativá-lo fazendo exatamente a mesma chamada, mas enviando “ativo” em vez de “pausado” como valor de status.

Se seu produto está encerrado, e você quer publicá-lo novamente, consulte artigo sobre como publicar novamente para fazer isso rapidamente.
Para obter mais informações sobre o status do produto, consulte o artigo sobre ciclo de vida das publicações.

Exclusão de publicações

Depois de excluir uma publicação, não há como reverter. Por isso, tenha cuidado ao fazer isso. Além disso, lembre-se de que não é necessário excluir os produtos encerrados porque eles serão automaticamente descartados depois de algum tempo.
Mas se você ainda precisar excluir um produto, por exemplo, produtos em estado payment_required, os quais não responderão ao status “encerrado”, faça o seguinte:
Exemplo:

 curl -X PUT -H "Content-Type: application/json" -H "Accept: application/json" -d
{
"status": "closed"
}

{
"deleted":"true"
}
https://api.mercadolibre.com/items/ITEM_ID?access_token=YOUR_ACCESS_TOKEN

Pronto! Seu produto será excluído.


Próximo:
Gerenciamento de contatos.

Please rate this

Gerenciamento de pacotes

Os Pacotes Promocionais são pacotes para anúncios Classificados de Concessionárias de Carros e Imóveis. Para realizar testes de test, você deverá encaminhar o usuário para o canal de suporte para este ser ativado como car dealer ou real state.

Assuntos

Consultar pacotes por categoria

Os valores possíveis para as categorias classifieds_promotion_packs são diferentes em cada site. Os valores possíveis são:
{site_id}1743: Concessionária de automóveis.
{site_id}1459: Imobiliária.
Por exemplo, na Argentina, a categoria de pacotes para concessionárias de automóveis é MLA1743, enquanto no Brasil ela é MLB1743.

Faça uma solicitação GET para buscar pacotes em uma categoria específica:

 curl -X GET https://api.mercadolibre.com/categories/{category_id}/classifieds_promotion_packs

Resposta:

 [
  {
    "id": "IPAA",
    "category_id": "MLA1459",
    "brand": "MLREALESTATE",
    "description": "Paquete 15 Básico",
    "price": 350,
    "package_type": "rotary",
    "duration": 30,
    "status": "active",
    "charge_type_id": "CCAA",
    "max_upgrades": 0,
    "listing_details": [
      {
        "listing_type_id": "silver",
        "available_listings": 15
      }
    ]
  },
  {
    "id": "IPAR",
    "category_id": "MLA1459",
    "brand": "MLREALESTATE",
    "description": "Paquete 15 Premium",
    "price": 600,
    "package_type": "rotary",
    "duration": 30,
    "status": "active",
    "charge_type_id": "CCAR",
    "max_upgrades": 0,
    "listing_details": [
      {
        "listing_type_id": "gold",
        "available_listings": 6
      },
      {
        "listing_type_id": "gold_premium",
        "available_listings": 1
      },
      {
        "listing_type_id": "silver",
        "available_listings": 8
      }
    ]
  },
  {
    "id": "IPAS",
    "category_id": "MLA1459",
    "brand": "MLREALESTATE",
    "description": "Paquete 15 Especial",
    "price": 410,
    "package_type": "rotary",
    "duration": 30,
    "status": "active",
    "charge_type_id": "CCAS",
    "max_upgrades": 0,
    "listing_details": [
      {
        "listing_type_id": "silver",
        "available_listings": 10
      },
      {
        "listing_type_id": "gold",
        "available_listings": 5
      }
    ]
  },
  {
    "id": "IPBA",
    "category_id": "MLA1459",
    "brand": "MLREALESTATE",
    "description": "Paquete 30 Básico",
    "price": 480,
    "package_type": "rotary",
    "duration": 30,
    "status": "active",
    "charge_type_id": "CCBA",
    "max_upgrades": 0,
    "listing_details": [
      {
        "listing_type_id": "silver",
        "available_listings": 30
      }
    ]
  },
  {
    "id": "IPBR",
    "category_id": "MLA1459",
    "brand": "MLREALESTATE",
    "description": "Paquete 30 Premium",
    "price": 880,
    "package_type": "rotary",
    "duration": 30,
    "status": "active",
    "charge_type_id": "CCBR",
    "max_upgrades": 0,
    "listing_details": [
      {
        "listing_type_id": "silver",
        "available_listings": 16
      },
      {
        "listing_type_id": "gold_premium",
        "available_listings": 2
      },
      {
        "listing_type_id": "gold",
        "available_listings": 12
      }
    ]
  },
  {
    "id": "IPBS",
    "category_id": "MLA1459",
    "brand": "MLREALESTATE",
    "description": "Paquete 30 Especial",
    "price": 560,
    "package_type": "rotary",
    "duration": 30,
    "status": "active",
    "charge_type_id": "CCBS",
    "max_upgrades": 0,
    "listing_details": [
      {
        "listing_type_id": "silver",
        "available_listings": 20
      },
      {
        "listing_type_id": "gold",
        "available_listings": 10
      }
    ]
  },
  {
    "id": "IPCA",
    "category_id": "MLA1459",
    "brand": "MLREALESTATE",
    "description": "Paquete 60 Básico",
    "price": 570,
    "package_type": "rotary",
    "duration": 30,
    "status": "active",
    "charge_type_id": "CCCA",
    "max_upgrades": 0,
    "listing_details": [
      {
        "listing_type_id": "silver",
        "available_listings": 60
      }
    ]
  },
  {
    "id": "IPCR",
    "category_id": "MLA1459",
    "brand": "MLREALESTATE",
    "description": "Paquete 60 Premium",
    "price": 910,
    "package_type": "rotary",
    "duration": 30,
    "status": "active",
    "charge_type_id": "CCCR",
    "max_upgrades": 0,
    "listing_details": [
      {
        "listing_type_id": "silver",
        "available_listings": 32
      },
      {
        "listing_type_id": "gold",
        "available_listings": 24
      },
      {
        "listing_type_id": "gold_premium",
        "available_listings": 4
      }
    ]
  },
  {
    "id": "IPCS",
    "category_id": "MLA1459",
    "brand": "MLREALESTATE",
    "description": "Paquete 60 Especial",
    "price": 650,
    "package_type": "rotary",
    "duration": 30,
    "status": "active",
    "charge_type_id": "CCCS",
    "max_upgrades": 0,
    "listing_details": [
      {
        "listing_type_id": "gold",
        "available_listings": 20
      },
      {
        "listing_type_id": "silver",
        "available_listings": 40
      }
    ]
  },
  {
    "id": "IPDA",
    "category_id": "MLA1459",
    "brand": "MLREALESTATE",
    "description": "Paquete 100 Básico",
    "price": 750,
    "package_type": "rotary",
    "duration": 30,
    "status": "active",
    "charge_type_id": "CCDA",
    "max_upgrades": 0,
    "listing_details": [
      {
        "listing_type_id": "silver",
        "available_listings": 100
      }
    ]
  },
  {
    "id": "IPDR",
    "category_id": "MLA1459",
    "brand": "MLREALESTATE",
    "description": "Paquete 100 Premium",
    "price": 1180,
    "package_type": "rotary",
    "duration": 30,
    "status": "active",
    "charge_type_id": "CCDR",
    "max_upgrades": 0,
    "listing_details": [
      {
        "listing_type_id": "gold_premium",
        "available_listings": 5
      },
      {
        "listing_type_id": "gold",
        "available_listings": 35
      },
      {
        "listing_type_id": "silver",
        "available_listings": 60
      }
    ]
  },
  {
    "id": "IPDS",
    "category_id": "MLA1459",
    "brand": "MLREALESTATE",
    "description": "Paquete 100 Especial",
    "price": 820,
    "package_type": "rotary",
    "duration": 30,
    "status": "active",
    "charge_type_id": "CCDS",
    "max_upgrades": 0,
    "listing_details": [
      {
        "listing_type_id": "gold",
        "available_listings": 25
      },
      {
        "listing_type_id": "silver",
        "available_listings": 75
      }
    ]
  },
  {
    "id": "IPEA",
    "category_id": "MLA1459",
    "brand": "MLREALESTATE",
    "description": "Paquete 500 Básico",
    "price": 850,
    "package_type": "rotary",
    "duration": 30,
    "status": "active",
    "charge_type_id": "CCEA",
    "max_upgrades": 0,
    "listing_details": [
      {
        "listing_type_id": "silver",
        "available_listings": 500
      }
    ]
  },
  {
    "id": "IPER",
    "category_id": "MLA1459",
    "brand": "MLREALESTATE",
    "description": "Paquete 500 Premium",
    "price": 1900,
    "package_type": "rotary",
    "duration": 30,
    "status": "active",
    "charge_type_id": "CCER",
    "max_upgrades": 0,
    "listing_details": [
      {
        "listing_type_id": "gold",
        "available_listings": 100
      },
      {
        "listing_type_id": "gold_premium",
        "available_listings": 15
      },
      {
        "listing_type_id": "silver",
        "available_listings": 385
      }
    ]
  },
  {
    "id": "IPES",
    "category_id": "MLA1459",
    "brand": "MLREALESTATE",
    "description": "Paquete 500 Especial",
    "price": 1000,
    "package_type": "rotary",
    "duration": 30,
    "status": "active",
    "charge_type_id": "CCES",
    "max_upgrades": 0,
    "listing_details": [
      {
        "listing_type_id": "gold",
        "available_listings": 70
      },
      {
        "listing_type_id": "silver",
        "available_listings": 430
      }
    ]
  }
]

Obter pacotes de anúncios contratados por um usuário

 curl -X GET https://api.mercadolibre.com/users/{user_id}/classifieds_promotion_packs?access_token=$ACCESS_TOKEN;

Resposta:

 [
    {
        "id": 754985,
        "user_id": "135146148",
        "promotion_pack_id": "MPAB",
        "category_id": "MLU1743",
        "description": "Paquete 15 Básico",
        "package_type": "rotary",
        "status": "active",
        "date_created": "2013-05-23T15:34:48.498-04:00",
        "date_start": "2013-05-23T15:34:47.544-04:00",
        "date_expires": "2013-06-22T15:34:47.544-04:00",
        "date_stopped": null,
        "last_updated": "2013-05-23T15:35:48.211-04:00",
        "engagement_type": "none",
        "charge_id": 822129921,
        "remaining_listings": 15,
        "used_listings": 0,
        "listing_details": [
            {
                "listing_type_id": "silver",
                "available_listings": 15,
                "used_listings": 0,
                "remaining_listings": 15
            }
        ]
    }
]

Obter pacotes em destaque contratados por um usuário

curl -X GET 
https://api.mercadolibre.com/users/{user_id}/classifieds_promotion_packs?package_content=upgrades&status=active&access_token=$ACCESS_TOKEN;

Resposta:

[
    {
        "id": 1584151,
        "user_id": "XXXXXX",
        "promotion_pack_id": "IPUPGGP5INT",
        "category_id": "MLA1459",
        "brand": "MLREALESTATE",
        "description": "5 Destaques Oro Premium Interior",
        "package_type": "rotary",
        "status": "active",
        "date_created": "2017-08-31T09:08:29.124-04:00",
        "date_start": "2017-08-31T09:08:29.113-04:00",
        "date_expires": "2017-09-30T09:08:29.113-04:00",
        "date_stopped": null,
        "last_updated": "2017-08-31T09:25:57.860-04:00",
        "engagement_type": "none",
        "package_content": "upgrades",
        "charge_id": 3152387845,
        "bonus_id": null,
        "remaining_listings": 0,
        "used_listings": 5,
        "quota_type": "reusable",
        "next_promotion_pack_id": null,
        "parent_promotion_pack_id": null,
        "listing_details": [
            {
                "listing_type_id": "gold_premium",
                "available_listings": 5,
                "used_listings": 5,
                "remaining_listings": 0
            }
        ]
    },
    {
        "id": 1584150,
        "user_id": "XXXXXX",
        "promotion_pack_id": "IPUPGG5INT",
        "category_id": "MLA1459",
        "brand": "MLREALESTATE",
        "description": "5 Destaques Oro Interior",
        "package_type": "rotary",
        "status": "active",
        "date_created": "2017-08-31T09:08:28.752-04:00",
        "date_start": "2017-08-31T09:08:28.742-04:00",
        "date_expires": "2017-09-30T09:08:28.742-04:00",
        "date_stopped": null,
        "last_updated": "2017-08-31T09:25:57.747-04:00",
        "engagement_type": "none",
        "package_content": "upgrades",
        "charge_id": 3152387844,
        "bonus_id": null,
        "remaining_listings": 0,
        "used_listings": 5,
        "quota_type": "reusable",
        "next_promotion_pack_id": null,
        "parent_promotion_pack_id": null,
        "listing_details": [
            {
                "listing_type_id": "gold",
                "available_listings": 5,
                "used_listings": 5,
                "remaining_listings": 0
            }
        ]
    }
]

Descrição de recursos

Atributo Descrição
id Identificador exclusivo do pacote.
user_id ID exclusivo do usuário contratante do pacote.
category_id Categoria do pacote.
descrição Nome do pacote
package_type: Detalhes do pacote.
status Os valores possíveis de status do pacote são:
active: o usuário pode usar esse pacote para publicar. Quando ele fizer a publicação, uma available_listing será descontada.
pending: o pacote ainda não está ativo.
finished: pacote expirado.
date_created Data de criação do pacote.
date_start Data de ativação do pacote
date_expires Data de expiração do pacote
date_stopped Data de finalização do pacote.
last_updated Última atualização do pacote.
engagement_type Os valores possíveis são:
“nenhum”: o pacote foi contratado apenas por uma vez.
“recontratação”: quando o pacote expirar, um package_type similar será automaticamente recontratado.
charge_id ID exclusivo da cobrança gerada durante a contratação do pacote.
listing_details Informações detalhadas sobre tipos de publicações e disponibilidade.
listing_type_id listing_type associado ao pacote.
available_listings Quantidade de publicações obtidas pelo usuário com o pacote.
used_listings Publicações já enviadas.
remaining_listings Publicações restantes disponíveis.

Conferir se um usuário tem um listing_type específico disponível

 curl -X GET https://api.mercadolibre.com/users/{user_id}/classifieds_promotion_packs/silver?access_token=$ACCESS_TOKEN

Upgrade do produto

POST https://api.mercadolibre.com/items/{item_id}/listing_type?access_token=$ACCESS_TOKEN

Corpo:

{ “id”:”{listing_type}” }

A resposta é o produto atualizado.
Exemplo:

 curl -X POST --header "Content-type:application/json" -d '{"id":"gold"}' 'https://api.mercadolibre.com/items/MLA563940625/listing_type?access_token=$ACCESS_TOKEN'
{
    "id": "MLA563940625",
    "site_id": "MLA",
    "title": "Test 10 No Ofertar",
    "subtitle": null,
    "seller_id": 184854440,
    "category_id": "MLA50543",
    "official_store_id": null,
    "price": 2928282,
    "base_price": 2928282,
    "original_price": null,
    "currency_id": "ARS",
    "initial_quantity": 1,
    "available_quantity": 1,
    "sold_quantity": 0,
    "buying_mode": "classified",
    "listing_type_id": "gold",
    "start_time": "2015-06-09T20:25:50.000Z",
    "stop_time": "2015-07-05T19:51:17.587Z",
    "end_time": "2015-07-05T19:51:17.587Z",
    "condition": "not_specified",
    "permalink": "http://inmueble.mercadolibre.com.ar/MLA-563940625-test-10-no-ofertar-_JM",
    "thumbnail": "http://mla-s1-p.mlstatic.com/302401-MLA20317818801_062015-I.jpg",
    "secure_thumbnail": "https://mla-s1-p.mlstatic.com/302401-MLA20317818801_062015-I.jpg",
    "pictures": [
        {
            "id": "302401-MLA20317818801_062015",
            "url": "http://mla-s1-p.mlstatic.com/302401-MLA20317818801_062015-O.jpg",
            "secure_url": "https://mla-s1-p.mlstatic.com/302401-MLA20317818801_062015-O.jpg",
            "size": "500x281",
            "max_size": "1200x675",
            "quality": ""
        }
    ],
    "video_id": null,
    "descriptions": [],
    "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": 163310864,
        "comment": "",
        "address_line": "Test Address 123",
        "zip_code": "1414",
        "city": {
            "id": "",
            "name": "Palermo"
        },
        "state": {
            "id": "AR-C",
            "name": "Capital Federal"
        },
        "country": {
            "id": "AR",
            "name": "Argentina"
        },
        "latitude": "",
        "longitude": "",
        "search_location": {
            "neighborhood": {
                "id": "TUxBQlBBTDI1MTVa",
                "name": "Palermo"
            },
            "city": {
                "id": "TUxBQ0NBUGZlZG1sYQ",
                "name": "Capital Federal"
            },
            "state": {
                "id": "TUxBUENBUGw3M2E1",
                "name": "Capital Federal"
            }
        }
    },
    "seller_contact": {
        "contact": "",
        "other_info": "",
        "area_code": "",
        "phone": "",
        "area_code2": "",
        "phone2": "",
        "email": "",
        "webpage": ""
    },
    "location": {
        "address_line": "falsa 123 123",
        "zip_code": "",
        "neighborhood": {
            "id": "TUxBQkVTUDYyODRa",
            "name": "Espartillar"
        },
        "city": {
            "id": "TUxBQ0FETzQ2Nzc",
            "name": "Adolfo Alsina"
        },
        "state": {
            "id": "TUxBUFpPTmFpbnRl",
            "name": "Buenos Aires Interior"
        },
        "country": {
            "id": "AR",
            "name": "Argentina"
        },
        "latitude": -34.6635266,
        "longitude": -58.3654707,
        "open_hours": ""
    },
    "geolocation": {
        "latitude": -34.6635266,
        "longitude": -58.3654707
    },
    "coverage_areas": [],
    "attributes": [
        {
            "id": "MLA1459-HORPREF",
            "name": "Horario de contacto",
            "value_id": "",
            "value_name": "",
            "attribute_group_id": "ADICIONALES",
            "attribute_group_name": "Adicionales"
        },
        {
            "id": "MLA50541-ACCESO",
            "name": "Acceso",
            "value_id": "",
            "value_name": "",
            "attribute_group_id": "ADICIONALES",
            "attribute_group_name": "Adicionales"
        },
        {
            "id": "MLA50541-ANTIG",
            "name": "Antigüedad",
            "value_id": "",
            "value_name": "",
            "attribute_group_id": "ADICIONALES",
            "attribute_group_name": "Adicionales"
        },
        {
            "id": "MLA50541-EXPENCEM",
            "name": "Expensas ($)",
            "value_id": "",
            "value_name": "",
            "attribute_group_id": "ADICIONALES",
            "attribute_group_name": "Adicionales"
        },
        {
            "id": "MLA50541-SEGUR",
            "name": "Seguridad",
            "value_id": "",
            "value_name": "",
            "attribute_group_id": "ADICIONALES",
            "attribute_group_name": "Adicionales"
        },
        {
            "id": "MLA1459-INMUEBLE",
            "name": "Inmueble",
            "value_id": "MLA1459-INMUEBLE-COCHERA",
            "value_name": "Cochera",
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
        },
        {
            "id": "MLA1459-OPERACION",
            "name": "Operación",
            "value_id": "MLA1459-OPERACION-VENTA",
            "value_name": "Venta",
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
        },
        {
            "id": "MLA50541-MTRSTOTAL",
            "name": "Superficie total (m²)",
            "value_id": "",
            "value_name": "24",
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
        },
        {
            "id": "MLA50541-TIPCOB",
            "name": "Tipo de cobertura",
            "value_id": "MLA50541-TIPCOB-CUBIERTA",
            "value_name": "Cubierta",
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
        },
        {
            "id": "MLA50541-TIPOCOCH",
            "name": "Tipo de cochera",
            "value_id": "MLA50541-TIPOCOCH-FIJA",
            "value_name": "Fija",
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
        }
    ],
    "listing_source": "",
    "variations": [],
    "status": "active",
    "sub_status": [],
    "tags": [],
    "warranty": null,
    "catalog_product_id": null,
    "seller_custom_field": null,
    "parent_item_id": null,
    "differential_pricing": null,
    "deal_ids": [],
    "automatic_relist": false,
    "date_created": "2015-06-09T20:25:50.000Z",
    "last_updated": "2015-06-10T12:20:32.418Z"
}



Próximo:
Especificações de Ítem.

Please rate this

Consulta de usuários

Caso você já tenha conseguido registrar seu aplicativo, tenha feito a autenticação e gerado um usuário de teste, você deverá aprender a trabalhar com usuários (vendedores e compradores):

O tutorial abaixo o ensinará a realizar as seguintes ações:

Quero me cadastrar como concessionária (Opcional)

Para realizar o cadastramento como concessionária em nosso site, você deverá acessar a seção de serviços do nosso MarketPlace para o país onde deseja publicar e digitar um pedido acessando o link ressaltado na figura a seguir:

auto
Depois, você será redirecionado para um formulário que deverá ser preenchido com as informações certas e também poderá escolher o pacote promocional que quiser. Depois de preenchido o formulário, um de nossos agentes entrará em contato com você.

Consultar meus dados pessoais

Se você já tiver feito login no Mercado Livre e tiver um token, poderá fazer a seguinte chamada para saber quais são as informações relacionadas a seu usuário:

Exemplo:

 curl  - X GET https://api.mercadolibre.com/users/me?access_token=$ACCESS_TOKEN

Resposta:

 {
  "id": 202593498,
  "nickname": "TETE2870021",
  "registration_date": "2016-01-06T11:31:42.000-04:00",
  "first_name": "Test",
  "last_name": "Test",
  "country_id": "AR",
  "email": "test_user_50698062@testuser.com",
  "identification": {
    "type": "DNI",
    "number": "1111111"
  },
  "address": {
    "state": "AR-C",
    "city": "Palermo",
    "address": "Test Address 123",
    "zip_code": "1414"
  },
  "phone": {
    "area_code": "01",
    "number": "1111-1111",
    "extension": "",
    "verified": false
  },
  "alternative_phone": {
    "area_code": "",
    "number": "",
    "extension": ""
  },
  "user_type": "real_estate_agency",
  "tags": [
    "real_estate_agency",
    "test_user",
    "user_info_verified"
  ],
  "logo": null,
  "points": 100,
  "site_id": "MLA",
  "permalink": "http://perfil.mercadolibre.com.ar/TETE2870021",
  "shipping_modes": [
    "custom",
    "not_specified"
  ],
  "seller_experience": "ADVANCED",
  "seller_reputation": {
    "level_id": null,
    "power_seller_status": null,
    "transactions": {
      "period": "historic",
      "total": 0,
      "completed": 0,
      "canceled": 0,
      "ratings": {
        "positive": 0,
        "negative": 0,
        "neutral": 0
      }
    }
  },
  "buyer_reputation": {
    "canceled_transactions": 0,
    "transactions": {
      "period": "historic",
      "total": null,
      "completed": null,
      "canceled": {
        "total": null,
        "paid": null
      },
      "unrated": {
        "total": null,
        "paid": null
      },
      "not_yet_rated": {
        "total": null,
        "paid": null,
        "units": null
      }
    },
    "tags": [
    ]
  },
  "status": {
    "site_status": "active",
    "list": {
      "allow": true,
      "codes": [
      ],
      "immediate_payment": {
        "required": false,
        "reasons": [
        ]
      }
    },
    "buy": {
      "allow": true,
      "codes": [
      ],
      "immediate_payment": {
        "required": false,
        "reasons": [
        ]
      }
    },
    "sell": {
      "allow": true,
      "codes": [
      ],
      "immediate_payment": {
        "required": false,
        "reasons": [
        ]
      }
    },
    "billing": {
      "allow": true,
      "codes": [
      ]
    },
    "Mercado Pago_tc_accepted": true,
    "Mercado Pago_account_type": "personal",
    "Mercado Envios": "not_accepted",
    "immediate_payment": false,
    "confirmed_email": false,
    "user_type": "eventual",
    "required_action": ""
  },
  "credit": {
    "consumed": 100,
    "credit_level_id": "MLA1"
  }
}

Consultar dados de terceiros

Se você quiser consultar dados de usuários, terceiros poderá identificar dois níveis de informações: dados públicos, aqueles que podem ser encontrados navegando pelo perfil no Mercado Livre de qualquer outro usuário, Ex.: http://perfil.mercadolibre.com.ar/TETE2870021 e dados privados, que não poderão ser visualizados, a menos que você tenha permissões de usuário e um token válido para trabalhar em nome dele.
Em ambos os casos, a primeira coisa que você deverá conhecer é o id do usuário.

Obter o Id de usuário

Se você não sabe o id, mas sabe o apelido e o site ao qual um usuário pertence, você poderá obtê-lo fazendo a seguinte busca:

Chamada:

 https://api.mercadolibre.com/sites/{Site_id}/search?nickname={Nickname}

Exemplo:

 https://api.mercadolibre.com/sites/MLA/search?nickname=TETE2870021

Resposta:

 {
  "site_id": "MLA",
  "seller": {
    "id": 202593498,
    "seller_reputation": {
      "power_seller_status": null
    },
    "real_estate_agency": false,
    "car_dealer": false,
    "tags": [
    ]
  },
  "paging": {
    "total": 2,
    "offset": 0,
    "limit": 50
  },
  "results": [
    {
      "id": "MLA598903377",
      "site_id": "MLA",
      "title": "Test Item - Nao Ofertar",
      "subtitle": null,
      "seller": {
        "id": 202593498,
        "power_seller_status": null,
        "car_dealer": false,
        "real_estate_agency": false,
        "tags": [
        ]
      },
      "price": 200,
      "currency_id": "ARS",
      "available_quantity": 1,
      "sold_quantity": 0,
      "buying_mode": "buy_it_now",
      "listing_type_id": "bronze",
      "stop_time": "2016-03-06T17:16:49.000Z",
      "condition": "new",
      "permalink": "http://articulo.mercadolibre.com.ar/MLA-598903377-test-item-nao-ofertar-_JM",
      "thumbnail": "http://mla-s2-p.mlstatic.com/546311-MLA20539702714_012016-I.jpg",
      "accepts_Mercado Pago": true,
      "installments": {
        "quantity": 6,
        "amount": 42.33,
        "currency_id": "ARS"
      },
      "address": {
        "state_id": "AR-C",
        "state_name": "Capital Federal",
        "city_id": "",
        "city_name": "Palermo"
      },
      "shipping": {
        "free_shipping": false,
        "mode": "not_specified"
      },
      "seller_address": {
        "id": 175597910,
        "comment": "",
        "address_line": "",
        "zip_code": "",
        "country": {
          "id": "AR",
          "name": "Argentina"
        },
        "state": {
          "id": "AR-C",
          "name": "Capital Federal"
        },
        "city": {
          "id": "",
          "name": "Palermo"
        },
        "latitude": -34.571148,
        "longitude": -58.423298
      },
      "attributes": [
      ],
      "original_price": null,
      "category_id": "MLA374515",
      "official_store_id": null
    },
    {
      "id": "MLA599121050",
      "site_id": "MLA",
      "title": "Item De Test - No Ofertar",
      "subtitle": null,
      "seller": {
        "id": 202593498,
        "power_seller_status": null,
        "car_dealer": false,
        "real_estate_agency": false,
        "tags": [
        ]
      },
      "price": 1000,
      "currency_id": "ARS",
      "available_quantity": 1,
      "sold_quantity": 0,
      "buying_mode": "buy_it_now",
      "listing_type_id": "bronze",
      "stop_time": "2016-03-07T20:12:41.000Z",
      "condition": "new",
      "permalink": "http://articulo.mercadolibre.com.ar/MLA-599121050-item-de-test-no-ofertar-_JM",
      "thumbnail": "http://mla-s2-p.mlstatic.com/493311-MLA20538550251_012016-I.jpg",
      "accepts_Mercado Pago": true,
      "installments": {
        "quantity": 6,
        "amount": 211.65,
        "currency_id": "ARS"
      },
      "address": {
        "state_id": "AR-C",
        "state_name": "Capital Federal",
        "city_id": "",
        "city_name": "Palermo"
      },
      "shipping": {
        "free_shipping": false,
        "mode": "not_specified"
      },
      "seller_address": {
        "id": 175597910,
        "comment": "",
        "address_line": "",
        "zip_code": "",
        "country": {
          "id": "AR",
          "name": "Argentina"
        },
        "state": {
          "id": "AR-C",
          "name": "Capital Federal"
        },
        "city": {
          "id": "",
          "name": "Palermo"
        },
        "latitude": -34.571148,
        "longitude": -58.423298
      },
      "attributes": [
      ],
      "original_price": null,
      "category_id": "MLA90105",
      "official_store_id": null
    }
  ],
  "secondary_results": [
  ],
  "related_results": [
  ],
  "sort": {
    "id": "relevance",
    "name": "More relevant"
  },
  "available_sorts": [
    {
      "id": "price_asc",
      "name": "Lower price"
    },
    {
      "id": "price_desc",
      "name": "Higher price"
    }
  ],
  "filters": [
  ],
  "available_filters": [
    {
      "id": "category",
      "name": "Categories",
      "type": "text",
      "values": [
        {
          "id": "MLA1648",
          "name": "Computación",
          "results": 1
        },
        {
          "id": "MLA1430",
          "name": "Ropa y Accesorios",
          "results": 1
        }
      ]
    },
    {
      "id": "state",
      "name": "Location",
      "type": "text",
      "values": [
        {
          "id": "TUxBUENBUGw3M2E1",
          "name": "Capital Federal",
          "results": 2
        }
      ]
    },
    {
      "id": "accepts_Mercado Pago",
      "name": "Mercado Pago filter",
      "type": "boolean",
      "values": [
        {
          "id": "yes",
          "name": "With Mercado Pago",
          "results": 2
        }
      ]
    },
    {
      "id": "installments",
      "name": "Pago",
      "type": "text",
      "values": [
        {
          "id": "yes",
          "name": "Installments",
          "results": 2
        },
        {
          "id": "no_interest",
          "name": "Sin interés",
          "results": 0
        }
      ]
    },
    {
      "id": "condition",
      "name": "Condition filter",
      "type": "text",
      "values": [
        {
          "id": "new",
          "name": "New",
          "results": 2
        }
      ]
    },
    {
      "id": "buying_mode",
      "name": "Buying mode filter",
      "type": "text",
      "values": [
        {
          "id": "buy_it_now",
          "name": "Buy it now",
          "results": 2
        }
      ]
    },
    {
      "id": "has_pictures",
      "name": "Items with images filter",
      "type": "boolean",
      "values": [
        {
          "id": "yes",
          "name": "With pictures",
          "results": 2
        }
      ]
    }
  ]
}

Consultar informações públicas

Desse modo, você já conhece o Id do usuário, portanto pode realizar a chamada ao recurso users da seguinte maneira, obtendo as informações públicas do usuário que quiser:

Chamada:

 curl GET -X  https://api.mercadolibre.com/users/{User_id}

Exemplo:

 GET -X  https://api.mercadolibre.com/users/202593498

Resposta:

 {
  "id": 202593498,
  "nickname": "TETE2870021",
  "registration_date": "2016-01-06T11:31:42.000-04:00",
  "country_id": "AR",
  "address": {
    "state": "AR-C",
    "city": "Palermo"
  },
  "user_type": "normal",
  "tags": [
    "normal",
    "test_user",
    "user_info_verified"
  ],
  "logo": null,
  "points": 100,
  "site_id": "MLA",
  "permalink": "http://perfil.mercadolibre.com.ar/TETE2870021",
  "seller_reputation": {
    "level_id": null,
    "power_seller_status": null,
    "transactions": {
      "period": "historic",
      "total": 0,
      "completed": 0,
      "canceled": 0,
      "ratings": {
        "positive": 0,
        "negative": 0,
        "neutral": 0
      }
    }
  },
  "buyer_reputation": {
    "tags": [
    ]
  },
  "status": {
    "site_status": "active"
  }
}

Consultar informações privadas de um usuário que aceitou o uso de meu aplicativo

Para obter os dados privados de um usuário, você apenas deve adicionar o ACCESS_TOKEN do usuário ao final da chamada que fez anteriormente.

Chamada:

 curl GET -X  https://api.mercadolibre.com/users/{User_id}?access_token=¢ACCESS_TOKEN

Exemplo:

 curl GET -X  https://api.mercadolibre.com/users/202593498?access_token=¢ACCESS_TOKEN

Resposta:

 {
  "id": 202593498,
  "nickname": "TETE2870021",
  "registration_date": "2016-01-06T11:31:42.000-04:00",
  "first_name": "Test",
  "last_name": "Test",
  "country_id": "AR",
  "email": "test_user_50698062@testuser.com",
  "identification": {
    "type": "DNI",
    "number": "1111111"
  },
  "address": {
    "state": "AR-C",
    "city": "Palermo",
    "address": "Test Address 123",
    "zip_code": "1414"
  },
  "phone": {
    "area_code": "01",
    "number": "1111-1111",
    "extension": "",
    "verified": false
  },
  "alternative_phone": {
    "area_code": "",
    "number": "",
    "extension": ""
  },
  "user_type": "normal",
  "tags": [
    "normal",
    "test_user",
    "user_info_verified"
  ],
  "logo": null,
  "points": 100,
  "site_id": "MLA",
  "permalink": "http://perfil.mercadolibre.com.ar/TETE2870021",
  "shipping_modes": [
    "custom",
    "not_specified"
  ],
  "seller_experience": "ADVANCED",
  "seller_reputation": {
    "level_id": null,
    "power_seller_status": null,
    "transactions": {
      "period": "historic",
      "total": 0,
      "completed": 0,
      "canceled": 0,
      "ratings": {
        "positive": 0,
        "negative": 0,
        "neutral": 0
      }
    }
  },
  "buyer_reputation": {
    "canceled_transactions": 0,
    "transactions": {
      "period": "historic",
      "total": null,
      "completed": null,
      "canceled": {
        "total": null,
        "paid": null
      },
      "unrated": {
        "total": null,
        "paid": null
      },
      "not_yet_rated": {
        "total": null,
        "paid": null,
        "units": null
      }
    },
    "tags": [
    ]
  },
  "status": {
    "site_status": "active",
    "list": {
      "allow": true,
      "codes": [
      ],
      "immediate_payment": {
        "required": false,
        "reasons": [
        ]
      }
    },
    "buy": {
      "allow": true,
      "codes": [
      ],
      "immediate_payment": {
        "required": false,
        "reasons": [
        ]
      }
    },
    "sell": {
      "allow": true,
      "codes": [
      ],
      "immediate_payment": {
        "required": false,
        "reasons": [
        ]
      }
    },
    "billing": {
      "allow": true,
      "codes": [
      ]
    },
    "Mercado Pago_tc_accepted": true,
    "Mercado Pago_account_type": "personal",
    "Mercado Envios": "not_accepted",
    "immediate_payment": false,
    "confirmed_email": false,
    "user_type": "eventual",
    "required_action": ""
  },
  "credit": {
    "consumed": 100,
    "credit_level_id": "MLA1"
  }
}

Como pode ver, dessa vez você obteve uma quantidade maior de dados do usuário: nome e sobrenome, e-mail, telefone, endereço etc. Solicitamos que não revele esses dados publicamente, pois isso pode prejudicar o usuário.

Atualizar dados de usuário

Você pode utilizar nossos recursos para atualizar suas informações de usuário depois do cadastramento. Isso é feito normalmente, porque nessa instância ninguém solicitará que você preencha seu endereço ou identificação pessoal, mas você deverá mantê-los completos, ou não poderá publicar produtos no Mercado Livre.
Para atualizar suas informações de usuário, veja o exemplo abaixo:

 curl -X PUT -H "Content-Type: application/json" -d
{
"identification_type": "DNI",
"identification_number": "33333333",
"address": "Triunvirato 5555",
"state":"AR-C",
"city":"Capital Federal",
"zip_dode": "1431",
"phone":{
        "area_code":"011",
        "number":"4444-4444",
        "extension":"001"
        },
"first_name":"Pedro",
"last_name": "Picapiedras",
"company":{
          "corporate_name":"Acme",
          "brand_name":"Acme Company"
          },
"Mercado Envios": "accepted"
}

https://api.mercadolibre.com/users/{User_id}?access_token= 

Parabéns! Você atualizou suas informações de usuário! Lembre-se de enviar somente os campos que quiser atualizar.

Usuario Vendedor S = P (sell equal pay)

Se você deseja que todas suas operações sejam exclusivamente a través de Mercado Pago deverão indicar na informação de seu usuário que só aceita a modalidade S = P (sell equal pay). Deste jeito ficará desabilitado a opção “Acordar com o vendedor”.

PUT:

 curl -XPUT -H "Content-type: application/json" -d 

'{
    "reason": "by_user"
}'

https://api.mercadolibre.com/users/{user_id}/immediate_payment?access_token=$ACCESS_TOKEN

Se quiser deixar de aceitar como única opção Mercado Pago, pode apagar a marca do seguinte jeito:

 curl -XDELETE https://api.mercadolibre.com/users/{user_id}/immediate_payment/by_user?access_token=$ACCESS_TOKEN

Códigos de erro comuns

206 – Partial content: muitas vezes, o recurso Users API retorna um código 206 – Partial content. Isso ocorrerá quando a solicitação de alguns dos dados falhar (por exemplo, reputação do usuário) informando que você receberá uma resposta incompleta.


Artigos relacionados :
Endereços do usuário.


Próximo:
Gerenciamento de pacotes.

Please rate this

Autenticação e Autorização

A plataforma do Mercado Livre permite trabalhar com recursos públicos e privados da API através de chamadas HTTP com os verbos GET, PUT, POST, DELETE e OPTIONS.
O acesso a recursos públicos, como sites e categories disponíveis, pode ser feito de forma anônima, mas os recursos privados e as ações próprias dos usuários, como anunciar um item, responder perguntas ou ver informações de vendas/compras, precisam de autorização mediante um aplicativo.
Por isso, no seguinte guia explicaremos o significado de autenticação e o fluxo de autorização que deve ser aplicado para ter um access_token (senha de acesso a recursos privados por cada usuário que o aplicativo autorizar -válida por 6 horas).
Por exemplo:
Sem access_token (Recurso público)

https://api.mercadolibre.com/users/226384143/

{
  "id": 226384143,
  "nickname": "TETE9928972",
  "registration_date": "2016-08-25T11:36:00.000-04:00",
  "country_id": "AR",
  "address": {
    "state": "AR-C",
    "city": "Palermo"
  },
  "user_type": "normal",
  "tags": [
    "normal",
    "test_user",
    "user_info_verified"
  ],
  "logo": null,
  "points": 100,
  "site_id": "MLA",
  "permalink": "http://perfil.mercadolibre.com.ar/TETE9928972",
  "seller_reputation": {
    "level_id": null,
    "power_seller_status": null,
    "transactions": {
      "period": "historic",
      "total": 1,
      "completed": 1,
      "canceled": 0,
      "ratings": {
        "positive": 0,
        "negative": 0,
        "neutral": 1
      }
    }
  },
  "buyer_reputation": {
    "tags": [
    ]
  },
  "status": {
    "site_status": "active"
  }
}


Com access_token (Recurso privado)

 
 https://api.mercadolibre.com/users/226384143?access_token=$ACCESS_TOKEN

{
  "id": 226384143,
  "nickname": "TETE9928972",
  "registration_date": "2016-08-25T11:36:00.000-04:00",
  "first_name": "Test",
  "last_name": "Test",
  "country_id": "AR",
  "email": "test_user_38730994@testuser.com",
  "identification": {
    "type": "DNI",
    "number": "1111111"
  },
  "address": {
    "state": "AR-C",
    "city": "Palermo",
    "address": "Test Address 123",
    "zip_code": "1414"
  },
  "phone": {
    "area_code": "01",
    "number": "1111-1111",
    "extension": "",
    "verified": false
  },
  "alternative_phone": {
    "area_code": "",
    "number": "",
    "extension": ""
  },
  "user_type": "normal",
  "tags": [
    "normal",
    "test_user",
    "user_info_verified"
  ],
  "logo": null,
  "points": 100,
  "site_id": "MLA",
  "permalink": "http://perfil.mercadolibre.com.ar/TETE9928972",
  "shipping_modes": [
    "custom",
    "not_specified"
  ],
  "seller_experience": "ADVANCED",
  "bill_data": {
    "accept_credit_note": null
  },
  "seller_reputation": {
    "level_id": null,
    "power_seller_status": null,
    "transactions": {
      "period": "historic",
      "total": 1,
      "completed": 1,
      "canceled": 0,
      "ratings": {
        "positive": 0,
        "negative": 0,
        "neutral": 1
      }
    }
  },
  "buyer_reputation": {
    "canceled_transactions": 0,
    "transactions": {
      "period": "historic",
      "total": null,
      "completed": null,
      "canceled": {
        "total": null,
        "paid": null
      },
      "unrated": {
        "total": null,
        "paid": null
      },
      "not_yet_rated": {
        "total": null,
        "paid": null,
        "units": null
      }
    },
    "tags": [
    ]
  },
  "status": {
    "site_status": "active",
    "list": {
      "allow": true,
      "codes": [
      ],
      "immediate_payment": {
        "required": false,
        "reasons": [
        ]
      }
    },
    "buy": {
      "allow": true,
      "codes": [
      ],
      "immediate_payment": {
        "required": false,
        "reasons": [
        ]
      }
    },
    "sell": {
      "allow": true,
      "codes": [
      ],
      "immediate_payment": {
        "required": false,
        "reasons": [
        ]
      }
    },
    "billing": {
      "allow": true,
      "codes": [
      ]
    },
    "mercadopago_tc_accepted": true,
    "mercadopago_account_type": "personal",
    "mercadoenvios": "not_accepted",
    "immediate_payment": false,
    "confirmed_email": false,
    "user_type": "simple_registration",
    "required_action": ""
  },
  "credit": {
    "consumed": 101.1,
    "credit_level_id": "MLA1"
  }
}

Conteúdos:

Autenticação

Autenticação é o ato ou processo para o estabelecimento ou confirmação de algo ou alguém como real.
A autenticação de uma pessoa consiste na verificação de sua identidade em função de um ou vários fatores, garantindo que os dados enviados sejam corretos.

Alguns métodos de autenticação são:

  • Biomédicos, digitais, retina do olho, etc.
  • Cartões inteligentes contendo informações dos certificados de um usuário.
  • Métodos clássicos baseados em senha.
  • Por exemplo, para acessar o Mercado Livre a autenticação é feita através do login (usuário e senha).

login

Autorização

Autorização é o processo pelo qual é permitido que alguém ou algo acesse recursos privados.
Dentro da autorização deverão ser definidos os recursos e operações que podem ser realizados, pois não é o mesmo outorgar permissões de somente leitura, leitura ou escrita.

Como conseguir a autorização? Através do Protocolo OAuth 2.0, um dos mais utilizados em plataformas abertas (Twitter, Facebook, etc.) e método seguro para trabalhar com recursos privados.

OAuth oferece:

  • Confidencialidade, o usuário não deverá revelar sua senha em momento nenhum.
  • Integridade, só aplicativos que tiverem a permissão poderão ver dados privados.
  • Disponibilidade, os dados sempre estarão disponíveis no momento em que forem necessários.

Dentro deste protocolo há 4 modos de funcionamento possíveis denominados Grant Types:

– The Authorization Code Grant Type (Server Side)
– The Implicit Grant Type (Client Side)
– The Password Credentials Grant Type
– The Client Credentials Grant Type

Embora cada um destes seja utilizado para diferentes finalidades, dependendo do serviço que esteja sendo construído, a seguir só explicaremos os dois primeiros, pois eles permitem trabalhar com nossos recursos e gerar ferramentas para todos os usuários do Mercado Livre.

Client-side

O fluxo de autorização Client side é o adequado para os aplicativos que executam código do lado do cliente, por exemplo, aplicativos desenvolvidos em linguagem javascript/ajax, Angular ou aplicativos mobile.
Para conhecer mais detalhes sobre este fluxo, recomendamos ver o tutorial “Autorização Client-Side”.

Server-side

O fluxo de autorização Server side é o mais adequado para os aplicativos que executam código do lado do servidor, por exemplo, aplicativos desenvolvidos em linguagem Java, Grails, Go, etc.
Notas: Esta opção será útil para aplicativos que executam cron jobs para atualizar estoque de produtos ou operar sem que um usuário esteja interagindo diretamente com o aplicativo.
Para conhecer mais detalhes sobre este fluxo, recomendamos ver o tutorial “Autorização Server-Side”.

Tenha seu access_token!

Introduza o ID do aplicativo criado:

*Favor, coloque um ID valido do aplicativo
User informationJSON Response

-

Uso dos nossos SDK

Mediante o uso dos nossos SDKs, o processo de autorização será mais simples, pois poupará a codificação de todo o protocolo OAuth de zero.
Nossa comunidade já está utilizando!
Oferecemos SDK para:

Se você descobrir uma melhoria ou tiver uma sugestão, pode compartilhá-la com a comunidade, gerando um Pull Request dentro do nosso repositório GitHub.

Considerações

Validade e expiração de tokens
Quando você obtém um access_token, este terá validade imediatamente e poderá ser utilizado para realizar solicitações para a API durante um período limitado de 6 horas.
Alguns eventos podem invalidar um access_token antes do tempo de expiração. Por exemplo: alteração de senha pelo usuário, atualização do App Secret por um aplicativo e, obviamente, a revogação de permissões do seu aplicativo pelo usuário.

Referências de código de erro

Error_code Mensagem de erro Possível solução
invalid_client

client_id ou client_secret inválido.

O client_id e/ou client_secret fornecido não é válido. Verifique as informações de seu aplicativo e os parâmetros client_id e client_secret.
invalid_grant

Para criar um token de acesso, o usuário deverá ter uma sessão ativa ou seu aplicativo deverá solicitar autorização para o escopo offline_access.

A concessão de autorização fornecida não é válida, expirou, foi revogada ou não corresponde à URL de redirecionamento usada na solicitação de autorização. Verifique se o parâmetro redirect_uri é igual ao configurado em seu aplicativo (Gerenciador de Aplicações); caso isso não resolva o problema, faça envie nova solicitação para obter um novo código.
invalid_grant

Erro na validação da concessão. Pode ser que o código de autorização ou o token de atualização tenha expirado ou já tenha sido usado.

Expirou ou já foi usado. Envie uma nova solicitação para obter um novo código ou refresh_token.
invalid_grant

client_id não corresponde ao original.

O ID do client não coincide. Não foi encontrado o parâmetro client_id; para obter seu client_id, consulte seu aplicativo (Gerenciador de Aplicações).
invalid_grant

redirect_url não corresponde à original.

URL de redirecionamento não corresponde à original. Parâmetro redirect_url diferente do configurado em seu aplicativo; para obter redirect_url, consulte o aplicativo (Gerenciador de Aplicações)
invalid_scope

Scope inválido.

O escopo solicitado não é válido, é desconhecido ou é mal formado. Os valores permitidos para o escopo do parâmetro são: “offline_access”, “write”, “read”.
invalid_request

Quantidade incorreta de parâmetros com valores duplicados.

A solicitação não inclui um parâmetro obrigatório, inclui um parâmetro ou valor de parâmetro não aceito ou está mal formada. Verifique se os parâmetros enviados são válidos e não são duplicados.
unsupported_grant_type

Tipo de concessão não aceito: ${0}.

O servidor de autorização não aceita o tipo de concessão. Os valores permitidos para grant_type são “authorization_code” ou “refresh_token”.
forbidden

A chamada não autoriza o acceso ao recurso.

A chamada não autoriza o acceso Se utiliza o token de outro usuário.


Artigos relacionados:
Server side.
Client side.



Próximo:
Consulta usuários.

Please rate this

Receba notificações

Alguns eventos são produzidos apenas do lado do Mercado Livre e a única forma de conhecê-los é através de notificações.
Com as notificações você terá um feed em tempo real das mudanças produzidas nos diferentes recursos da nossa API.
Por exemplo, se você anunciou um item e mais tarde decidiu pausá-lo, se alguém formulou alguma pergunta, se compraram um item ou até se pagaram e/ou solicitaram o envio.
Uma maneira eficiente sem ter que consultar permanentemente nossa API!

Assuntos:

Inscreva-se para receber notificações

Se quiser começar a receber notificações, você deverá acessar seu gerenciador de aplicativos, onde você criou seu aplicativo pela primeira vez, editar os detalhes especificando quais são os topics que você receberá.
Aclaração: Caso você ainda não tenha criado seu aplicativo, acesse seção Criar a sua aplicação.

Topics

– URL de retorno das notificações: Configure a URL pública do domínio onde você quer receber notificações sobre os diversos tópicos. Por exemplo: “http://myshoes-app.com/callbacks”.

– Topics: Selecione dentre os diferentes tópicos para receber notificações.
Aclaração: Tenha em conta que os topics orders, created_orders e payments não são utilizados para imóveis, serviços e automóveis.

Topics Disponíveis

  • items – Você receberá notificações sobre qualquer mudança em um item que tiver publicado.
  • orders – Você receberá notificações sobre qualquer alteração realizada em alguma de suas vendas confirmadas.
  • created_orders – Você receberá notificações de suas vendas recentemente criadas quando entram pelo fluxo do Mercado Pago obrigatório.
    Você só vai obter dados do produto e quantidade de unidades, pois a compra ainda não foi confirmada. Não deve realizar qualquer ação até não passar para “paid”.
    Serve apenas para reserva de estoque, pois se o comprador finalmente pagar mas o item não tiver estoque, o pagamento será automaticamente devolvido e a venda cancelada.
  • Aclaração: Quando a ordem for paga, as notificações começarão a ser enviadas também a partir de “orders”, portanto, sugerimos escolher apenas um dos topics para evitar eventos duplicados.

  • questions – Você receberá notificações de perguntas e respontas feitas.
  • payments – Você receberá notificações quando um pagamento for criado em uma ordem ou o status dela mudar.
  • pictures – Você somente receberá notificações das imagens que, por causa de algum erro, não estiverem disponíveis para download.
  • Nota: Ao mesmo tempo, será enviado um email automático para o vendedor, reunindo as imagens com problemas.

Considerações

  • As mensagens serão enviadas e novas tentativas de envio serão feitas durante um intervalo de 12 horas. Depois desse período, se não forem aceitas pelo aplicativo, elas serão excluídas.
  • Enviaremos um POST a sua URL, portanto, seu aplicativo deverá confirmar o recebimento com um código de status HTTP 200, caso contrário, a mensagem será considerada não entregue e haverá uma nova tentativa de envio.
  • Seu aplicativo deverá enviar uma resposta em 20 segundos, caso contrário, o tempo limite será atingido a notificação será considerada como não entregue e haverá uma nova tentativa de envio.

Quais eventos disparam notificações?

items

  • Alterações em quaisquer atributos.
  • Alterações no status: a publicação deve ser verificada por um operador e o status é alterado para “under_review” ou é pausado, e o status muda para “pausado”.

orders

  • Redução de estoque: alguém compra um de seus produtos, e o estoque tem uma baixa. Um novo pedido é criado.
  • Pagamento: o comprador adiciona um pagamento ao pedido.
  • Envio: novas informações sobre o envio são associadas ao pedido ou o status do envio muda para: pendente, em processamento, ativo, entregue, não entregue.
  • Feedback: o comprador qualifica você como vendedor ou você envia feedback ao comprador. Um feed sobre o pedido é recebido.
  • Aclaração: orders é composto por blocos de outras apis, porém, nem todos os dados são exibidos por serem desnecessários. Esses blocos independentes podem sofrer mudanças, gerando eventos e posteriores notificações sobre a ordem, embora, às vezes, as mudanças relacionadas ao json anterior não sejam visualizadas.

creaters_orders

  • A notificação de creaters_orders chegará quando uma ordem que entrou pelo fluxo de Mercado Pago obrigatório for criada. Serve somente para reserva de estoque.
  • Outras notificações quando a ordem estiver “paid”, são as mesmas que as do topic “orders”. Caso você tenha selecionado os dois, chegarão notificações de ambos os topics.

questions

  • Você recebe uma nova pergunta.
  • Você responde a uma pergunta.
  • Você exclui uma pergunta que considera inadequada.

payments

  • Se gera um pagamento.
  • O estado do pagamento muda.

pictures

  • Quando alguma imagem não estiver disponível para download por causa de algum erro.



Esclarecimento: Caso você receba notificações duplicadas, leve em conta que há eventos internos não visíveis para o integrador que, porém, disparam notificações.

Acesso aos detalhes

Depois de receber uma notificação sobre um tópico, você deverá fazer uma solicitação GET ao recurso para acessar os detalhes e, depois, se tiver salvado o JSON anterior, deverá comparar os dois.

items

Notification response:

{
  "resource": "/items/MLB139876",
  "user_id": 1234,
  "topic": "items",
  "received": "2011-10-19T16:38:34.425Z",
  "sent" : "2011-10-19T16:40:34.425Z",
}

Com essas informações, você poderá realizar um GET para o recurso de items:

curl -X GET https://api.mercadolibre.com/items/{Item_id}?access_token=ACCESS_TOKEN


orders e created_orders

Notification response:

{
    "resource": "/orders/139876",
    "user_id": 1234,
    "topic": "orders",
    "received": "2011-10-19T16:38:34.425Z",
    "sent" : "2011-10-19T16:40:34.425Z",
}

Com essas informações, você poderá realizar um GET para o recurso de orders e created_orders:

curl -X GET https://api.mercadolibre.com/orders/{Order_id}?access_token=ACCESS_TOKEN


questions

Notification response:

{
  "resource": "/questions/139876",
  "user_id": 1234,
  "topic": "questions",
  "received": "2011-10-19T16:38:34.425Z",
  "sent" : "2011-10-19T16:40:34.425Z",
}

Com essas informações, você poderá realizar um GET para o recurso questions:

curl -X GET https://api.mercadolibre.com/questions/{Question_id}?access_token=ACCESS_TOKEN


payments

Notification response:

{
  "resource": "/collections/1780558484",
  "user_id": 149218964,
  "topic": "payments",
  "application_id": 2470,
  "attempts": 1,
  "sent": "2016 - 01 - 15 T18: 12: 31.313 Z ",
  "received": "2016 - 01 - 15 T18: 12: 31.299 Z "
}

Com essas informações, você poderá realizar um GET para o recurso collections:

curl -X GET https://api.mercadolibre.com/collections/{Payment_id}?access_token=ACCESS_TOKEN


pictures

Notification response:

{
  "messages": [
    {
      "_id": "123aaa456bbb789ccc",
      "application_id": "1234",
      "user_id": "123456789",
      "resource": "/pictures/12345-MLA1234567-20160729"/errors,
      "topic": "pictures",
      "sent": "2016-07-24T11:00:00.836Z",
      "received": "2016-07-24T11:00:00.836Z",
      "attempts": "2",
      "created_at": "2016-07-24T11:00:00.836Z"
    }
  ]
}

Com essas informações, você poderá realizar um GET para o recurso picture:

curl -X GET https://api.mercadolibre.com/pictures/{picture_id}/errors?access_token=ACCESS_TOKEN

Você terá que identificar por que a imagem não foi corretamente processada. Ver “Considerações e melhores práticas para trabalhar com imagéns”.

API do histórico dos feeds

Um registro de seu histórico de notificações é salvo, e você pode acessá-lo a qualquer momento chamando nosso recurso feeds.
Exemplo:

curl -X GET https://api.mercadolibre.com/myfeeds?app_id={App_id}

Resposta:

{
  "messages": [
  {
    "_id": "123aaa456bbb789ccc",
    "application_id": "1234",
    "user_id": "123456789",
    "resource": "/orders/12345678",
    "topic": "orders",
    "sent": "2014-10-24T11:00:00.836Z",
    "received": "2014-10-24T11:00:00.836Z",
    "attempts": "2",
    "http_code": "400",
    "created_at": "2014-10-24T11:00:00.836Z"
  }
}
}

Nota: Lembre que, por default, só serão mostradas 10 notificações, porém, você pode utilizar LIMIT e OFFSET para modificar o número que quer receber, como mostrado abaixo:

https://api.mercadolibre.com/myfeeds?app_id=(APP_ID)&offset=1&limit=5


Próximo:
Consultas avançadas.

Please rate this

Publicação de automó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, automó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 automó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á seu automóvel diretamente de nosso site, mas vai mostrá-la a todos os usuários que estiverem buscando automó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 automó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 autmóveis

Vamos ver um automó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.

http://developers.mercadolibre.com/list-your-item/ - listing-type-attribute

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 automó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 automó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, 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 -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.

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 automóveis

Agora você já está pronto para publicar seu primeiro item classificado. Lembre de que, para isso, você vai precisar de um access_token.
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: "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.
Nota: se você experimentar algum inconveniente ao tentar publicar, consulte os valores de referência da tabela de códigos de erro da API localizados no final deste guia.



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



Contribuições de nossa comunidade

Please rate this