Moderations

The resource /infractions provides relevant information related to the infractions detected in any of the published elements (items, questions, answers and reviews of the product).

Contents

→Consult infractions
→Consult infractions with filter
    ↳Available filters
→Picture quality
    ↳Identify errors
    ↳Parameters description
    ↳Possible Condition IDs
    ↳Error handling


Consult infractions

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

  • items
  • questions or answers
  • 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 -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"
}


Picture quality

The /quality/picture resource will allow you to identify what type errors the images on items that have a poor_quality_thumbnail tag this means the images were validated by Mercado Libre and do not meet image requirements. Thus, you will be able to identify the listingswith low quality images and why they were moderated, causing loss of exposure in the search results.
Learn more about the Item Search resource and the importance of photos for sellers.


Identify errors

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

curl -H 'Authorization: Bearer $ACCESS_TOKEN' -X GET https://api.mercadolibre.com/marketplace/quality/pictures/$ITEM_ID

Response:

{
    "itemID": "MLM0111111",
    "quality": "good",
    "thumbnail": "344725-MLM25503040734_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 listing exceed the minimum 500 x 500 px.
logo_text_watermark: evaluate whether the first image of the listing contains logos, text, promotional banners or watermarks.
white_background: evaluate if the first image of the listing 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 listing to contain several pairs of shoes.
blur: evaluate that the images in the listing 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 -H 'Authorization: Bearer $ACCESS_TOKEN' -X GET https://api.mercadolibre.com/marketplace/tagging/quality/message/$ITEM_ID

Response:

{
   "reason": "To recover your exposure, correct your photos
Keep in mind that you should show only one model of your product per photo, not include logos and use white background, really white!", "conditions": [ { "id": "qualityDetector", "message": "Keep in mind that you should show only one model of your product per photo, not include logos and use white background, really white!" } ] }
Note:
When you correct the image of a listing that has been moderated, the validations will be carried out again, and if they are positive, the moderation tag will be removed, recovering the item normal exposure.

Learn more about how work with pictures.