Documentação do Mercado Livre
Confira todas as informações necessárias sobre as APIs Mercado Livre.
Documentação
Lojas Oficiais
Acesso aos IDs de suas marcas
Este recurso recupera marcas associadas a um user_id. Pode haver mais de uma por usuário. A loja é identificada com o atributo official_store_id.
Exemplo:
https://api.mercadolibre.com/users/{User_id}/brands
Resposta:
{
"cust_id": 12345678,
"tags": [
"large_seller",
"user_info_verified",
"brand"
],
"brands": [
{
"tags": [
"girls",
"female"
],
"official_store_id": 16,
"categories_ids": [
"MLA1430"
],
"fantasy_name": "47 Street",
"site_id": "MLA",
"status": "active",
"name": "47 Street",
"pictures": [
{
"id": 104,
"name": "big_logo",
"secure_url": null,
"url": "http://static.mlstatic.com/org-img/apparel/images/47street/149254178-logo-g2.jpg",
"size": "174x164"
},
{},
{},
{},
{},
{}
],
"relevance_position": 50
},
{},
{},
{},
{}
],
"site_id": "MLA",
"user_type": "brand"
}
Acesso a todas as informações sobre uma determinada marca
Para obter informações sobre uma determinada marca, você pode realizar a chamada ao brand_id que quiser conhecer, conforme mostrado no exemplo a seguir.
Exemplo:
curl -X GET https://api.mercadolibre.com/users/58715193/brands/133
Resposta:
{
"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
}
Erros comuns na resposta da API ao publicar em lojas oficiais multimarcas
Caso não tenha enviado o official_store_id do produto para uma loja oficial multimarcas, você receberá como resposta os possíveis IDs que pode enviar com seu usuário:
"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"
Caso você envie um official_store_id inválido para uma loja oficial multimarcas, a resposta será a seguinte:
{
"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": []
}
Excelente! Você já conhece os brand_ids associados a seu usuário e que você deverá enviar toda vez que quiser publicar um item. Leia este tutorial para aprender a publicar um item em sua Loja oficial.
Seguinte: Categorização de produtos.