Documentation Mercado Libre

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

Documentation

Last update 20/02/2024

Official Stores

Some selected users are part of Mercado Libre Official Stores, and have one or more brands under the same user. If you want to become part of Mercado Libre Official Stores, you’ll have to communicate with a commercial adviser. If you’re part of Official Stores already, follow this tutorial to learn the basics of how to work with this user type.


Obtain your brands

This resource retrieves brands associated with an user_id. There can be more than one per user. The official_store_id attribute identifies a store.
Request:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/$USER_ID/brands

Example:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/470225786/brands

Response:

{
   "official_store_id":2572,
   "site_id":"MLM",
   "name":"Hyiear",
   "fantasy_name":"Hyiear",
   "type":"normal",
   "status":"active",
   "permalink":"https://tienda.mercadolibre.com.mx/hyiear",
   "date_created":"2020-01-14T17:51:22Z",
   "relevance_position":10000,
   "main_categories":[
      {
         "id":"MLM1575"
      }
   ],
   "pictures":[
      {
         "id":88531,
         "name":"logo",
         "secure_url":"https://http2.mlstatic.com/resources/largesellers/470225786/hyiear/logo202001130546.jpg",
         "url":"https://http2.mlstatic.com/resources/largesellers/470225786/hyiear/logo202001130546.jpg",
         "size":"160x80"
      },
      {
         "id":88532,
         "name":"logo_landing",
         "secure_url":"https://http2.mlstatic.com/resources/largesellers/470225786/hyiear/logo_landing202001130546.jpg",
         "url":"https://http2.mlstatic.com/resources/largesellers/470225786/hyiear/logo_landing202001130546.jpg",
         "size":"160x80"
      },
      {
         "id":88533,
         "name":"background",
         "secure_url":"https://http2.mlstatic.com/resources/largesellers/470225786/hyiear/background202001130546.jpg",
         "url":"https://http2.mlstatic.com/resources/largesellers/470225786/hyiear/background202001130546.jpg",
         "size":"1600x750"
      },
      {
         "id":88534,
         "name":"background_home",
         "secure_url":"https://http2.mlstatic.com/resources/largesellers/470225786/hyiear/background_home202001130547.jpg",
         "url":"https://http2.mlstatic.com/resources/largesellers/470225786/hyiear/background_home202001130547.jpg",
         "size":"780x190"
      },
      {
         "id":88535,
         "name":"small_logo",
         "secure_url":"https://http2.mlstatic.com/resources/largesellers/470225786/hyiear/small_logo202001130547.jpg",
         "url":"https://http2.mlstatic.com/resources/largesellers/470225786/hyiear/small_logo202001130547.jpg",
         "size":"96x70"
      },
      {
         "id":88536,
         "name":"big_logo",
         "secure_url":"https://http2.mlstatic.com/resources/largesellers/470225786/hyiear/big_logo202001130547.jpg",
         "url":"https://http2.mlstatic.com/resources/largesellers/470225786/hyiear/big_logo202001130547.jpg",
         "size":"174x164"
      },
      {
         "id":88537,
         "name":"facebook_logo",
         "secure_url":"https://http2.mlstatic.com/resources/largesellers/470225786/hyiear/facebook_logo202001130546.jpg",
         "url":"https://http2.mlstatic.com/resources/largesellers/470225786/hyiear/facebook_logo202001130546.jpg",
         "size":"200x200"
      },
      {
         "id":88538,
         "name":"high_resolution_logo",
         "secure_url":"https://http2.mlstatic.com/resources/largesellers/470225786/hyiear/high_resolution_logo202001130547.jpg",
         "url":"https://http2.mlstatic.com/resources/largesellers/470225786/hyiear/high_resolution_logo202001130547.jpg",
         "size":"1024x747"
      },
      {
         "id":88539,
         "name":"dynamic_logo",
         "secure_url":"https://http2.mlstatic.com/D_Q_NP_842479-MLA40418375094_012020-F.jpg",
         "url":"http://mla-s1-p.mlstatic.com/842479-MLA40418375094_012020-F.jpg",
         "size":"1024x747"
      }
   ],
   "tags":[

   ],
   "categories_ids":[
      "MLM1575"
   ],
   "return_policy":null,
   "landing_permalink":"https://tienda.mercadolibre.com.mx/xiaomi",
    "normalized_name": "xiaomi",
   "last_updated": "2023-12-01T00:00:00Z"

   "users":[
      {
         "status": "LINKED"
         "cust_id":470225786,
         "site_id":"MLM",
         "user_type":"brand",
         "tags":[
            "brand",
            "large_seller"
         ]
      }
   ]
}

Response fields

  • status: will have the user's status with respect to the store.
  • normalized_name: will have the normalized store name (without accent marks, double spaces, umlauts, etc.)
  • last_updated: date the store was last updated.

Errors that may occur in the previous resource:

curl -X GET https://api.mercadolibre.com/users/14775362261111111/brands
{
   "error": "U00002",
   "message": "U00002 - The user '14775362261111111' was not found",
   "status": 404
}

Obtain all information about a specific brand

To get information about a specific brand, you can make the call to the brand_id you want to know about like in the example that follows:
Request:

curl -X GET https://api.mercadolibre.com/users/$USER_ID/brands/$BRAND_ID

Example:

curl -X GET https://api.mercadolibre.com/users/470225786/brands/2572

Response:

{
  "official_store_id": 2572,
  "site_id": "MLM",
  "name": "Hyiear",
  "fantasy_name": "Hyiear",
  "type": "normal",
  "status": "active",
  "permalink": "https://tienda.mercadolibre.com.mx/hyiear",
  "date_created": "2020-01-14T17:51:22Z",
  "relevance_position": 10000,
  "main_categories": [],
  "pictures": [],
  "tags": [
  ],
  "categories_ids": [],
  "return_policy": null,
  "landing_permalink": null,
  "users": [
  {  
         "status": "LINKED"
         "cust_id":470225786,
         "site_id":"MLM",
         "user_type":"brand",
         "tags":[
            "brand",
            "large_seller"
         ]
      }

]
}

Errors that may occur in the previous resource:

Request:

curl -X GET https://api.mercadolibre.com/users/1477536226/brands/aaaaa

Response:

{
  "error": "invalid_parameter",
  "message": "The officialStoreId must contain only digits.",
  "status": 400
}

Request:

curl -X GET https://api.mercadolibre.com/users/1477536226/brands/14501111111

Response:

{
   "error": "B00001",
   "message": "B00001 - The brand '14501111111' was not found for site 'MLA'",
   "status": 404
}

Common errors in the API response while listing on multi-brand Official Stores

If you don’t send the official_store_id of the item for a multi-brand Official Store, you’ll get as response the possible IDs you could send with your user:

"message": "Validation error",
   "error": "validation_error",
   "status": 400,
   "cause": [{
   	"code": "item.official_store_id.invalid",
   	"message": "Users type brand have to provide one of this [60, 274, 257] official store id"

If you send an invalid official_store_id for a multibrand Official Store you’ll get:

{
   "message": "body.invalid_official_store_id",
   "error": "The seller 148829068 is not allowed to use official_store_id 315 on site MLA.",
   "status": 403,
   "cause": []
}

Great! You already know the brand_id associated to your user to send every time you want to list an item.