Atualize suas publicações

Depois que você tiver publicações ativas no Mercado Livre, é provável que precise atualizá-las periodicamente. Isso permitirá sincronizar as informações, remover anúncios de imóveis já vendidos, pausar publicações, otimizar descrições e atualizar preços, entre outras ações.

Para atualizar publicações, envie uma solicitação PUT para o recurso /items/{item_id} com o id do item a ser atualizado. No body deve constar o JSON contendo apenas os campos que deseja modificar com seus novos valores. Os campos omitidos não serão alterados.

Veja um exemplo básico de atualização do preço de uma publicação. Tudo o que você precisa é do item_id do imóvel publicado. Não se esqueça de incluir o access_token para autenticação.

Chamada:

 curl -X PUT \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  'https://api.mercadolibre.com/items/$ITEM_ID' \
  -d '{
    "price": 100000001
  }'

Ao executar qualquer atualização, você receberá a resposta com status 200 e o corpo como se tivesse publicado um item, com os dados atualizados. Você pode consultar mais informações em Publicar Imóveis. A seguir, veja outros exemplos.

Destacar uma publicação

Para aumentar a visibilidade de uma publicação, você deve realizar uma solicitação POST para atualizar o campo listing_type.

Você deve ter o id do item que publicou e deseja destacar.

Chamada:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/{ITEM_ID}/listing_type -d '{"id":"gold_premium"}'

Você receberá uma resposta com status 200 e o corpo como se tivesse publicado um item, mas com o campo listing_type atualizado para gold ou gold_premium.

"buying_mode": "classified",
"listing_type_id": "gold_premium",
"start_time": "2025-06-11T21:25:54.260Z",
"stop_time": "2025-12-08T04:00:00.000Z",
"end_time": "2025-12-08T04:00:00.000Z",

É importante observar que:

• Nenhuma cobrança é gerada ao realizar esta atualização (chamada de API).
• Se a atualização for revertida, a cota do pacote de destaque volta a ficar disponível.
• Não é possível destacar uma publicação sem ter contratado ao menos um pacote de destaque.

Modificar a localização do seu imóvel

Se por algum motivo você precisar atualizar a localização do seu imóvel, e já tiver todas as informações conforme o guia de Localizar imóveis, envie uma requisição com os dados a serem atualizados.

curl -X PUT \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  'https://api.mercadolibre.com/items/$ITEM_ID' \
  -d '{
    "location": {
      "address_line": "Endereço atualizado do imóvel 111",
      "zip_code": "5000",
      "neighborhood": {
        "id": "TUxBQlBBTDI1MTVa",
        "name": "Palermo"
      },
      "city": {
        "id": "TUxBQ0NBUGZlZG1sYQ",
        "name": "Capital Federal"
      }
    }
  }'

Você receberá a resposta como se tivesse publicado um item, com os dados atualizados. Pode consultar essa informação em Publicar Imóveis.

Atualizar a loja oficial do imóvel

Se você precisar atualizar a loja oficial associada ao seu item, deverá fazer uma requisição do tipo PUT para o endpoint /items. A resposta será semelhante à de uma publicação, com a diferença no campo official_store_id.

curl -X PUT \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  'https://api.mercadolibre.com/items/$ITEM_ID' \
  -d '{
   "official_store_id": 3121
  }'

Você receberá a resposta como se tivesse publicado um item, com os dados atualizados. Pode consultar essa informação em Publicar Imóveis.

Alterar o status das suas publicações

Cada item publicado no marketplace pode estar em um dos vários estados que definem sua disponibilidade e visibilidade para os usuários. A seguir, são descritos os estados disponíveis e seu comportamento:

Para alterar o status de um item, envie um dos valores descritos para o campo status na solicitação de atualização. O valor deve ser enviado em letras minúsculas, respeitando exatamente a palavra, pois o campo diferencia maiúsculas e minúsculas.

Exemplo:

curl -X PUT \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  'https://api.mercadolibre.com/items/$ITEM_ID' \
  -d '{
    "status":"paused"
  }'

Dessa forma, você poderá pausar ou reativar sua publicação. Por outro lado, se você alterar sua publicação para “closed” (fechada) ou ela já estiver nesse estado e quiser publicá-la novamente, consulte nosso artigo sobre republicação.

Para mais informações sobre os estados do seu imóvel, consulte o Ciclo de vida das publicações.

Guia para alguns campos

1. Atualizar descrição

Assim como os outros campos, a descrição pode ser atualizada facilmente. No entanto, para fazer isso da melhor forma, siga as orientações do guia de descrição de produtos. Isso ajudará a garantir que sua publicação esteja otimizada.

2. Atualização de imagens

Você pode adicionar ou substituir imagens e vídeos em suas publicações. Consulte o tutorial de Trabalhar com imagens para conhecer as melhores práticas.

3. Atualizar tipo de publicação

Se quiser aumentar a exposição do seu imóvel, atualize o tipo de publicação. Para entender melhor como isso funciona, veja a documentação sobre Tipos de publicação e como obter mais exposição.

Excluir publicações

Excluir uma publicação é uma ação irreversível que finaliza e remove permanentemente o item do marketplace. Portanto, recomenda-se realizar esta operação com cautela.

Processo para excluir um item

1. 1. Alterar o status do item para closed: Neste passo, a publicação é encerrada, alterando seu status para closed.

   curl -X PUT \
     -H "Authorization: Bearer $ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -H "Accept: application/json" \
     'https://api.mercadolibre.com/items/$ITEM_ID' \
     -d '{
       "status":"closed"
     }'
   

2. 2. Excluir o item permanentemente: Depois que o item estiver com status closed, execute o seguinte comando para removê-lo definitivamente:

   curl -X PUT "https://api.mercadolibre.com/items/$ITEM_ID" \
     -H "Authorization: Bearer $ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -H "Accept: application/json" \
     -d '{
       "deleted": true
     }'
   

Assim como nas atualizações anteriores, você receberá uma resposta como se tivesse publicado um imóvel, mas com a diferença de que o campo sub_status incluirá deleted:

"status": "closed",
"sub_status": [
    "deleted",
    "pack_quota_assigned"
]

Erro comum ao excluir sua publicação

Se ao executar o passo anterior você receber o seguinte erro:

{
  "message": "item optimistic locking error: conflict",
  "status": 409,
  "cause": []
}

Isso significa que as informações do item ainda não foram completamente atualizadas no sistema. Nesse caso, aguarde alguns segundos e tente novamente.

Considerações finais ao excluir uma publicação:

• Após excluir seu imóvel, ele pode continuar aparecendo temporariamente na visualização do vendedor com a mensagem "publicação finalizada". Isso é normal e desaparecerá automaticamente após algum tempo.
• Lembre-se de que a exclusão é definitiva: não é possível reativar nem recuperar o item removido.

Leituras recomendadas

• Ciclo de vida das publicações.
• Qualidade das publicações.

Atualizações de versão

Esta seção fornece informações sobre as atualizações da API, incluindo:

Histórico de alterações