Technical information on the Brand Protection Program

This page covers all necessary information for your tools to send reports through our API. You'll be able to check the status of each of them, and reply to the sellers' counter-notices.

Contents

→Make a denounce
→Respond a denounce
→Denounce status references


Make a denounce

Make a GET request to the denounce resource to geet the reasons that you have enabled.

Request:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/moderations/pppi/denounces/$SITE_ID/ITM/options

Example:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' http://api.mercadolibre.com/moderations/pppi/denounces/MLA/ITM/options

Response OK (200):

[
   {
      "id":"PPPI2",
      "group":"PPPI",
      "type":"Product",
      "description":"Uso ilegítimo de marca registrada",
      "description_en":"Unlawful use of trademark",
      "sub_text":"Por ejemplo, dice que es mi distribuidor oficial cuando no lo es, incluye mis logos en la descripción o en las imágenes de la publicación.",
      "sub_text_en":"For example, says it is my official distributor when it is not, includes my logos in the description or in the images of the listing."
   },
   "..."
]

POST denounce

Request:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/moderations/pppi/denounces/items/$ITEM_ID

Example:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN'  https://api.mercadolibre.com/moderations/pppi/denounces/items/MLA123
body:
{   "report_reason_id":"PPPI1",
   "comment":"Comment example.",
}
Note:
If you want to make copyright complaints for images, you must indicate in the body, which are the infringing images. This will be mandatory for reporting reasons: PPPI6 and PPPI7.

Example:

curl -X POST  -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/moderations/pppi/denounces/items/MLA123
body:
{   "report_reason_id":"PPPI1",
   "comment":"Comment example.",
   "photos_denounced": [
      "666591-MLA26622267232_012016",
      "666591-MLA26622267232_012017",
      "666591-MLA26622267232_012018"
   ]
}

Response OK (200):

{
  "status": 201,
  "denounce_id": 12547408
}

Respond a denounce

Realiza la siguiente llamada GET para obtener información del estado actual de la denuncia, y poder responder.

Request:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/moderations/pppi/case/$DENOUNCE_ID

Example:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/moderations/pppi/case/123

Response OK (200):

{
  "item_info" {
    "title": ,
    "description": ,
    "price": , 
    "pictures": ,
  },
  "user_type": ,
  "reason_text": ,
  "member_name": ,
  "member_quittance": ,
  "seller_name": ,
  "seller_quittance": ,
  "document_url": ,
  "document_name": ,
  "due_date": ,
"current_status": ,
"reject_option_member": [
    {
      "sub_text_en": null,
      "text_en": "The documentation does not correspond to the reported product",
      "id": 1,
      "text_pt": "A documentação não corresponde ao produto denunciado",
      "sub_text_pt": null,
      "text_es": "La documentación no se corresponde con el producto denunciado",
      "sub_text_es": null
    },
    {
      "sub_text_en": null,
      "text_en": "The documentation is illegible",
      "id": 2,
      "text_pt": "A documentação está ilegível",
      "sub_text_pt": null,
      "text_es": "La documentación es ilegible",
      "sub_text_es": null
    },
    {
      "sub_text_en": "The documentation does not prove that they are authorized to use my brands, logos, or that they are official distributors",
      "text_en": "You are not authorized to use this content",
      "id": 3,
      "text_pt": "Não está autorizado a usar este conteúdo",
      "sub_text_pt": "A documentação não comprova que está autorizado a usar minhas marcas, logotipos ou que é um distribuidor oficial",
      "text_es": "No está autorizado a utilizar este contenido",
      "sub_text_es": "La documentación no prueba que está autorizado a usar mis marcas, logos, ni que es un distribuidor oficial"
    }
],
"photos_denounced": [
       {
           "id": "670708-MLA40946169781_022020"
           "status": "REMOVED",
           "src": "http://mla-s2-p.mlstatic.com/670708-MLA40946169781_022020.jpg"
       }
   ],
   "photos_new": [
       {
           "id": "8889-MLA26622267232_012016",
           "src": "http://mla-s2-p.mlstatic.com/670708-MLA40946169781_022020.jpg"
       },
       {
          "id": "792503-MLA40997189396_032020",
           "src": "http://mla-s2-p.mlstatic.com/792503-MLA40997189396_032020-O.jpg"
       }
   ]
}

Post a Responder la denuncia

Important:
Only cases with status DOCUMENTATION_PRESENTED will be updated, otherwise you will get an error.
Note:
To respond to the complaint and reject it, you must add within the body the reject_member_id field with the id of the rejection reason previously obtained in the GET call within the reject_option_member field.

Request:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/moderations/pppi/case/$DENOUNCE_ID
body: {
  "documentation_approved":"false" ,
  "member_quittance": ,
  "reject_member_id": "1"
}

Example approve denounce:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/moderations/pppi/case/$DENOUNCE_ID
body: {
  "documentation_approved":"true" ,
  "member_quittance": 
  }

Example refuse denounce:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/moderations/pppi/case/$DENOUNCE_ID
body: {
  "documentation_approved":"false" ,
  "member_quittance": ,
 "reject_member_id": "1"
  }

Response:

{
  "item_info" {
    "title": ,
    "description": ,
    "price": , 
    "pictures": ,
  },
  "user_type": ,
  "reason_text": ,
  "member_name": ,
  "member_quittance": ,
  "seller_name": ,
  "seller_quittance": ,
  "document_url": ,
  "document_name": ,
  "due_date": ,
"current_status": ,
"reject_option_member": [
    {
      "sub_text_en": null,
      "text_en": "The documentation does not correspond to the reported product",
      "id": 1,
      "text_pt": "A documentação não corresponde ao produto denunciado",
      "sub_text_pt": null,
      "text_es": "La documentación no se corresponde con el producto denunciado",
      "sub_text_es": null
    },
    {
      "sub_text_en": null,
      "text_en": "The documentation is illegible",
      "id": 2,
      "text_pt": "A documentação está ilegível",
      "sub_text_pt": null,
      "text_es": "La documentación es ilegible",
      "sub_text_es": null
    },
    {
      "sub_text_en": "The documentation does not prove that they are authorized to use my brands, logos, or that they are official distributors",
      "text_en": "You are not authorized to use this content",
      "id": 3,
      "text_pt": "Não está autorizado a usar este conteúdo",
      "sub_text_pt": "A documentação não comprova que está autorizado a usar minhas marcas, logotipos ou que é um distribuidor oficial",
      "text_es": "No está autorizado a utilizar este contenido",
      "sub_text_es": "La documentación no prueba que está autorizado a usar mis marcas, logos, ni que es un distribuidor oficial"
    }
],
"photos_denounced": [
       {
           "id": "670708-MLA40946169781_022020"
           "status": "REMOVED",
           "src": "http://mla-s2-p.mlstatic.com/670708-MLA40946169781_022020.jpg"
       }
   ],
   "photos_new": [
       {
           "id": "8889-MLA26622267232_012016",
           "src": "http://mla-s2-p.mlstatic.com/670708-MLA40946169781_022020.jpg"
       },
       {
          "id": "792503-MLA40997189396_032020",
           "src": "http://mla-s2-p.mlstatic.com/792503-MLA40997189396_032020-O.jpg"
       }
   ]
}

Denounce status references

A case could have any of the following status:

WAITING_DOCUMENTATION: o vendedor pode enviar sua documentação para contestar a reclamação apresentada pelo Membro. Pausaremos o item durante esse período.
DOCUMENTATION_PRESENTED: significa que o vendedor enviou a documentação e aguarda a resposta do membro. O item será pausado durante esse período.
DOCUMENTATION_NOT_PRESENTED: significa que o vendedor não enviou a documentação antes da data de vencimento. Portanto, excluímos o item.
DOCUMENTATION_APPROVED: significa que o membro aprovou a documentação. O item é publicado novamente.
DOCUMENTATION_NOT_APPROVED: significa que o membro não aprovou a documentação, portanto excluímos o item.
MEMBER_NOT_RESPOND: significa que o membro não respondeu à documentação. O item é publicado novamente.
ROLLBACK: em casos extraordinários, você solicitará o membro e poderemos publicar o item excluído anteriormente.
DISCARD_DUE_RESTRICTION: significa que encerramos o caso automaticamente porque o vendedor foi sancionado e não está ativo na plataforma.

or register to recieve the latest news about our API