Documentação do Mercado Livre

Confira todas as informações necessárias sobre as APIs Mercado Livre.
circulos azuis em degrade

Documentação do

Última atualização em 15/03/2023

Members of the Program

Importante:
This functionality can only be used by those who are Members of the Brand Protection Program. If you are not, you can join as a Member of the Program.

With the following APIs, the BPP invites rights holders, or their legal representatives, to protect their entire portfolio of intellectual property rights by reporting any publication that is alleged to infringe their intellectual property rights.


Consult enabled motives

Find out which motives you are enabled to report as a Member.


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' https://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."
   },
   "..."
]

Make a complaint


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 -d
{
  "report_reason_id": "PPPI1",
  "comment": "Comment example.",
}

If you want to make copyright claims for images, you must indicate in the body which images are the infringing ones. This will be required for reporting reasons PPPI4, PPPI6, PPPI7, PPPI17. You can get the IDs of the infringing images API from /items, in the pictures attribute..


curl -X POST  -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/moderations/pppi/denounces/items/MLA123 -d
{   "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
}


Check a complaint status

Get information on the current status of the complaint and then respond to the seller you have reported.


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": < string | null >,
    "price": < number | null >, 
    "pictures": < array[object: "url":  ] >,
  },
  "user_type": < string(seller|member) >,
  "reason_text": ,
  "member_name": ,
  "member_quittance": < string | null >,
  "seller_name": ,
  "seller_quittance": < string | null >,
  "document_url": < string | null >,
  "document_name": < string | null >,
  "due_date": ,
"current_status": < string(WAITING_DOCUMENTATION|DOCUMENTATION_PRESENTED|DOCUMENTATION_NOT_PRESENTED|DOCUMENTATION_APPROVED|DOCUMENTATION_NOT_APPROVED|MEMBER_NOT_RESPOND|ROLLBACK|DISCARD_DUE_RESTRICTION) >,
"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"
       }
   ]
}

Respond to a seller's

Once you make a complaint as a Program Member, the seller has 4 days to respond with documentation and then you will have 4 calendar days to respond to the seller.


  • If you do not respond within the time limit, the seller's reported publication will be reactivated.
  • To reply rejecting the seller's response, you must add inside the body the field reject_member_id with the id of the rejection reason previously obtained in the GET request inside the field reject_option_member.

Note:
You can only respond to cases with DOCUMENTATION_PRESENTED status.

Request:

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

Example to approve a complaint:


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

Example to reject a complaint:

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

Response:

{
  "item_info" {
    "title": ,
    "description": < string |null >,
    "price": < number | null >, 
    "pictures": < array[object: "url":  ] >,
  },
  "user_type": < string(seller|member) >,
  "reason_text": ,
  "member_name": ,
  "member_quittance": < string | null >,
  "seller_name": ,
  "seller_quittance": < string |null >,
  "document_url": < string |null >,
  "document_name": < string |null >,
  "due_date": ,
"current_status": < string(WAITING_DOCUMENTATION|DOCUMENTATION_PRESENTED|DOCUMENTATION_NOT_PRESENTED|DOCUMENTATION_APPROVED|DOCUMENTATION_NOT_APPROVED|MEMBER_NOT_RESPOND|ROLLBACK|DISCARD_DUE_RESTRICTION) >,
"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"
       }
   ]
}

Next: Get to know the complaint status.