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 27/02/2026

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.

Chamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN'https://api.mercadolibre.com/users/$USER_ID/brands

Exemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN'https://api.mercadolibre.com/users/2275117700/brands

Resposta:

{
    "status": "LINKED",
    "cust_id": 2275117700,
    "shield_id": null,
    "site_id": "MLA",
    "user_type": "brand",
    "brands": [
        {
            "site_id": "MLA",
            "official_store_id": 294894,
            "name": "Generica",
            "type": "normal",
            "relevance_position": 10000,
            "status_id": 1,
            "status": "active",
            "fantasy_name": "Genérica",
            "date_created": "2026-01-15T16:33:15Z",
            "reputation": null,
            "return_policy": null,
            "landing_permalink": "https://www.mercadolibre.com.ar/tienda/generica",
            "reputation_meli": null,
            "keywords": [],
            "pictures": [
                {
                    "id": 1117276,
                    "name": "high_resolution_logo",
                    "secure_url": "https://http2.mlstatic.com/D_NQ_NP_949195-MLA107749042667_022026-F.jpg",
                    "url": "https://http2.mlstatic.com/D_NQ_NP_949195-MLA107749042667_022026-F.jpg",
                    "size": "1024x747",
                    "picture_id": "949195-MLA107749042667_022026"
                },
                {
                    "id": 1117278,
                    "name": "logo",
                    "secure_url": "https://http2.mlstatic.com/D_NQ_NP_726135-MLA107749721107_022026-F.jpg",
                    "url": "https://http2.mlstatic.com/D_NQ_NP_726135-MLA107749721107_022026-F.jpg",
                    "size": "160x80",
                    "picture_id": "726135-MLA107749721107_022026"
                },
                {
                    "id": 1117280,
                    "name": "logo_landing",
                    "secure_url": "https://http2.mlstatic.com/D_NQ_NP_737553-MLA107059136516_022026-F.jpg",
                    "url": "https://http2.mlstatic.com/D_NQ_NP_737553-MLA107059136516_022026-F.jpg",
                    "size": "160x80",
                    "picture_id": "737553-MLA107059136516_022026"
                },
                {
                    "id": 888681,
                    "name": "small_logo",
                    "secure_url": "https://http2.mlstatic.com/D_NQ_NP_939151-MLA107749721109_022026-F.jpg",
                    "url": "https://http2.mlstatic.com/D_NQ_NP_939151-MLA107749721109_022026-F.jpg",
                    "size": "96x70",
                    "picture_id": "939151-MLA107749721109_022026"
                },
                {
                    "id": 888683,
                    "name": "big_logo",
                    "secure_url": "https://http2.mlstatic.com/D_NQ_NP_917241-MLA107059166262_022026-F.jpg",
                    "url": "https://http2.mlstatic.com/D_NQ_NP_917241-MLA107059166262_022026-F.jpg",
                    "size": "174x164",
                    "picture_id": "917241-MLA107059166262_022026"
                },
                {
                    "id": 888685,
                    "name": "facebook_logo",
                    "secure_url": "https://http2.mlstatic.com/D_NQ_NP_725533-MLA107749868205_022026-F.jpg",
                    "url": "https://http2.mlstatic.com/D_NQ_NP_725533-MLA107749868205_022026-F.jpg",
                    "size": "200x200",
                    "picture_id": "725533-MLA107749868205_022026"
                },
                {
                    "id": 888687,
                    "name": "dynamic_logo",
                    "secure_url": "https://http2.mlstatic.com/D_NQ_NP_732424-MLA107059373888_022026-F.jpg",
                    "url": "https://http2.mlstatic.com/D_NQ_NP_732424-MLA107059373888_022026-F.jpg",
                    "size": "1024x747",
                    "picture_id": "732424-MLA107059373888_022026"
                },
                {
                    "id": 311582,
                    "name": "component_image",
                    "secure_url": "https://http2.mlstatic.com/D_NQ_NP_712414-MLA106907616380_022026-OO.webp",
                    "url": "https://http2.mlstatic.com/D_NQ_NP_712414-MLA106907616380_022026-OO.webp",
                    "size": null,
                    "picture_id": "712414-MLA106907616380_022026"
                },
                {
                    "id": 1296250,
                    "name": "background",
                    "secure_url": "https://http2.mlstatic.com/D_NQ_NP_890834-MLA107750130589_022026-OO.jpg",
                    "url": "https://http2.mlstatic.com/D_NQ_NP_890834-MLA107750130589_022026-OO.jpg",
                    "size": "1200x189",
                    "picture_id": "890834-MLA107750130589_022026"
                }
            ],
            "tags": [
                "test_store",
                "STANDARD"
            ],
            "categories_ids": [
                "MLA1367"
            ],
            "main_categories": [
                {
                    "id": "MLA1367"
                }
            ],
            "permalink": "https://tienda.mercadolibre.com.ar/generica",
            "normalized_name": "generica",
            "last_updated": "2026-02-26T21:50:18Z",
            "brand_registry": {
                "brand_id": 276243,
                "brand_registry_id": 65798,
                "brand_name": "Genérica"
            },
            "storefront_id": "511e79c539444d95a2a07e4e3d0dd9cc2275117700"
        },
        {
            "site_id": "MLA",
            "official_store_id": 311582,
            "name": "Test Edwin",
            "type": "normal",
            "relevance_position": 10000,
            "status_id": 3,
            "status": "offline",
            "fantasy_name": "Test Edwin",
            "date_created": "2026-02-06T16:45:18Z",
            "reputation": null,
            "return_policy": null,
            "landing_permalink": null,
            "reputation_meli": null,
            "keywords": [],
            "pictures": [
                {
                    "id": 957469,
                    "name": "high_resolution_logo",
                    "secure_url": "https://http2.mlstatic.com/D_NQ_NP_879758-MLA106748379013_022026-F.jpg",
                    "url": "https://http2.mlstatic.com/D_NQ_NP_879758-MLA106748379013_022026-F.jpg",
                    "size": "1024x747",
                    "picture_id": "879758-MLA106748379013_022026"
                },
                {
                    "id": 957471,
                    "name": "logo",
                    "secure_url": "https://http2.mlstatic.com/D_NQ_NP_613478-MLA106748648991_022026-F.jpg",
                    "url": "https://http2.mlstatic.com/D_NQ_NP_613478-MLA106748648991_022026-F.jpg",
                    "size": "160x80",
                    "picture_id": "613478-MLA106748648991_022026"
                },
                {
                    "id": 957473,
                    "name": "logo_landing",
                    "secure_url": "https://http2.mlstatic.com/D_NQ_NP_856855-MLA106748678917_022026-F.jpg",
                    "url": "https://http2.mlstatic.com/D_NQ_NP_856855-MLA106748678917_022026-F.jpg",
                    "size": "160x80",
                    "picture_id": "856855-MLA106748678917_022026"
                },
                {
                    "id": 957475,
                    "name": "small_logo",
                    "secure_url": "https://http2.mlstatic.com/D_NQ_NP_723477-MLA106748113503_022026-F.jpg",
                    "url": "https://http2.mlstatic.com/D_NQ_NP_723477-MLA106748113503_022026-F.jpg",
                    "size": "96x70",
                    "picture_id": "723477-MLA106748113503_022026"
                },
                {
                    "id": 957477,
                    "name": "big_logo",
                    "secure_url": "https://http2.mlstatic.com/D_NQ_NP_607356-MLA106748499017_022026-F.jpg",
                    "url": "https://http2.mlstatic.com/D_NQ_NP_607356-MLA106748499017_022026-F.jpg",
                    "size": "174x164",
                    "picture_id": "607356-MLA106748499017_022026"
                },
                {
                    "id": 957479,
                    "name": "facebook_logo",
                    "secure_url": "https://http2.mlstatic.com/D_NQ_NP_881677-MLA106126554480_022026-F.jpg",
                    "url": "https://http2.mlstatic.com/D_NQ_NP_881677-MLA106126554480_022026-F.jpg",
                    "size": "200x200",
                    "picture_id": "881677-MLA106126554480_022026"
                },
                {
                    "id": 1201282,
                    "name": "dynamic_logo",
                    "secure_url": "https://http2.mlstatic.com/D_NQ_NP_863456-MLA106748708881_022026-F.jpg",
                    "url": "https://http2.mlstatic.com/D_NQ_NP_863456-MLA106748708881_022026-F.jpg",
                    "size": "1024x747",
                    "picture_id": "863456-MLA106748708881_022026"
                }
            ],
            "tags": [
                "test_store"
            ],
            "categories_ids": [
                "MLA1403"
            ],
            "main_categories": [
                {
                    "id": "MLA1403"
                }
            ],
            "permalink": "https://listado.mercadolibre.com.ar/_OfficialStoreId_311582",
            "normalized_name": "test edwin",
            "last_updated": "2026-02-06T16:45:18Z",
            "brand_registry": {
                "brand_id": 0,
                "brand_registry_id": 92379,
                "brand_name": "Test Edwin"
            },
            "storefront_id": null
        },
        {
            "site_id": "MLA",
            "official_store_id": 143304,
            "name": "test multitienda mla cupones",
            "type": "normal",
            "relevance_position": 10000,
            "status_id": 1,
            "status": "active",
            "fantasy_name": "test multitienda mla cupones",
            "date_created": "2025-02-18T19:41:18Z",
            "reputation": null,
            "return_policy": null,
            "landing_permalink": "https://www.mercadolibre.com.ar/tienda/test-multitienda-mla-cupones",
            "reputation_meli": null,
            "keywords": [],
            "pictures": [
                {
                    "id": 409700,
                    "name": "high_resolution_logo",
                    "secure_url": "https://http2.mlstatic.com/D_NQ_NP_849337-MLA104009616779_012026-F.jpg",
                    "url": "https://http2.mlstatic.com/D_NQ_NP_849337-MLA104009616779_012026-F.jpg",
                    "size": "1024x747",
                    "picture_id": "849337-MLA104009616779_012026"
                },
                {
                    "id": 342961,
                    "name": "logo",
                    "secure_url": "https://http2.mlstatic.com/D_NQ_NP_894154-MLA104009292219_012026-F.jpg",
                    "url": "https://http2.mlstatic.com/D_NQ_NP_894154-MLA104009292219_012026-F.jpg",
                    "size": "160x80",
                    "picture_id": "894154-MLA104009292219_012026"
                },
                {
                    "id": 342963,
                    "name": "logo_landing",
                    "secure_url": "https://http2.mlstatic.com/D_NQ_NP_916798-MLA104009352385_012026-F.jpg",
                    "url": "https://http2.mlstatic.com/D_NQ_NP_916798-MLA104009352385_012026-F.jpg",
                    "size": "160x80",
                    "picture_id": "916798-MLA104009352385_012026"
                },
                {
                    "id": 342965,
                    "name": "small_logo",
                    "secure_url": "https://http2.mlstatic.com/D_NQ_NP_661514-MLA104009173803_012026-F.jpg",
                    "url": "https://http2.mlstatic.com/D_NQ_NP_661514-MLA104009173803_012026-F.jpg",
                    "size": "96x70",
                    "picture_id": "661514-MLA104009173803_012026"
                },
                {
                    "id": 342967,
                    "name": "big_logo",
                    "secure_url": "https://http2.mlstatic.com/D_NQ_NP_833896-MLA104009292221_012026-F.jpg",
                    "url": "https://http2.mlstatic.com/D_NQ_NP_833896-MLA104009292221_012026-F.jpg",
                    "size": "174x164",
                    "picture_id": "833896-MLA104009292221_012026"
                },
                {
                    "id": 342969,
                    "name": "facebook_logo",
                    "secure_url": "https://http2.mlstatic.com/D_NQ_NP_989810-MLA104010237741_012026-F.jpg",
                    "url": "https://http2.mlstatic.com/D_NQ_NP_989810-MLA104010237741_012026-F.jpg",
                    "size": "200x200",
                    "picture_id": "989810-MLA104010237741_012026"
                },
                {
                    "id": 342971,
                    "name": "dynamic_logo",
                    "secure_url": "https://http2.mlstatic.com/D_NQ_NP_604853-MLA104009587141_012026-F.jpg",
                    "url": "https://http2.mlstatic.com/D_NQ_NP_604853-MLA104009587141_012026-F.jpg",
                    "size": "1024x747",
                    "picture_id": "604853-MLA104009587141_012026"
                },
                {
                    "id": 409540,
                    "name": "background",
                    "secure_url": "https://http2.mlstatic.com/D_NQ_NP_942104-MLA106075597073_012026-OO.jpg",
                    "url": "https://http2.mlstatic.com/D_NQ_NP_942104-MLA106075597073_012026-OO.jpg",
                    "size": "1200x63",
                    "picture_id": "942104-MLA106075597073_012026"
                }
            ],
            "tags": [
                "test_store",
                "STANDARD"
            ],
            "categories_ids": [
                "MLA1403"
            ],
            "main_categories": [
                {
                    "id": "MLA1403"
                }
            ],
            "permalink": "https://tienda.mercadolibre.com.ar/test-multitienda-mla-cupones",
            "normalized_name": "test multitienda mla cupones",
            "last_updated": "2026-02-27T21:05:04Z",
            "brand_registry": {
                "brand_id": 0,
                "brand_registry_id": 37435,
                "brand_name": "test multitienda mla cupones"
            },
            "storefront_id": "dd53547f81fa4e24966839dcda1414432275117700"
        }
    ],
    "tags": [
        "eshop",
        "user_product_seller",
        "large_seller",
        "test_user",
        "brand"
    ],
    "seller_type": "owner"
}

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 -H 'Authorization: Bearer $ACCESS_TOKEN' 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 -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/$USER_ID/brands/$BRAND

Exemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/2275117700/brands/294894

Resposta:

{
    "site_id": "MLA",
    "official_store_id": 294894,
    "name": "Generica",
    "type": "normal",
    "relevance_position": 10000,
    "status_id": 1,
    "status": "active",
    "fantasy_name": "Genérica",
    "date_created": "2026-01-15T16:33:15Z",
    "reputation": null,
    "return_policy": null,
    "landing_permalink": "https://www.mercadolibre.com.ar/tienda/generica",
    "reputation_meli": null,
    "users": [
        {
            "status": "LINKED",
            "cust_id": 2275117700,
            "shield_id": null,
            "site_id": "MLA",
            "user_type": "brand",
            "tags": [
                "eshop",
                "user_product_seller",
                "large_seller",
                "test_user",
                "brand"
            ],
            "seller_type": "owner"
        }
    ],
    "keywords": [],
    "pictures": [
        {
            "id": 1117276,
            "name": "high_resolution_logo",
            "secure_url": "https://http2.mlstatic.com/D_NQ_NP_949195-MLA107749042667_022026-F.jpg",
            "url": "https://http2.mlstatic.com/D_NQ_NP_949195-MLA107749042667_022026-F.jpg",
            "size": "1024x747",
            "picture_id": "949195-MLA107749042667_022026"
        },
        {
            "id": 1117278,
            "name": "logo",
            "secure_url": "https://http2.mlstatic.com/D_NQ_NP_726135-MLA107749721107_022026-F.jpg",
            "url": "https://http2.mlstatic.com/D_NQ_NP_726135-MLA107749721107_022026-F.jpg",
            "size": "160x80",
            "picture_id": "726135-MLA107749721107_022026"
        },
        {
            "id": 1117280,
            "name": "logo_landing",
            "secure_url": "https://http2.mlstatic.com/D_NQ_NP_737553-MLA107059136516_022026-F.jpg",
            "url": "https://http2.mlstatic.com/D_NQ_NP_737553-MLA107059136516_022026-F.jpg",
            "size": "160x80",
            "picture_id": "737553-MLA107059136516_022026"
        },
        {
            "id": 888681,
            "name": "small_logo",
            "secure_url": "https://http2.mlstatic.com/D_NQ_NP_939151-MLA107749721109_022026-F.jpg",
            "url": "https://http2.mlstatic.com/D_NQ_NP_939151-MLA107749721109_022026-F.jpg",
            "size": "96x70",
            "picture_id": "939151-MLA107749721109_022026"
        },
        {
            "id": 888683,
            "name": "big_logo",
            "secure_url": "https://http2.mlstatic.com/D_NQ_NP_917241-MLA107059166262_022026-F.jpg",
            "url": "https://http2.mlstatic.com/D_NQ_NP_917241-MLA107059166262_022026-F.jpg",
            "size": "174x164",
            "picture_id": "917241-MLA107059166262_022026"
        },
        {
            "id": 888685,
            "name": "facebook_logo",
            "secure_url": "https://http2.mlstatic.com/D_NQ_NP_725533-MLA107749868205_022026-F.jpg",
            "url": "https://http2.mlstatic.com/D_NQ_NP_725533-MLA107749868205_022026-F.jpg",
            "size": "200x200",
            "picture_id": "725533-MLA107749868205_022026"
        },
        {
            "id": 888687,
            "name": "dynamic_logo",
            "secure_url": "https://http2.mlstatic.com/D_NQ_NP_732424-MLA107059373888_022026-F.jpg",
            "url": "https://http2.mlstatic.com/D_NQ_NP_732424-MLA107059373888_022026-F.jpg",
            "size": "1024x747",
            "picture_id": "732424-MLA107059373888_022026"
        },
        {
            "id": 311582,
            "name": "component_image",
            "secure_url": "https://http2.mlstatic.com/D_NQ_NP_712414-MLA106907616380_022026-OO.webp",
            "url": "https://http2.mlstatic.com/D_NQ_NP_712414-MLA106907616380_022026-OO.webp",
            "size": null,
            "picture_id": "712414-MLA106907616380_022026"
        },
        {
            "id": 1296250,
            "name": "background",
            "secure_url": "https://http2.mlstatic.com/D_NQ_NP_890834-MLA107750130589_022026-OO.jpg",
            "url": "https://http2.mlstatic.com/D_NQ_NP_890834-MLA107750130589_022026-OO.jpg",
            "size": "1200x189",
            "picture_id": "890834-MLA107750130589_022026"
        }
    ],
    "tags": [
        "test_store",
        "STANDARD"
    ],
    "categories_ids": [
        "MLA1367"
    ],
    "main_categories": [
        {
            "id": "MLA1367"
        }
    ],
    "permalink": "https://tienda.mercadolibre.com.ar/generica",
    "normalized_name": "generica",
    "last_updated": "2026-02-26T21:50:18Z",
    "brand_registry": {
        "brand_id": 276243,
        "brand_registry_id": 65798,
        "brand_name": "Genérica"
    },
    "storefront_id": "511e79c539444d95a2a07e4e3d0dd9cc2275117700"
}

Erros que podem acontecer no recurso anterior:


Chamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' 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 -H 'Authorization: Bearer $ACCESS_TOKEN' 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.