Documentation Mercado Libre

Check out all the necessary information about APIs Mercado Libre.
circulos azuis em degrade

Documentation

Last update 28/01/2025
Important Announcement: Replacement of Current API Section
We are excited to announce that a new API for creating Global Selling items items is now available. This new functionality allows you to create both global and local items in a single step, simplifying the publication process significantly.

If you are starting a new development, we strongly recommend using the new API and the associated information to ensure a smooth integration.

For those who already have ongoing development, it would be prudent to continue using the existing documentation and plan for a migration to this new publishing method in the near future.

Take advantage of this improvement and optimize your experience with Global Selling!

Listing limits

With this resource you obtain information on the limit of active publications that a seller has for each of the sites based on their reputation. Learn more about What are the listing limits.

Get listing limit

Send the access token of the global user to get the limit quantity of listings available per each marketplace user.

Request:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/marketplace/users/cap

Response:

[
    {
        "user_id": 823718333,
        "site_id": "MLM",
        "logistic_type": "remote",
        "quota": 15000,
        "total_items": 6
    },
    {
        "user_id": 823714222,
        "site_id": "MLC",
        "logistic_type": "remote",
        "quota": 15000,
        "total_items": 0
    },
    {
        "user_id": 823714444,
        "site_id": "MLB",
        "logistic_type": "remote",
        "quota": 0,
        "total_items": 14
    }
]

Response fields

quota: limit quantity of active items that the seller can have for each marketplace
site: This limit depends on the reputation that the seller has for that site
total_items: active listings quantity that the seller has for this site

Limit listings according seller reputation level

Reputation Level New cap
green platinum 50.000
green gold 50.000
green silver 20.000
green 10.000
light green 10.000
yellow 3.000
orange 1.000
red 1.000
newbie 1.000

Next: Global items.