Gestionar Moderaciones

Filtrar ítems con infracciones

Para obtener ítems con moderaciones puedes consultar aquellos con status under_review, y sub-estado: warning, waiting_for_patch, held, pending_documentation, forbidden, picture_dowloading_pending filtrando mediante el status "pending".

Llamada:

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

Ejemplo:

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

Respuesta:

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

Status, substatus y tags de moderaciones

Conoce más sobre flujo y los estados de las publicaciones.

Consultar moderaciones de un usuario

Con la siguiente consulta puede ver las moderaciones con estados finales (forbidden) y temporales (waiting_for_patch, held, pending_documentation). No verás los ítems dados de baja por duplicados. Te recomendamos identificar la razón (reason) y solución (remedy) y garantizar accionables para vendedores según el tipo de moderación recibida.

Parámetros opcionales

Te permitirán filtrar las moderaciones de un usuario según:

• related_item_id: ID de la publicación asociada a la infracción.
• element_id: ID del elemento moderado.
• element_type: Tipo del elemento moderado. ITM (item), REV (review), QUE (pregunta/respuesta).
• date_created_since: Fecha de inicio del filtrado. Formato: YYYY-MM-DD
• date_created_to: Fecha de fin del filtrado. Formato: YYYY-MM-DD
• language: Puedes solicitar los textos del reason y remedy en idioma español o portugués. El idioma por default es inglés. ES (español) o PT (portugués).
• limit: Cantidad de infracciones devueltas. El valor es de 1 a 20. Por default 20.
• offset: Offset para el paginado.
• sort: Ordenar los resultados por fecha de creación de manera ascendente o descendente. Ejemplo date_created_asc, date_created_desc.

Llamada:

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

Ejemplo:

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

Respuesta:

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

Campos de la respuesta

• id: Identificador único de la infracción.
• date_created: Fecha en que se produjo la infracción.
• user_id: El usuario que realizó la infracción.
• related_item_id: Identificador único de la publicación relacionada con el elemento que posee la infracción. Si la infracción es en una publicación, el valor de este atributo será igual a valor del atributo element_id.
• element_id: Identificador único del elemento que posee la infracción. Es dependiente del atributo element_type.
• element_type: Tipo de elemento, los valores pueden ser: ITM (publicación), QUE (preguntas y respuestas) y REV (reviews de productos).
• subgroup: Este campo te permite identificar, agrupar y resumir (sumarizar) las infracciones pertenecientes a los distintos grupos de filtros.

• reason: texto (html) que describe el motivo y política que se infraccionó.
• remedy: texto (html) que indica la acción, sólo en los casos en que sea recuperable.

Moderaciones para VIS

En la siguiente tabla se listan las posibles moderaciones que aplican para las diferentes unidades de negocio relacionadas con vehículos e inmuebles (VIS), así como los posibles accionables y algunas recomendaciones para corregir la moderación:

Siguiente: Moderaciones con pausado.