Documentação do Mercado Livre

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

Documentação do

Última atualização em 20/02/2024

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.

Llamada:

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

Ejemplo:

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

Respuesta:

{
   "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"
   ]
}

Campos de resposta

  • status: terá o status do usuário em relação à loja.
  • normalized_name: terá o nome da loja normalizado (sem acentos, espaços duplos, tremas, etc.)
  • last_updated: data em que a loja foi atualizada pela última vez.

Erro que pode ocorrer no recurso anterior:

curl -X GET https://api.mercadolibre.com/users/14775362261111111/brands
{
   "error": "U00002",
   "message": "U00002 - The user '14775362261111111' was not found",
   "status": 404
}


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.

Chamada:

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

Exemplo:

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

Resposta:

{
   "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",
   "users": [
       {
           "status": "LINKED",
           "cust_id": 1477536226,
           "site_id": "MLA",
           "user_type": "brand",
           "tags": [
               "large_seller",
               "messages_as_seller",
               "brand"
           ]
       }
   ],
   "pictures": [
       {
           "id": 46926,
           "name": "logo",
           "secure_url": "https://http2.mlstatic.com/storage/official-stores-images/nike/logo201804260918.jpg",
           "url": "https://http2.mlstatic.com/storage/official-stores-images/nike/logo201804260918.jpg",
           "size": "160x80"
       },
       {
           "id": 46927,
           "name": "logo_landing",
           "secure_url": "https://http2.mlstatic.com/storage/official-stores-images/nike/logo_landing201804260918.jpg",
           "url": "https://http2.mlstatic.com/storage/official-stores-images/nike/logo_landing201804260918.jpg",
           "size": "160x80"
       },
       {
           "id": 46928,
           "name": "background",
           "secure_url": "https://http2.mlstatic.com/storage/official-stores-images/nike/background20231910174134.jpg",
           "url": "https://http2.mlstatic.com/storage/official-stores-images/nike/background20231910174134.jpg",
           "size": "1600x250"
       },
       {
           "id": 46929,
           "name": "small_logo",
           "secure_url": "https://http2.mlstatic.com/storage/official-stores-images/nike/small_logo201804260922.jpg",
           "url": "https://http2.mlstatic.com/storage/official-stores-images/nike/small_logo201804260922.jpg",
           "size": "96x70"
       },
       {
           "id": 46930,
           "name": "big_logo",
           "secure_url": "https://http2.mlstatic.com/storage/official-stores-images/nike/big_logo201804260920.jpg",
           "url": "https://http2.mlstatic.com/storage/official-stores-images/nike/big_logo201804260920.jpg",
           "size": "174x164"
       },
       {
           "id": 46931,
           "name": "facebook_logo",
           "secure_url": "https://http2.mlstatic.com/storage/official-stores-images/nike/facebook_logo201804260919.jpg",
           "url": "https://http2.mlstatic.com/storage/official-stores-images/nike/facebook_logo201804260919.jpg",
           "size": "200x200"
       },
       {
           "id": 46932,
           "name": "high_resolution_logo",
           "secure_url": "https://http2.mlstatic.com/storage/official-stores-images/nike/high_resolution_logo201804260920.jpg",
           "url": "https://http2.mlstatic.com/storage/official-stores-images/nike/high_resolution_logo201804260920.jpg",
           "size": "1024x747"
       },
       {
           "id": 46933,
           "name": "dynamic_logo",
           "secure_url": "https://http2.mlstatic.com/D_Q_NP_741174-MLA27255272398_042018-F.jpg",
           "url": "http://mla-s2-p.mlstatic.com/741174-MLA27255272398_042018-F.jpg",
           "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"
}

Erros que podem acontecer no recurso anterior:

Chamada:

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

Resposta:

{
  "error": "invalid_parameter",
  "message": "The officialStoreId must contain only digits.",
  "status": 400
}

Chamada:

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

Resposta:

{
   "error": "B00001",
   "message": "B00001 - The brand '14501111111' was not found for site 'MLA'",
   "status": 404
}


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.