Documentação do Mercado Livre

Confira todas as informações necessárias sobre as APIs Mercado Livre.
circulos azuis em degrade

Documentação do

Última atualização em 14/03/2023

Sincronização de publicações (veículos)

Assim que você tiver publicações ativas em nosso site, é provável que você tenha de fazer atualizações e alterações periodicamente para excluir anúncios já vendidos, pausar publicações, melhorar descrições, atualizar preços etc. Leia o guia a seguir e saiba como fazer isso:


Considerações

Você pode alterar valores para:

  • Title
  • Price
  • Video
  • Pictures
  • Description
  • Location
  • Atributos da publicação (array “attributes”)
  • Category

Você pode alterar valores para: o tipo de publicação só pode ser alterado uma vez.


Atualização de seu anúncio


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

Exemplo:
curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN'  -H "Content-Type: application/json" -H "Accept: application/json" -d
{
  "title": "Your new title",
  "price": 1000
}
https://api.mercadolibre.com/items/ITEM_ID

Pronto. O título e o preço de seu anúncio 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. No entanto, como há algumas considerações que você deve lembrar ao adicionar ou substituir descrições. Consulte o nosso artigo sobre descrições para ter certeza de que entendeu.


Imagens

Você sempre pode adicionar ou substituir imagens dos anúncios. Leia o nosso tutorial sobre como trabalhar com imagens para saber qual a melhor maneira de fazer isso.


Tipos de publicação

Caso você queira dar mais exposição ao seu anúncio, 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 de tipos de publicações e upgrades.


Mudança de status das publicações

Qualquer anúncio publicado em nosso site 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, os visitantes não poderão entrar em contato com você, pois os dados de contato do anúncio são removidos.
  • ativo: reativa um produto previamente pausado.

Se você precisar fazer alterações no status do anúncio, 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 'Authorization: Bearer $ACCESS_TOKEN'  -H "Content-Type: application/json" -H "Accept: application/json" -d
{
  "status":"paused"
}
https://api.mercadolibre.com/items/ITEM_ID

Excelente! Seu anúncio 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 anúncio 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 a seção sobre tempo de validade da publicação.


Exclusão de publicações

Após excluir uma publicação, não há como reverter. Por isso, tenha cuidado ao fazer isso. Lembre-se sempre de excluir anúncios que já foram vendidos, pois, eles concorrem com seus outros anúncios que estão ativos.


Exemplo:


curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN'  -H "Content-Type: application/json" -H "Accept: application/json" -d
{
"status": "closed"
}
https://api.mercadolibre.com/items/ITEM_ID
Segundo passo
curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN'  -H "Content-Type: application/json" -H "Accept: application/json" -d
{
"deleted":"true"
}
https://api.mercadolibre.com/items/ITEM_ID
Nota:
Se ao fazer o segundo PUT você obtiver o erro: message: item optimistic locking error: conflict status: 409 cause: array(0) deverá esperar alguns segundos até a informação se atualizar. Eliminado o anúncio, ele continuará sendo visualizado na página do produto durante um breve período com a legenda "anúncio finalizado".

Próxima: Gerenciamento de contatos.