Categorização de produtos

As categorias são um conjunto hierárquico de grupos nos quais os produtos de natureza semelhante são enumerados que denominamos "árvore de categorias". Antes de publicar um produto deve utilizar o preditor de categorias para preverda melhor forma a categoria que deve publicar.
Além disso, você pode explorar a estrutura de categorias e escolher qual categoria você deseja publicar. É possível realizar o dump da hierarquia completa da categoria com IDs e nomes curtos em nossa API.

Conteúdos

→Preditor de categorias
    ↳Parâmetros obrigatórios
    ↳Parâmetros opcionais
    ↳Campos da resposta
→Categorias por site
→Categorias JSON
→Nome
→Rota da raiz
→Descargar categorias


Preditor de categorias

Você poderá executar o GET em um item de cada vez para obter as categorias com os atributos a serem carregados para que a publicação tenha boa qualidade. Tenha em conta que o resultado será composto por uma lista de sugestões a partir do título utilizado, sendo que o primeiro resultado é considerado de maior probabilidade.


Parâmetros obrigatórios

site_id: é o site no qual você publica.
q: é o título do artigo a prever e deve estar completamente no idioma do site.


Parâmetros opcionais

limit: o valor padrão será 4, mas pode chegar a 8, para que você possa definir um limite entre 1 e 8.
target: pode ser constituído por core ou classified, dependendo da vertical em que está sendo publicado.


Chamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/$SITE_ID/domain_discovery/search?q=$Q

Exemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/MLA/domain_discovery/search?limit=1&q=celular%20iphone

Resposta:

[
  {
    "domain_id": "MLA-CELLPHONES",
    "domain_name": "Celulares",
    "category_id": "MLA1055",
    "category_name": "Celulares y Smartphones",
    "attributes": [
      {
        "id": "BRAND",
        "value_id": "9344",
        "value_name": "Apple"
      },
      {
        "id": "LINE",
        "value_id": "58993",
        "value_name": "iPhone"
      },
      {
        "id": "MODEL",
        "value_id": "14608",
        "value_name": "iPhone"
      }
    ]
  }
]

Campos da resposta

domain_id: ID do domínio previsto para o item.
domain_name: nome do domínio previsto.
category_id: ID da categoria prevista para o item.
category_name: nome da categoria prevista.
attributes: Lista de atributos para a categoria prevista.


Para obter informações sobre os campos path_from_root, shipping_modes e variations, consulte no recurso /categories.


Categorias por site

O recurso Sites pode oferecer a estrutura de categorias de um país em particular, nesse caso, da Argentina.

curl -X GET https://api.mercadolibre.com/sites/MLA/categories
"categories": [
    {
    "id": "MLA5725",
    "name": "Accesorios para Vehiculos",
    },
    {
    "id": "MLA1071",
    "name": "Animales y Mascotas",
    },
    {
    "id": "MLA1367",
    "name": "Antigüedades",
    },
    {
    "id": "MLA1743",
    "name": "Autos, Motos y Otros",
},

Para categorias do segundo nível ou informações relacionadas com categorias específicas, você deve utilizar o recurso Categories e enviar o ID da categoria como parâmetro URL. O exemplo abaixo mostra a categoria “Animales y Mascotas”:

https://api.mercadolibre.com/categories/MLA1071
{
    "id": "MLA1071",
    "name": "Animales y Mascotas",
    "permalink": "http://home.mercadolibre.com.ar/animales-y-mascotas",
    "total_items_in_this_category": "30434",
    "path_from_root": [
          {
                  "id": "MLA1071",
                  "name": "Animales y Mascotas",
          },
    ],
    "children_categories": [
          {
                  "id": "MLA1100",
                  "name": "Aves",
                  "total_items_in_this_category": "1430",
          },
          {
                  "id": "MLA1117",
                  "name": "Caballos",
                  "total_items_in_this_category": "1092",
          },
    .
    .

Como pode observar, você obtém os atributos “path_from_root” e children_categories. Utilize esses atributos quando explorar a árvore de categorias para encontrar a categoria específica de seu produto.


Categorias JSON

Fazer uma chamada para uma categoria específica permitirá saber as informações e descrições específicas dela. A seguir, você encontrará a descrição de alguns desses atributos.

Chamada:

curl -X GET https://api.mercadolibre.com/categories/$CATEGORY_ID

Exemplo:

curl -X GET https://api.mercadolibre.com/categories/MLA1271

Resposta:

{
  "id": "MLA1271",
  "name": "Perfumes",
  "picture": "http://resources.mlstatic.com/category/images/ebc2e89f-1664-45eb-8354-686cde860c05.png",
  "permalink": null,
  "total_items_in_this_category": 58377,
  "path_from_root": [
    {
      "id": "MLA1246",
      "name": "Belleza y Cuidado Personal"
    },
    {
      "id": "MLA1271",
      "name": "Perfumes"
    }
  ],
  "children_categories": [
  ],
  "attribute_types": "attributes",
  "settings": {
    "adult_content": false,
    "buying_allowed": true,
    "buying_modes": [
      "buy_it_now",
      "auction"
    ],
    "catalog_domain": "MLA-PERFUMES",
    "coverage_areas": "not_allowed",
    "currencies": [
      "ARS"
    ],
    "fragile": false,
    "immediate_payment": "required",
    "item_conditions": [
      "new",
      "not_specified",
      "used"
    ],
    "items_reviews_allowed": false,
    "listing_allowed": true,
    "max_description_length": 50000,
    "max_pictures_per_item": 12,
    "max_pictures_per_item_var": 10,
    "max_sub_title_length": 70,
    "max_title_length": 60,
    "maximum_price": null,
    "minimum_price": 22,
    "mirror_category": null,
    "mirror_master_category": null,
    "mirror_slave_categories": [
    ],
    "price": "required",
    "reservation_allowed": "not_allowed",
    "restrictions": [
    ],
    "rounded_address": false,
    "seller_contact": "not_allowed",
    "shipping_modes": [
      "custom",
      "me1",
      "me2",
      "not_specified"
    ],
    "shipping_options": [
      "carrier",
      "custom"
    ],
    "shipping_profile": "optional",
    "show_contact_information": false,
    "simple_shipping": "optional",
    "stock": "required",
    "sub_vertical": "beauty",
    "subscribable": false,
    "tags": [
    ],
    "vertical": "consumer_goods",
    "vip_subdomain": "articulo",
    "buyer_protection_programs": [
    ],
    "status": "enabled"
  },
  "meta_categ_id": null,
  "attributable": false,
  "date_created": "2018-04-25T08:12:56.000Z"
}

Nome

Esse atributo mostra uma etiqueta simples. Você não pode usar essa etiqueta para buscar produtos. Caso você queira buscar usando ID de categorias, poderá usar o pedido a seguir:

curl -X GET https://api.mercadolibre.com/sites/MLA/search?category=MLA5726

Acesse mais informações no produto busca produtos por categoria.


Rota da raiz

Quando você está posicionado em uma categoria, pode saber qual é a rota da raiz para a categoria selecionada. A rota da categoria será uma combinação baseada na categoria selecionada e nos dados preenchidos na ficha técnica do produto. Veja como o Mercado Livre usa a rota para mostrar a categoria do produto:
image-category (1)


Descargar categorias

Finalmente, e no caso de não conseguir usar o Preditor de Categorias, você pode descargar a árvore de categorias.


Próximo: Publicação de produtos.

ou registre-se para receber as últimas notícias sobre nossa API