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"
}