Documentation Mercado Libre
Check out all the necessary information about APIs Mercado Libre.Documentation
Moderations
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".
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 listings with 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"
}
Response fields
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.
Errors
Status (error) | Message | Detail |
---|---|---|
403 | access_token is missing | Invalid access_token example |
404 | No picture tagged for item (Item_id) | Example of unvalidated item |
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!"
}
]
}
Learn more about how work with pictures.