Official Stores

ID de marcas

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

Request:

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

Example:

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

Response:

{
   "status": "LINKED",
   "cust_id": 1477536226,
   "site_id": "MLA",
   "user_type": "brand",
   "brands": [
       {
           "site_id": "MLA",
           "official_store_id": 1450,
           "name": "Nike",
           "type": "brand",
           "relevance_position": 10000,
           "status": "active",
           "fantasy_name": "Nike",
           "date_created": "2018-04-26T13:30:28Z",
           "return_policy": null,
           "landing_permalink": "https://www.mercadolibre.com.ar/tienda/nike",
           "pictures": [
               {},
                   "size": "160x80"
               {},
                   "size": "160x80"
               {},
                   "size": "1600x250"
               {},
                   "size": "96x70"
              {},
                   "size": "174x164"
               {},
                   "size": "200x200"
               {},
                   "size": "1024x747"
               },
               {},
           "tags": [
               "TOP_BRAND"
           ],
           "categories_ids": [
               "MLA1276"
           ],
           "main_categories": [
               {
                   "id": "MLA1276"
               }
           ],
           "permalink": "https://tienda.mercadolibre.com.ar/nike",
           "normalized_name": "nike",
           "last_updated": "2023-12-12T19:28:34Z"
       }
   ],
   "tags": [
       "large_seller",
       "messages_as_seller",
       "brand"
   ]
}

Response fields

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

Error that can happen 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:
Example:

curl -X GET https://api.mercadolibre.com/users/58715193/brands/133

Response:

{
  "tags": [
	"home",
	"standout"
  ],
  "official_store_id": 133,
  "categories_ids": [
	"MLA1403"
  ],
  "fantasy_name": "Bodega Lanzarini",
  "users": [
	{
  	"cust_id": 58715193,
  	"tags": [
    	"eshop",
    	"large_seller",
    	"user_info_verified",
    	"brand"
  	],
  	"site_id": "MLA",
  	"user_type": "brand"
	}
  ],
  "site_id": "MLA",
  "status": "active",
  "name": "Bodega Lanzarini",
  "date_created": "2014-08-04T04:00:00.000Z",
  "pictures": [
	{
  	"id": 632,
  	"name": "big_logo",
  	"secure_url": null,
  	"url": "http://static.mlstatic.com/org-img/apparel/images/bodegalanzarini/58715193-logo-g.jpg",
  	"size": "174x164"
	},
	{
  	"id": 2474,
  	"name": "facebook_logo",
  	"secure_url": null,
  	"url": "http://static.mlstatic.com/org-img/apparel/images/mla-fb/58715193-logo-fb.jpg",
  	"size": "1600x750"
	},
	{
  	"id": 9428,
  	"name": "home_app",
  	"secure_url": null,
  	"url": "http://static.mlstatic.com/org-img/apparel/bkg_apps/58715193-bkg.jpg",
  	"size": "270x155"
	},
	{
  	"id": 634,
  	"name": "logo",
  	"secure_url": null,
  	"url": "http://static.mlstatic.com/org-img/apparel/images/bodegalanzarini/58715193-logo-home.jpg",
  	"size": "160x80"
	},
	{
  	"id": 633,
  	"name": "logo_landing",
  	"secure_url": null,
  	"url": "http://static.mlstatic.com/org-img/apparel/images/bodegalanzarini/58715193-logo-home.jpg",
  	"size": "160x80"
	},
	{
  	"id": 631,
  	"name": "background",
  	"secure_url": null,
  	"url": "http://static.mlstatic.com/org-img/apparel/images/bodegalanzarini/58715193-bkg.jpg",
  	"size": "1600x750"
	},
	{
  	"id": 635,
  	"name": "small_logo",
  	"secure_url": null,
  	"url": "http://static.mlstatic.com/org-img/apparel/images/bodegalanzarini/58715193-logo-ch2.jpg",
  	"size": "96x70"
	}
  ],
  "boost": {
	"is_active": false,
	"last_update": "2015-08-17T20:55:12.000Z"
  },
  "relevance_position": 69
}

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.