Documentación Mercado Libre

Descubre toda la información que debes conocer sobre las APIs de Mercado Libre.
circulos azuis em degrade

Documentación

Última actualización 09/03/2023

Update your listings

Once you have active listings on our site, you will probably need to update and modify them to sync to exclude already sold listings, pause listings, improve descriptions, update prices, etc. Follow this guide to learn how to do it.


Considerations

You can modify the values for:

  • Title
  • Price
  • Video
  • Pictures
  • Description*
  • Location
  • Attributes (array “attributes”)

*It's not possible modify, just add a post.


Also remember that:

  • Category can’t be modified via API.
  • Listing type can be modified only once.

Update your item

Let’s see a basic example of updating an item title and price. The only thing you need is the item_id of the listed product and of course, the seller’s access_token.


Example:

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

Nice, your item title and price has been updated and you should receive a code 200 OK response status to know everything went well. Keep in mind that it can take some time until you see the item’s information refreshed.


Description

It’s very easy to update a description, and is something you can do whether the item has bids or not, but since there are some considerations you need to keep when adding or replacing descriptions, check our descriptions article to make sure you get it right.


Pictures

You can always add or replace item pictures, refer to our working with pictures tutorial to know the best way to get through it.


Listing types

When you want more exposition on your item you need to make a listing type upgrade. Know the details and considerations and learn how to achieve an upgrade on our Listing types and Upgrades tutorial.


Changing listing status

Any item listed on our marketplace can hold different status, check the following description of each one:

  • closed: Finalizes your publication. Once closed, it cannot be reactivated again, but it can be relisted.
  • paused: Pauses your publication. Once paused, the contact data will no longer be visible.
  • active: Reactivates a previously paused item.

If you need to make any changes on the item status, you need to send any of these values for the “status” field, note the value is case sensitive and must be sent in lowercase. Follow the example to pause an active item.


Example:

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

Excellent! Your item has been paused. Now you can try to activate it again by making the exact same call sending “active” instead of “paused” as the status value. If your item is currently closed and your intention is to relist it, check our relist article to achieve it right away. Please check out the listing validity time of the publication article to know more about item status.


Delete listing

Deleting a listing has no way back, so be careful when you call this action. Also note that there’s no need to delete closed items since they’ll be discarded automatically after some time.


Example:

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
Note:

If with the second PUT you get an error:

message: item optimistic

locking error: conflict

status: 409

cause: array(0)


This means you should wait a few seconds until the information is updated. Once the listing is removed, it will remain in the VIP for a short time as "listing finished.".

That’s it! Your item should be removed.


Next topic: Manage contacts & visits.