Moderaciones

Con el recurso /infractions accedes a información relacionada con las infracciones detectadas en cualquiera de los elementos publicados (ítems, preguntas, respuestas y opinión del producto). Conoce más sobre las políticas de publicación de Mercado Libre (Argentina, Brasil, México, Chile, Colombia y Uruguay).

Contenidos

→Consultar moderaciones de un usuario
→Filtrar moderaciones
    ↳Filtros disponibles
→Consultar moderación de imágenes
    ↳Errores
    ↳Cómo mejorar imagen
→Agregar tag poor_quality_thumbnail en el ítem de prueba

Consultar moderaciones de un usuario

Las moderaciones de un vendedor pueden afectar:

  • ítems
  • preguntas o respuestas (questions)
  • opinión del producto (review)

Te recomendamos identificar la razón (reason) y solución (remedy) para aplicar en el idioma correspondiente al sitio de la infracción o en inglés, y además, puedes identificar y sumarizar las moderaciones por publicaciones mal categorizadas.
Llamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/moderations/infractions/$USER_ID

Ejemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/moderations/infractions/12345678

Respuesta:

{
    "infractions": [
       {
           "id": "1025647",
           "date_created": "2016-11-12T18:28:03.731Z",
           "user_id": "6540387",
           "related_item_id": "MLA642576340",
           "element_id": "MLA642576340",
           "element_type": "ITM",
           "site_id": "MLA",
           "filter_subgroup": "LINKS",
           "reason": "Tuvimos que borrar tu publicación porque ofrecías un producto que está prohibido por nuestra Política de Autopartes y repuestos.",
           "remedy": "Recuerda que las autopartes y repuestos usados están regulados por las leyes 25761, 24449 y sus decretos reglamentarios.

Si deseas obtener más información puedes consultar el sitio de DNRPA" }, ], "paging": { "offset": 0, "limit": 20, "total": 7 }, "sorting_type": "date_created_desc" }

Respuesta por mala categorización (subgroup: DOMAIN):

{
    "infractions": [
        {
            "id": "803871756",
            "date_created": "2021-07-26T14:01:04.198-0400",
            "user_id": "743702276",
            "related_item_id": "MLA924367822",
            "element_id": "MLA924367822",
            "element_type": "ITM",
            “subgroup” : “DOMAIN”,
            "site_id": "MLA",
            "reason": "La anulamos porque después de analizar las fotos y el título, detectamos que no coinciden con la categoría.",
            "remedy": "Anulamos tu publicación. Lo hicimos porque la categoría en la que publicaste no era la apropiada. Vuelve a publicar el producto en la categoría correcta.",
            "suggested": {
                "domain": "AUTOMOTIVE_EMBLEMS",
                "categories": [
                    {
                        "id": "MLB22714",
                        "name": "Emblemas",
                        "path": "Acessórios para Veículos > Peças de Carros e Caminhonetes      > Peças de Exterior > Emblemas"
                    },
                    {
                        "id": "MLB412408",
                        "name": "Insignias",
                        "path": "Acessórios para Veículos > Acessórios para Caminhões > Cabine > Insignias"
                    }
                ]
   }
        }
    ],
        "paging": {
        "offset": 0,
        "limit": 20,
        "total": 7
    },
    "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/opinión de productos).
subgroup: este campo te permite identificar, agrupar y resumir (sumarizar) las infracciones pertenecientes a los distintos grupos de filtros. Por ejemplo, DOMAIN refiere a que moderación por mala categorización; PQT; LINKS; CLASI.
site_id: sitio del marketplace del elemento que tiene la infracción.
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. Por ejemplo, “Quitar los datos personales de una publicación”.
suggested: (optional) incluye el dominio y la/s categoría/s sugerida/s en caso de que el campo “subgroup” sea DOMAIN. Con esta información, el vendedor puede conocer la o las categorías sugeridas en caso de que la infracción sea por publicación mal categorizada.


Notas:
- Eliminamos los campos current_status y sub_status de la respuesta. Para obtener el estado actual del ítem, debes consultar el recurso /items.
- En la respuesta no se verán los ítems dados de baja por duplicados y solo aparecen los ítems en el cual los estados pueden ser finales (forbidden) o temporales (waiting_for_patch, held, pending_documentation).
Si quieres consultar si un usuario está suspendido puedes hacerlo a través de users y chequear el campo status: list: allow. En caso que sea false ese campo, significa que está suspendido.
Importante:
En caso de que el usuario esté suspendido, deberá consultar la configuración de su cuenta en el portal de Ayuda.


Filtrar moderaciones

Filtros disponibles

Filtro Descripción Opciones Default
related_item_id Id de la publicación asociado 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 inglés, además del idioma por default del país donde el elemento esté publicado EN El idioma oficial del país donde esté publicado el elemento moderado, Portugués (para Brasil) y Español (para hispanos)
limit Cantidad de infracciones devueltas El valor es de 1 a 20 20
offset Offset para el paginado 0
sort Ordenar los resultados por fecha de creación de manera ascendente o descendente date_created_asc, date_created_desc date_created_desc

Llamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/moderations/infractions/$USER_ID?date_created_since=AAAA-MM-DD&limit=XX&offset=X

Ejemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/moderations/infractions/12345678?date_created_since=2020-12-15&limit=1&offset=0

Respuesta:

{
   "infractions": [
       {
           "id": "594794188",
           "date_created": "2020-10-28T01:43:32.414-0400",
           "user_id": "12345678",
           "related_item_id": "MLA169211231",
           "element_id": "MLA169211232",
           "element_type": "ITM",
           "site_id": "MLA",
           "reason": "La anulamos porque la categoría en elegiste no corresponde con tu foto de portada o título.",
           "remedy": "Modifica la categoría de tu publicación para que se corresponda con tu título y foto de portada."
       }],
   "paging": {
       "offset": 0,
       "limit": 1,
       "total": 20671
   },
   "sorting_type": "date_created_desc"
}

Consultar moderación de imágenes

Los ítems con el tag poor_quality_thumbnail fueron validados por Mercado Libre y no cumplen algún requisito de imagen. Identifica estas publicaciones con imágenes de baja calidad para mejorarlas. Conoce más sobre el recurso Búsqueda de ítems y la importancia de las fotos para los vendedores.


Llamada:

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

Respuesta:

{
    "itemID": "MLA0111111",
    "quality": "good",
    "thumbnail": "344725-MLA25503040734_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"
}

Campos de la respuesta

itemID: ID de la publicación.
quality: calidad de imagen, puede tomar los valores “good” ó “poor”, definiendo los estados de “buena imagen” o “mala imagen” respectivamente.
thumbnail: es la imagen por la cual se procesó el ítem, corresponde a la thumbnail del ítem.
conditions: son un conjunto de condiciones por las que pasa un ítem para determinar su calidad de imagen. Una condición está formada por su ID (dando una definición corta de que analiza) y su atributo de passed, un valor booleano definiendo si la imagen cumplió la condición o no.
taggedDate: fecha del último procesamiento realizado sobre el ítem.


Posibles ID de Condiciones

minimum_size: Esta validación evalúa si alguna de las imágenes de la publicación supera el mínimo de 500 x 500 px.
logo_text_watermark: Esta validación evalúa si la primera imagen de la publicación contiene logos, texto, banners promocionales o marcas de agua.
white_background: Esta validación evalúa si la primera imagen de la publicación tiene fondo blanco puro. Es decir, fondo blanco creado con un editor de imágenes, en lugar de una foto de producto frente a una pared u otro elemento.
multiproduct: Esta validación evalúa si la primera imagen contiene más de un producto. Por ejemplo, no permitimos que la primera imagen de la publicación contenga varios pares de zapatillas.
blur: Esta validación evalúa que las imágenes de la publicación no sean borrosas.
unprofessional_photo: Esta validación se ejecuta cuando el resto de las validaciones da negativo. Evalúa tres condiciones a la vez: multiproducto, fondo blanco y logos. No significa que la imagen cumpla las tres, sino que puede no estar cumpliendo con alguna de las tres.
rollbacked: Esta validación es reservada para el equipo de atención al cliente. La utilizamos cuando un vendedor se contacta para reclamar por detecciones incorrectas (falso positivo). Una vez aplicada, la foto no se vuelve a moderar, excepto que el vendedor cambie la imagen.


Errores

En caso de recibir un error 404 - “No picture tagged for item (Item_id)” debido a que el ítem no pudo ser validado, te recomendamos mejorar la imagen con el siguiente recurso.


Cómo mejorar imagen

Llamada:

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

Respuesta:

{
  "reason": "Para recuperar tu exposición, corregí tus fotos
  • Asegurate de que la primera imagen de tu producto tenga como mínimo 500 píxeles en uno de los lados. Te recomendamos usar 1200 x 1200, para que puedan hacer zoom.
", "conditions": [ { "id": "sizePictures", "message": "Asegurate de que la primera imagen de tu producto tenga como mínimo 500 píxeles en uno de los lados. Te recomendamos usar 1200 x 1200, para que puedan hacer zoom." } ] }
Nota:
Cuando corrijas la imagen de una publicación que haya sido moderada se efectuaran nuevamente las validaciones sobre la misma, y en caso de ser positivas, se eliminará el tag, y recuperara su exposición original.

Conoce más sobre cómo trabajar con imágenes.


Agregar tag poor_quality_thumbnail en el ítem de prueba

Para añadir el tag "poor_quality_thumbnail" a un ítem de prueba, cargue los datos de su usuario de test en el formulario.

o regístrate para recibir las últimas novedades sobre nuestra API