Documentación Mercado Libre

Descubre toda la información que debes conocer sobre las APIs de Mercado Libre.
circulos azuis em degrade
Última actualización 14/03/2023

Sincronização de publicações (imóveis)

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 de la publicación (array “attributes”)
  • Category

*Não é possível modificar, basta adicionar um posto.

Você também deve lembrar que 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. 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 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 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 de 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

Depois de 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 paso
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 VIP durante um breve período com a legenda "anúncio finalizado".

Pronto! Seu produto será excluído.


Próximo: Gerenciamento de contatos.