Manage moderations

Filter items with infractions

To get items with moderations you can check those with status under_review, and sub-status: warning, waiting_for_patch, held, pending_documentation, forbidden, picture_dowloading_pending filtering by status "pending".

Request:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/$USER_ID/items/search?status=pending

Example:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/123456/items/search?status=pending

Response:

{
  "seller_id": "123456",
  "query": null,
  "paging": {
      "limit": 50,
      "offset": 0,
      "total": 8
  },
  "results": [
      "MLC951993111",
      "MLC951803222",
      "MLC949619333",
      "MLC949606444",
      "MLC947744555",
      "MLC947725666",
      "MLC947725777",
      "MLC947699888"
  ],
  "orders": [...]
}

Status, substatus and moderations tag

More info about Flow and status of publications.

Consult a user's moderations

With the following consult you can see the moderations with final(forbidden) and temporary (waiting_for_patch, held, pending_documentation) statuses. You will not see the items removed by duplicates. We recommend you to identify the reason and remedy and provide actionable for sellers according to the type of moderation received.

Optional parameters

Allow you to filter a user's moderations according to:

• related_item_id: ID of the publication associated with the infraction.
• element_id: ID of the moderated element.
• element_type: Type of the moderated element. ITM (item), REV (review), QUE (question/answer).
• date_created_since: Start date of filtering. Format: YYYYY-MM-DD
• date_created_to: End date of filtering. Format: YYYYY-MM-DD
• language: You can request the reason and remedy texts in English or Portuguese. The default language is English. ES (Spanish) or PT (Portuguese).
• limit: Number of infractions returned. The value is from 1 to 20. Default is 20.
• offset: Offset for pagination.
• sort: Sort the results by creation date in ascending or descending order. Example date_created_asc, date_created_desc.

Request:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/moderations/infractions/288230000?date_created_since=2023-09-01&limit=2

Example:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/moderations/infractions/288230000?date_created_since=2023-09-01&limit=2

Response:

{
  "infractions": [
      {
          "id": "1378710000",
          "date_created": "2023-09-11T10:37:45.107-0400",
          "user_id": "288230000",
          "related_item_id": "MLA135230000",
          "element_id": "MLA13520000",
          "element_type": "ITM",
          "site_id": "MLA",
          "filter_subgroup": "DESC",
          "reason": "La pausamos porque detectamos un cambio inusual en su precio. Verifica el valor antes de reactivarla. Una vez que lo hagas, quedará activa en unos minutos.",
          "remedy": "Inactiva para revisar
La pausamos porque detectamos un cambio inusual en su precio. Verificá el valor antes de reactivarla. Una vez que lo hagas, quedará activa en unos minutos."
      },
      {
          "id": "1366077111",
          "date_created": "2023-09-03T13:02:14.109-0400",
          "user_id": "288230000",
          "related_item_id": "MLA13862111",
          "element_id": "MLA138621111",
          "element_type": "ITM",
          "site_id": "MLA",
          "filter_subgroup": "PQT",
          "reason": "Tu foto de portada no tiene fondo blanco puro. Corrígelo para reactivar tu publicación.",
          "remedy": "Tu foto de portada aún tiene problemas, corrígela para reactivar tu publicación.
El fondo de esta foto debe ser blanco puro, ¡no uses texturas o elementos de fondo!"
      }
  ],
  "paging": {
      "offset": 0,
      "limit": 2,
      "total": 3
  },
  "sorting_type": "date_created_desc"
}

Response fields

• id: Unique identifier of the infraction.
• date_created: Date on which the infraction occurred.
• user_id: The user who made the infringement.
• related_item_id: Unique identifier of the publication related to the element that has the infraction. If the infraction is in a publication, the value of this attribute will be equal to the value of the element_id attribute.
• element_id: Unique identifier of the offending element. It depends on the element_type attribute.
• element_type: Type of element, the values can be: ITM (publication), WHAT (questions and answers) and REV (product reviews).
• subgroup: This field allows you to identify, group and summarize (sum up) the violations belonging to the different filter groups.

• reason: text (html) describing the reason and policy that was infringed.
• remedy: text (html) indicating the action, only in cases where it is recoverable.

Moderations for VIS

The following table lists the possible moderations that apply to the different business units related to vehicles and real estate (VIS), as well as the possible actionable and some recommendations to correct the moderation:

Next: Moderations with paused