Recursos Cross

Confira os principais recursos das nossas APIs
circulos azuis em degrade

Documentação do

Você pode usar esta documentação para as seguintes unidades de negócio:

Última atualização em 07/08/2023

Qualidade de fotografia de moda

Importante:
Este recurso está disponível para o México, Argentina, Brasil e Chile.

Com os seguintes recursos você pode pesquisar produtos de acordo com seu status de certificação por qualidade de imagens (CERTIFIED, NOT_CERTIFIED ou UNDER_REVIEW), e conhecer as condições para melhorar a imagem da publicação e assim conseguir se certificar. As publicações com status CERTIFIED aparecem nas primeiras posições das buscas dos compradores, dando a publicação melhor exposição e qualidade.

Requisitos para imagens

Você deve usar imagens de qualidade para ter uma melhor posicionamento nas listagens de busca conforme o produto:

Saiba mais recomendações de Moda no Central de Vendedores para MLA, MLM, MLB e MLC


Buscar publicações por status de certificação

Para identificar se a publicação passou os processos de certificação de qualidade deverá usar o recurso /picture-certifier/integrator/items..
Este recurso permitirá realizar buscas por status, podendo identificar se as publicações de um vendedor estão não certificadas (NOT_CERTIFIED), ou certificadas (CERTIFIED) ou itens que se encontram em processo de revisão (UNDER_REVIEW).

Nota:
Se a chamada conta com parâmetros obrigatórios como seller_id e status ou parâmetros opcionais como categoryId e offset / limit caso não sejam enviados serão completados com valores por default: offset=0 e limit=500.

Chamada:

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

Resposta de itens não certificados (NOT_CERTIFIED):

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

Resposta:

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

Exemplo para filtrar publicações 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

Resposta:

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

Exemplo para filtrar publicações que estão em processo de revisão (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

Resposta:

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

Descrição dos campos

  • seller_id: id do vendedor.
  • category_id: id da categoria consultada.
  • Items: id das publicações que cumprem os critérios de busca (STATUS).
  • item_status: estado das publicações com relação à validação de qualidade (CERTIFIED, NOT CERTIFIED, UNDER_REVIEW).

Como melhorar a imagem do item

Uma vez identificados os anúncios com imagens em estado NOT CERTIFIED poderá consultar as condições para conseguir que o item tenha imagens de qualidade certificadas.


Chamada:

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:
  • Os valores possíveis para o parâmetro local são en_US, es_419, es_AR e pt_BR. Se não enviar um valor diferente, por default será utilizado es_AR.
  • Quando consultar um item que não pertence à moda, receberá WITHOUT_PROCESSING na resposta.

  • Exemplo:

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

    Resposta de anúncio que não está certificado:

    Importante:
    Para o final de janeiro vamos modificar a resposta desta API, omitindo o arranjo conditions com os campos message, unique_intro e unique_message, os quais serão obtidos diretamente no campo reason. Revise sua integração e faça as modificações necessárias para evitar erros.
    {
       "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." } ] }

    Descrição de campos

    • status: estado da publicação com relação à validação do track educativo. (CERTIFIED, NOT_ CERTIFIED, UNDER_REVIEW).
    • reason: caso o status seja NOT_ CERTIFIED será apresentado o motivo pelo qual a publicação não cumpre a validação de qualidade e as ações que o vendedor deve realizar sobre a imagem para que o status mude.
    • conditions: refere-se ao detalhe das condições pelas quais a publicação não foi certificada, para o exemplo: correct_background_acc quer dizer que a imagem não tem um fundo correto e illumination_acc não conta com uma iluminação adequada.