Documentation Mercado Libre

Check out all the necessary information about APIs Mercado Libre.
circulos azuis em degrade

Documentation

Last update 21/07/2025

Image moderations

Listings may be moderated due to image quality issues. These moderations can appear with the status active or paused and the tag poor_quality_thumbnail.
Find recommendations for taking good photos of Products, Fashion, Vehicles, Real Estate and Services.



  1. Use the Image Diagnostics API for base64 images, picture_id (for photos already in Meli's CDN) and URL
  2. To upload images to Meli's CDN, you can use the endpoint https://api.mercadolibre.com/pictures/items/upload.


Consult items with image moderation

Call:

curl -L -X GET -H 'Authorization: Bearer $ACCESS_TOKEN'
'https://api.mercadolibre.com/moderations/last_moderation/$MODERATION_REFERENCE_ID'
Note:
To understand how to get MODERATION_REFERENCE_ID, you can see it in the ‘Manage Moderations’ section

Response examples:

Watermark

[
  {
    "name": "WATERMARK",
    "id": "7123400333",
    "date_created": "2022-03-22 09:08:06.0",
    "wordings": [
      {
        "type": "REASON",
        "value": "The cover photo contains watermarks. Fix it to recover exposure."
      },
      {
        "type": "REMEDY",
        "value": "Fix your cover photos. Remove your photos that contain watermarks."
      }
    ],
    "evidence": [
      {
        "text_matched": "623362-MLA31659909568_082019",
        "section_name": "pictures"
      }
    ]
  }
]

Multiple per photos:

[
  {
    "name": "MULTIPLE",
    "id": "7123400444",
    "date_created": "2025-04-30 14:45:59.0",
    "wordings": [
      {
        "type": "REASON",
        "value": "Some cover photos do not meet our photo requirements."
      },
      {
        "type": "REMEDY",
        "value": "Fix your photos: The product must be well lit. You can fix it with our editor. You'll find access in the pencil button, on the photo you want to modify. Your product should not be cut off or touch the edges of the image. Remove your photos that contain watermarks."
      }
    ],
    "evidence": [
      {
        "text_matched": "785537-MLU84244573037_042025",
        "section_name": "pictures"
      }
    ]
  }
]
[
  {
    "name": "MULTIPLE",
    "id": "7123400555",
    "date_created": "2022-06-18 13:21:35.0",
    "wordings": [
      {
        "type": "REASON",
        "value": "Some cover photos do not meet our photo requirements."
      },
      {
        "type": "REMEDY",
        "value": "Fix your photos: Remove your photos that contain watermarks. Remove your photos that contain logos and/or texts."
      }
    ],
    "evidence": [
      {
        "text_matched": "947645-MLA47645285814_092021",
        "section_name": "pictures"
      },
      {
        "text_matched": "835521-MLA47645265981_092021",
        "section_name": "pictures"
      }
    ]
  }
]

Learn more about how to work with images.