Documentação do Mercado Livre

Confira todas as informações necessárias sobre as APIs Mercado Livre.
circulos azuis em degrade

Documentação

Última atualização em 28/12/2022

Lojas Oficiais

Alguns usuários fazem parte das Lojas Oficiais do Mercado Livre e têm uma ou mais marcas com o mesmo usuário. Se quiser fazer parte das Lojas Oficiais do Mercado Livre, entre em contato com um consultor comercial. Se você já faz parte das Lojas Oficiais, leia este tutorial para saber quais são os princípios básicos para trabalhar com esse tipo de usuário.


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.