Documentation Mercado Libre

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

Documentation

Last update 22/04/2025

Moderations

The resource /infractions provides relevant information related to the moderations detected in any of the published elements (items, questions, answers and reviews of the product). Remember the seller is warned the first time. Then, he is warned again and suspended for 2 days (unable to operate on the platform). Finally, the seller received an ultimatum and will be suspended for 5 days (unable to operate on the platform).


Get infractions by user

We recommend that you identify the reason (reason) and solution (remedy) to apply in the language corresponding to the site of the infraction or in English, and in addition, you can identify and summarize the moderations for miscategorized posts.

  • items
  • questions or answers
  • products review

Request:

curl -H 'Authorization: Bearer $ACCESS_TOKEN' -X GET https://api.mercadolibre.com/marketplace/moderations/infractions/$USER_ID

Example:

curl -H 'Authorization: Bearer $ACCESS_TOKEN' -X GET https://api.mercadolibre.com/marketplace/moderations/infractions/12345678

Response:

{
   "infractions": [
       {
            "id": "632617313",
            "date_created": "2020-12-03T03:18:15.338-0400",
            "user_id": "123455",
            "related_item_id": "MLM123456",
            "element_id": "MLM123456",
            "element_type": "ITM",
            "site_id": "MLM",
            "reason": "Low quality cover image.",
            "remedy": "In order to maintain visibility, make sure that the first image has a solid white background created with an image editor. Do not add edges, logos or watermarks."
        }
   ],
   "paging": {
       "offset": 0,
       "limit": 2,
       "total": 20671
   },
   "sorting_type": "date_created_desc"
}

Response fields

id: unique identifier of the infraction.
date_created: date the infraction occurred.
user_id: the user who carried out the infraction.
related_item_id: unique identifier of the post related to the item that owns the infraction. If the violation is in a post, the value of this attribute will equal the value of the element_id attribute.
element_id: unique identifier of the item that owns the violation. It is dependent on the element_type attribute.
element_type: type of element, the values can be: ITM (listing), QUE (questions and answers) and REV (reviews /product opinion).
site_id: marketplace site of the item with the infraction.
reason: text (html) that describes the reason and infractions policy.
remedy: text (html) that indicates the action, only in cases where it is recoverable. For example, "Remove personal data from listing".


Note:
The response you will not see the items written out in duplicates and only the items in which the states can be final (forbidden) or temporary (waiting_for_patch, held, pending_documentation) appear. If you want to check if a user is suspended you can check the status => list => allow through the api of users. In case that field is false, it means that it is suspended.
Important:
In case the user is suspended, please check the account configuration in the Help site.

Consult infractions with filter

Available filters

Filter Description Options Default
related_item_id Post ID associated with the moderation - -
element_id Id of the moderate element - -
element_type Moderate element type ITM (item)
REV (review)
QUE (question/aswer)
-
date_created_since Filtering start date Format: YYYY-MM-DD -
date_created_to Filtering end date Format: YYYY-MM-DD -
limit Number of infractions returned Integer from 1 to 20 20
offset Offset for paging 0
sort Sort results by creation date, ascending or descending date_created_asc, date_created_desc date_created_desc

Request:

curl -H 'Authorization: Bearer $ACCESS_TOKEN' -X GET https://api.mercadolibre.com/marketplace/moderations/infractions/$USER_ID?date_created_since=AAAA-MM-DD&limit=XX&offset=X

Example:

curl -H 'Authorization: Bearer $ACCESS_TOKEN' -X GET https://api.mercadolibre.com/marketplace/moderations/infractions/12345678?date_created_since=2020-12-15&limit=1&offset=0

Response:

{
   "infractions": [
        {
            "id": "632617313",
            "date_created": "2020-12-03T03:18:15.338-0400",
            "user_id": "123455",
            "related_item_id": "MLM123456",
            "element_id": "MLM123456",
            "element_type": "ITM",
            "site_id": "MLM",
            "reason": "Low quality cover image.",
            "remedy": "In order to maintain visibility, make sure that the first image has a solid white background created with an image editor. Do not add edges, logos or watermarks."
        }],
   "paging": {
       "offset": 0,
       "limit": 1,
       "total": 20671
   },
   "sorting_type": "date_created_desc"
}