Recursos Cross

Explora los recursos principales de nuestras APIs
circulos azuis em degrade

Documentación

Puedes usar esta documentación para las siguientes unidades de negocio:

Última actualización 19/05/2023

Calidad de fotos de moda

Importante:
Este recurso está disponible en Argentina, México, Brasil, Uruguay, Colombia, Perú, Ecuador y Chile.

Con los siguientes recursos puedes buscar productos según su estado de certificación por calidad de imágenes (CERTIFIED, NOT_CERTIFIED o UNDER_REVIEW), y conocer las condiciones para mejorar la imagen de la publicación y así lograr certificarse. Las publicaciones en status CERTIFIED aparecen en las primeras posiciones de las búsquedas de los compradores, otorgando a la publicación mejor exposición y calidad.


Requisitos para imágenes

Debes utilizar imágenes de calidad para tener un mejor posicionamiento en los listados de búsqueda según el producto:

  • Vestidos y enteritos
  • Ropa de bebés
  • Ropa interior y trajes de baño
  • Calzado
  • Tops
  • Accesorios
  • Packs
  • Bottoms
  • Conoce más recomendaciones de Moda en el Centro de Vendedores para MLA, MLM, MLB y MLC


    Buscar ítems según estado de certificación

    Para identificar si la publicación pasó los procesos de certificación de calidad deberás usar el recurso de /picture-certifier/integrator/items.
    Este recurso te permitirá realizar búsquedas por status, pudiendo identificar si las publicaciones de un vendedor se encuentran no certificadas (NOT_CERTIFIED), certificadas (CERTIFIED) o la publicación se encuentra en proceso de revisión (UNDER_REVIEW).

    Nota:
    Ten en cuenta que la llamada cuenta con parámetros obligatorios como seller_id y status al igual que parámetros opcionales como categoryId y offset / limit que en caso de no enviarse se tomarán como valores por defecto offset=0 y limit=500.

    Llamada:

    
    curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/picture-certifier/integrator/items?sellerId=$SELLER_ID&categoryId=$CATEGORY_ID&status=$STATUS&offset=0&limit=500

    Ejemplo para filtrar publicaciones no certificadas (NOT_CERTIFIED):

    
    curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/picture-certifier/integrator/items?sellerId=12345&categoryId=MLB188065&status=NOT_CERTIFIED&offset=0&limit=500

    Respuesta:

    
    {
       "seller_id": 819780659,
       "category_id": "MLB188065",
       "items": [
           "MLB2677667064",
           "MLB2677648896"
       ],
       "paging": {
           "limit": 500,
           "offset": 0,
           "total": 2
       },
       "item_status": "NOT_CERTIFIED"
    }

    Ejemplo para filtrar publicaciones certificadas (CERTIFIED):

    
    curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/picture-certifier/integrator/items?sellerId=12345&categoryId=MLB108807&status=CERTIFIED&offset=0&limit=500

    Respuesta:

    {
       "seller_id": 819780659,
       "category_id": "MLB108807",
       "items": [
           "MLB2677667080",
           "MLB2677648827"
       ],
       "paging": {
           "limit": 500,
           "offset": 0,
           "total": 2
       },
       "item_status": "CERTIFIED"
    }

    Ejemplo para filtrar publicaciones que se encuentran en proceso de revisión (UNDER_REVIEW):

    
    curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/picture-certifier/integrator/items?sellerId=12345&status=UNDER_REVIEW&offset=0&limit=500

    Respuesta:

    {
       "seller_id": 12345,
       "items": [
           "MLM1438692500",
           "MLM1438742336",
           "MLM1438692778",
           "MLM1438724478"
       ],
       "paging": {
           "limit": 500,
           "offset": 0,
           "total": 4
       },
       "item_status": "UNDER_REVIEW"
    }

    Descripción de campos

    • seller_id: id del vendedor.
    • category_id: id de la categoría consultada.
    • Items: id de las publicaciones que cumplen con el criterio de búsqueda (STATUS).
    • item_status: estado de las publicaciones en relación a validación de calidad (CERTIFIED, NOT CERTIFIED, UNDER_REVIEW).

    Cómo mejorar la imagen de un ítem

    Una vez identificadas las publicaciones con imágenes en estado NOT_CERTIFIED, puedes consultar las condiciones para lograr que el ítem cuente con imágenes de calidad certificadas.

    Llamada:

    
    curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/picture-certifier/integrator/items/$ITEM_ID/status?locale=$LOCALE&sellerId=$SELLER_ID
    Nota:
    - Los posibles valores para el parámetro locale son es_AR y pt_BR. Si no envía un valor, por default se utilizará es_AR.
    - Cuando se consulta un ítem que no pertenece a moda, se devuelve el estado WITHOUT_PROCESSING en la respuesta.

    Ejemplo de publicacion NOT_CERTIFIED:

    
    curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/picture-certifier/integrator/items/MLB2677667064/status?locale=pt_BR&sellerId=1234 

    Respuesta de publicación que no se encuentra certificada:

    Importante:
    Para el final de enero vamos a modificar la respuesta de esta API se va a omitir el arreglo conditions con los campos message, unique_intro y unique_message, los cuales se obtendrán directamente en el campo reason. Revisa tu integración y haz las modificaciones necesarias para evitar fricciones.
    
    {
        "status": "NOT_CERTIFIED",
        "reason": "Subí en los listados y vendé más corrigiendo tu primera foto
    • Tu foto tiene el fondo incorrecto. Debe ser de un color claro como blanco, gris o crema.
    • Revisá que tu foto esté bien iluminada y sin sombras que tapen tu producto.
    Cómo tomar fotos para ACCESSORIES", "conditions": [ { "id": "correct_background_acc" }, { "id": "illumination_acc" } ] }

    Descripción de campos

    • status: estado de la publicación con relación a la validación del track educativo. (CERTIFIED, NOT_CERTIFIED, UNDER_REVIEW).
    • reason: en el caso que el status sea NOT_ CERTIFIED se mostrará el motivo por el cual la publicación no cumple la validación de calidad, y las acciones que el vendedor debe realizar sobre la imágen para que el status cambie.
    • conditions: hace referencia al detalle de las condiciones por las cuales la publicación no fue certificada, para el ejemplo: correct_background_acc hace referencia a que la imagen no tiene un fondo correcto e illumination_acc no cuenta con una iluminación adecuada.