Recommendations for photo quality

Requirements for photos

You must follow photo quality to have better positioning in the search listings according to the product:

• Dresses and jumpsuits
• Baby clothes
• Underwear
• Footwear
• Tops
• Accessories
• Packs
• Bottoms

Search for items by certification status

To identify if the listing has been through the quality certification process, you should use the /picture-certifier/integrator/items resource. This resource will allow you to search by status, being able to identify whether the seller’s listings photos are not certified (NOT_CERTIFIED) or certified (CERTIFIED), or are photos that are under review (UNDER_REVIEW).

Parameters

status (mandatory): CERTIFIED, NOT_CERTIFIED or UNDER_REVIEW

offset/limit (optional): if not sent will be taken as default values: offset=0 and limit=500

Request:

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

Example to filter listings with not certified photos (NOT_CERTIFIED):

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

Response:

{
    "seller_id": 1161434913,
    "items": [
        "MLB2800501862",
        "MLB3000974505",
        "MLB2800527833",
        "MLB2800924079"
    ],
    "paging": {
        "limit": 500,
        "offset": 0,
        "total": 4
    },
    "item_status": "NOT_CERTIFIED"
}

Example to filter listings with certified photos (CERTIFIED):

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

Response:

{
   "seller_id": 1161434913,
   "items": [
       "MLB2800566822",
       "MLB2730802100"
   ],
   "paging": {
       "limit": 500,
       "offset": 0,
       "total": 2
   },
   "item_status": "CERTIFIED"
}

Example to filter listings with photos that are found in the review process (UNDER_REVIEW):

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

Response:

{
   "seller_id": 1161434913,
   "items": [
       "MLB3153308508"
   ],
   "paging": {
       "limit": 500,
       "offset": 0,
       "total": 1
   },
   "item_status": "UNDER_REVIEW"
}

Fields description

• seller_id: id of the seller.
• Items: id of the listings that meet the search criteria (STATUS).
• item_status: status of the listings with quality validation (CERTIFIED, NOT CERTIFIED, UNDER_REVIEW).

How to improve the item's photos

Once you have identified the listings with NOT CERTIFIED photos, you can check the conditions to get the item to have certified quality photos.

Request:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/picture-certifier/integrator/items/status/$ITEM_ID?locale=en_US

If you consult an item that does not belong to fashion, you will receive WITHOUT_PROCESSING status in the response.

Example:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/picture-certifier/integrator/items/status/MLB3148570001?locale=en_US

Response for listings with not certified photos:

{
    "status": "NOT_CERTIFIED",
    "reason": "Correct the problems in your first photo to stand out in the search results and sell more:
Make sure the shoes are clean and with the laces correctly placed.
The product must not appear cut off or touching the borders of the image.
Use a white, beige or light gray background, without different tones or textures, highlighting the product.
How to take pictures for FOOTWEAR",
    "conditions": [
        {
            "id": "clean_product_foot"
        },
        {
            "id": "complete_product_foot"
        },
        {
            "id": "right_orientation_foot"
        },
        {
            "id": "correct_background_foot"
        }
    ]
}

Fields description

• status: status of the publication with regard to the validation of the educational track. (CERTIFIED, NOT_ CERTIFIED, UNDER_REVIEW).
• reason: if the status is NOT_ CERTIFIED, it shows the reason why the listing does not comply with the quality validation and the actions that the seller must do on the image to change the status.
• conditions: refers to the detail of the conditions for which the listing was not certified, for example: correct_background_acc means that the image does not have a correct background and illumination_acc that it does not have an adequate illumination.