Documentação do Mercado Livre
Confira todas as informações necessárias sobre as APIs Mercado Livre.Documentação do
Fashion photo quality
Images requirements
You must use quality images to have better positioning in the search listings according to the product:
Learn more about our Fashion recommendations in the Vendor Center for MLA, MLM, MLB and MLC
Search for items by certification status
To identify if the publication has been through the quality certification processes, you should use the /picture-certifier/integrator/items resource. This resource will allow you to search by "status", being able to identify whether a seller’s publications are not certified (NOT_CERTIFIED) or certified (CERTIFIED) or items that are under review (UNDER_REVIEW).
Request:
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
Example for not certified items (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
Response:
{
"seller_id": 819780659,
"category_id": "MLB188065",
"items": [
"MLB2677667064",
"MLB2677648896"
],
"paging": {
"limit": 500,
"offset": 0,
"total": 2
},
"item_status": "NOT_CERTIFIED"
}
Example for certified items (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
Response:
{
"seller_id": 819780659,
"category_id": "MLB108807",
"items": [
"MLB2677667080",
"MLB2677648827"
],
"paging": {
"limit": 500,
"offset": 0,
"total": 2
},
"item_status": "CERTIFIED"
}
Example for certified items (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
Response:
{
"seller_id": 819780659,
"category_id": "MLB108807",
"items": [
"MLB2677667080",
"MLB2677648827"
],
"paging": {
"limit": 500,
"offset": 0,
"total": 2
},
"item_status": "CERTIFIED"
}
Example for under review items (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
Response:
{
"seller_id": 12345,
"items": [
"MLM1438692500",
"MLM1438742336",
"MLM1438692778",
"MLM1438724478"
],
"paging": {
"limit": 500,
"offset": 0,
"total": 4
},
"item_status": "UNDER_REVIEW"
}
Fields description
- seller_id: id of the seller.
- category_id: id of the consulted category.
- Items: id of the publications that meet the search criteria (STATUS).
- item_status: status of the publications with quality validation (CERTIFIED, NOT CERTIFIED, UNDER_REVIEW).
How to improve the item's images
Once you have identified the publications with NOT CERTIFIED images, you can check the conditions to get the item to have certified quality images.
Request:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN'
https://api.mercadolibre.com/picture-certifier/integrator/items/$ITEM_ID/status?locale=$LOCALE&sellerId=$SELLER_ID
Example:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/picture-certifier/integrator/items/MLB2677667064/status?locale=pt_BR&sellerId=1234
Response for publications that are not certified:
{
"status": "NOT_CERTIFIED",
"reason": "Seu anúncio de moda não está bem apresentado
A primeira foto do seu anúncio deve ser com um modelo, manequim invisível ou somente do produto, conforme os requisitos do seu tipo de roupa.
Como tirar fotos para moda",
"conditions": [
{
"id": "presentation_badly_pres",
"message": "Você deve usar um modelo, manequim invisível ou mostrar o produto sozinho, de acordo com o tipo de peça.",
"unique_intro": "Seu anúncio de moda não está bem apresentado",
"unique_message": "A primeira foto do seu anúncio deve ser com um modelo, manequim invisível ou somente do produto, conforme os requisitos do seu tipo de roupa."
}
]
}
Field 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 publication does not comply to 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 publication was not certified, for the example: correct_background_acc means that the image does not have a correct background and illumination_acc does not have an adequate illumination.