Documentación Mercado Libre
Descubre toda la información que debes conocer sobre las APIs de Mercado Libre.Documentación
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.