Moderations

The resource /infractions provides the relevant information related to the infractions detected in any of the published elements (items, questions, answers and opinion of the product). Learn more about Mercado Libre's publishing policies. (Argentina, Brazil, México, Chile, Colombia and Uruguay).

Contents

→Consult infractions
→Consult infractions with filter
    ↳Available filters
→Picture quality
    ↳How to identify errors
    ↳Parameter description
    ↳Possible Condition IDs
    ↳Error handling


Consult infractions

Importante:
This new version will be available from December 1, 2020. It will return more information and you can better filter the queries.

Through the GET you can check the elements affected by some type of moderation including:

  • items
  • questions o aswers
  • products review

You will also be able to know the reason and solution (remedy) to apply in Spanish/Portuguese (it depends on the site where the infraction applies) or in English.
Request:

curl -X GET https://api.mercadolibre.com/moderations/infractions/$USER_ID?access_token=$ACCESS_TOKEN

Example:

curl -X GET https://api.mercadolibre.com/moderations/infractions/12345678?access_token=$ACCESS_TOKEN

Response:

{
   "infractions": [
       {
           "id": "594794188",
           "date_created": "2020-10-28T01:43:32.414-0400",
           "user_id": "12345678",
           "related_item_id": "MLA1692147078",
           "element_id": "MLA1692147078",
           "element_type": "ITM",
           "site_id": "MLA",
           "reason": "La anulamos porque la categoría en elegiste no corresponde con tu foto de portada o título.",
           "remedy": "Modifica la categoría de tu publicación para que se corresponda con tu título y foto de portada."
       },
       {
           "id": "594651285",
           "date_created": "2020-10-27T22:46:17.631-0400",
           "user_id": "12345678",
           "related_item_id": "MLB1692147078",
           "element_id": "MLA1692147078",
           "element_type": "ITM",
           "site_id": "MLA",
           "reason": "La anulamos porque la categoría en elegiste no corresponde con tu foto de portada o título.",
           "remedy": "Modifica la categoría de tu publicación para que se corresponda con tu título y foto de portada."
       }
   ],
   "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 (publication), 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 publication".


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 (https://api.mercadolibre.com/users/$USER_ID). In case that field is false, it means that it is suspended.
Important:
In case the user be suspended, should check the account configuration in Help site.

Consult infractions with filter

Available filters

Filter Description Options Default
related_item_id Post ID associated with the infraction - -
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 Formato: YYYY-MM-DD -
date_created_to Filtering end date Formato: YYYY-MM-DD -
language You can request the reason and remedy texts in English, as well as the default language of the country where the element is published. EN The official language of the country where the moderate element is published, Portuguese (for Brazil) and Spanish (for Hispanics)
limit Number of infractions returned El valor es de 1 a 20 20
offset Offset para el paginado 0
sort Sort results by creation date ascending or descending date_created_asc, date_created_desc date_created_desc

Request:

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

Example:

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

Response:

{
   "infractions": [
       {
           "id": "594794188",
           "date_created": "2020-10-28T01:43:32.414-0400",
           "user_id": "12345678",
           "related_item_id": "MLA169211231",
           "element_id": "MLA169211232",
           "element_type": "ITM",
           "site_id": "MLA",
           "reason": "La anulamos porque la categoría en elegiste no corresponde con tu foto de portada o título.",
           "remedy": "Modifica la categoría de tu publicación para que se corresponda con tu título y foto de portada."
       }],
   "paging": {
       "offset": 0,
       "limit": 1,
       "total": 20671
   },
   "sorting_type": "date_created_desc"
}


Picture quality

The /quality/picture resource will allow you to identify what type errors the images of those items that have the poor_quality_thumbnail tag have, that is, they were validated by Mercado Libre and do not meet any image requirement. Thus, you will be able to identify the publications with images of low quality and, consequently, that they have been moderate, causing loss of exposure in the search listings.
Learn more about the Item Search resource and the importance of photos for sellers.


How to identify errors

To identify whether or not there are items with errors, make this request:

curl -X GET https://api.mercadolibre.com/quality/pictures/$ITEM_ID?access_token=$ACCESS_TOKEN

Response:

{
    "itemID": "MLA0111111",
    "quality": "good",
    "thumbnail": "344725-MLA25503040734_042017",
    "conditions": [
        {
            "id": "white_background",
            "passed": true
        },
        {
            "id": "minimum_size",
            "passed": true
        },
        {
            "id": "logo_text_watermark",
            "passed": true
        },
        {
            "id": "unprofessional_photo",
            "passed": true
        }
    ],
    "taggedDate": "2019-05-02T07:27:40Z"
}

Parameter description

itemID: Listing ID.
quality: Picture quality may take “good” or “poor” values to define a “good picture” or “bad picture” status, respectively.
thumbnail: Picture with which the item was processed corresponds to the item thumbnail.
conditions: Set of conditions to be met by an item to determine picture quality. A condition consists of an ID (with a brief definition of the analyzed aspects) and a passed attribute, a Boolean value that defines whether or not the picture meets the condition.
taggedDate: Date of latest item processing.


Possible Condition IDs

minimum_size: evaluate if any of the images in the publication exceed the minimum 500 x 500 px.
logo_text_watermark: evaluate whether the first image of the publication contains logos, text, promotional banners or watermarks.
white_background: evaluate if the first image of the publication has a pure white background. In other words, a white background created with an image editor, instead of a product photo in front of a wall or other element.
multiproduct: evaluate if the first image contains more than one product. For example, we do not allow the first image of the publication to contain several pairs of shoes.
blur: evaluate that the images in the publication are not blurry.
unprofessional_photo: it is executed when the rest of the validations are negative and evaluates three conditions at the same time: multiproduct, white background and logos. It does not mean that the image meets all three, but may not be complying with any of the three.
rollbacked: this validation is reserved for the customer service team. We use it when a seller contacts to claim for incorrect detections (false positive). Once applied, the photo is not re-moderated, unless the seller changes the image.


Error handling

Error structure

{
"error": Error Type,
"code": Error code,
"message": error message,
"cause": list of error cause
}

Invalid access_token example

{
  "message": "access_token is missing",
  "error": "Forbidden",
  "status": 403,
  "cause": "Couldn't validate authentication"
}

Example of unvalidated item

{
 "message": "No picture tagged for item (Item_id)",
 "error": "Not Found",
 "status": 404,
 "cause": "Element not found"
}

Use the resource below to query the actions to make if the main picture of your listing fails to meet any of the above validations:

Request:

curl -X GET https://api.mercadolibre.com/tagging/quality/message/$ITEM_ID

Response:

{
  "reason": "Para recuperar tu exposición, corregí tus fotos
  • Asegurate de que la primera imagen de tu producto tenga como mínimo 500 píxeles en uno de los lados. Te recomendamos usar 1200 x 1200, para que puedan hacer zoom.
", "conditions": [ { "id": "sizePictures", "message": "Asegurate de que la primera imagen de tu producto tenga como mínimo 500 píxeles en uno de los lados. Te recomendamos usar 1200 x 1200, para que puedan hacer zoom." } ] }
Note:
When you correct the image of a publication that has been moderated, the validations will be carried out again, and if they are positive, the tag will be removed, and it will recover its original exposure.

Learn more about how work with pictures.

or register to recieve the latest news about our API