Documentation Mercado Libre
Check out all the necessary information about APIs Mercado Libre.
Documentation
Last update 20/02/2024
Official Stores
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/brandsExample:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/470225786/brandsResponse:
{
"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_IDExample:
curl -X GET https://api.mercadolibre.com/users/470225786/brands/2572Response:
{
"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/aaaaaResponse:
{
"error": "invalid_parameter",
"message": "The officialStoreId must contain only digits.",
"status": 400
}Request:
curl -X GET https://api.mercadolibre.com/users/1477536226/brands/14501111111Response:
{
"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.