Documentación Mercado Libre

Descubre toda la información que debes conocer sobre las APIs de Mercado Libre.
circulos azuis em degrade

Documentación

Última actualización 19/02/2024

Moderaciones de imágenes

Actualmente las moderaciones por mala calidad de imágenes pueden estar bajo el status active o paused y tener el tag poor_quality_thumbnail. Conoce recomendaciones para sacar buenas fotos de Productos, Moda, Vehículos, Inmuebles y Servicios.


Flujo recomendado

  1. Valida el flujo de carga de imágenes de los ítems. Es importante que utilices el endpoint https://api.mercadolibre.com/pictures/items/upload que te permite subir imágenes y validar su calidad.
  2. Asegúrate que las imágenes no contengan infracciones y luego sean publicaciones moderadas, utiliza el endpoint https://api.mercadolibre.com/moderations/infractions/USER_ID?related_item_id=ITEM_ID.
  3. Identifica los picture_id afectados para reactivar las publicaciones.


  4. Consultar items con moderación de imágenes

    Para obtener los items con moderación de imágenes debes filtrar aquellos items activos y con tag poor_quality_thumbnail.


    Nota:
    Para añadir el tag "poor_quality_thumbnail" a un ítem de prueba, cargue los datos de su usuario de test en el soporte por site: Argentina, México, Chile, Bolivia, Colombia, Costa Rica, , República dominicana, Ecuador, Uruguay, Perú.

    Ejemplo:

    curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/288230145/items/search?status=active&tags=poor_quality_thumbnail

    Respuesta:

    {
        "seller_id": "288230145",
        "results": [
            "MLA1352323391",
            "MLA1352071928"
        ],
        "paging": {…},
        "query": null,
        "orders": [...],
        "available_orders": [...]
    }

    Consultar moderación de imagen

    Ejemplo:

    curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/moderations/infractions/453616000?related_item_id=MLA1259572000

    Respuesta:

    {
      "infractions": [
          {
              "id": "1083677517",
              "date_created": "2022-12-21T10:26:46.769-0400",
              "user_id": "453616333",
              "related_item_id": "MLA1259572000",
              "element_id": "MLA1259572000",
              "element_type": "ITM",
              "site_id": "MLA",
              "filter_subgroup": "PQT",
              "reason": "Tu foto de portada no tiene fondo blanco puro. Corregila para recuperar exposición.",
              "remedy": "Para recuperar tu exposición, corrige el fondo de tu foto de portada
    El fondo de tu foto debe ser blanco puro, ¡no uses texturas o elementos de fondo!" } ], "paging": { "offset": 0, "limit": 20, "total": 1 }, "sorting_type": "date_created_desc" }

    Consultar imágenes internas con infracciones

    Identifica dentro del array pictures, las imágenes internas de un producto (picture_ids) que tengan infracciones asociadas como tamaño mínimo, contenido fuera de producto y marca de agua.


    Respuesta:

    {
        "infractions": [
            {
                "id": "1795592950",
                "date_created": "2024-01-11T14:12:15.39-0400",
                "user_id": "453616456",
                "related_item_id": "MLA1406316738",
                "element_id": "MLA1406316738",
                "element_type": "ITM",
                "site_id": "MLA",
                "filter_subgroup": "FOTOS",
                "reason": "Tenés fotos que no corresponden al artículo. Eliminalas para volver a vender en Mercado Libre.",
                "remedy": "Tienes fotos por corregir. Elimina las fotos que no corresponden al artículo para reactivar tu publicación y seguir vendiendo en Mercado Libre.",
                "pictures": [
                    {
                        "variation_id": 177567886682,
                        "picture_ids": [
                            "767821-MLA52339658483_112022",
                            "689381-MLA52339658484_112022"
                        ]
                    }
                ]
            },
            {...}
        ],
        "paging": {
            "offset": 0,
            "limit": 20,
            "total": 19
        },
        "sorting_type": "date_created_desc"
    }

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