Escolha o tipo de serviço

As categorias são um conjunto hierárquico de grupos nos quais os produtos de natureza semelhante são enumerados, denominados "árvore de categorias". As categorias ajudam os compradores a encontrar o tipo de produto que desejam, já que o comprador somente deve buscar em uma ou poucas categorias para encontrar o que interessa. Os vendedores aproveitam as categorias para incrementar suas chances de venda graças aos compradores que acessam os produtos mais rapidamente.
Cada site tem seu próprio conjunto de categorias, isto é, a Argentina terá um conjunto de categorias único, diferente do conjunto das categorias do Brasil. https://api.mercadolibre.com/sites/MLB/categories
Antes de publicar um anúncio, você deve explorar a estrutura de categorias e escolher em qual delas quer publicar. Como ajuda, você pode baixar a hierarquia completa de categorias, com ID e nomes simples, de nossa API.

Conteúdos

→Categorias por site
→Categorias JSON
→Nome
→Rota da raiz
→Encontrar a melhor categoria para seu produto


Categorias por site

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

Exemplo:

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

Resposta:

"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.

Exemplo:

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

Resposta:

{
  "id": "MLA1540",
  "name": "Servicios",
  "picture": "http://resources.mlstatic.com/category/images/3b5619b2-cc62-4775-8e64-05a1e5585bba.png",
  "permalink": "http://www.mercadolibre.com.ar/servicios/",
  "total_items_in_this_category": 33783,
  "path_from_root": [
    {
      "id": "MLA1540",
      "name": "Servicios"
    }
  ],
  "children_categories": [
    {
      "id": "MLA122264",
      "name": "Arte, Música y Cine",
      "total_items_in_this_category": 1134
    },
    {
      "id": "MLA10514",
      "name": "Belleza y Cuidado Personal",
      "total_items_in_this_category": 1029
    },
    {
      "id": "MLA43986",
      "name": "Cursos y Clases",
      "total_items_in_this_category": 1188
    },
    {
      "id": "MLA91058",
      "name": "Delivery",
      "total_items_in_this_category": 338
    },
    {
      "id": "MLA1550",
      "name": "Fiestas y Eventos",
      "total_items_in_this_category": 6840
    },
    {
      "id": "MLA122258",
      "name": "Hogar",
      "total_items_in_this_category": 4067
    },
    {
      "id": "MLA56666",
      "name": "Imprenta",
      "total_items_in_this_category": 717
    },
    {
      "id": "MLA9007",
      "name": "Mantenimiento de Vehículos",
      "total_items_in_this_category": 1980
    },
    {
      "id": "MLA111029",
      "name": "Medicina y Salud",
      "total_items_in_this_category": 641
    },
    {
      "id": "MLA113657",
      "name": "Oficios",
      "total_items_in_this_category": 1994
    },
    {
      "id": "MLA1898",
      "name": "Otros Servicios",
      "total_items_in_this_category": 2842
    },
    {
      "id": "MLA1541",
      "name": "Profesionales",
      "total_items_in_this_category": 2106
    },
    {
      "id": "MLA91088",
      "name": "Ropa y Moda",
      "total_items_in_this_category": 515
    },
    {
      "id": "MLA11813",
      "name": "Servicio Técnico",
      "total_items_in_this_category": 3916
    },
    {
      "id": "MLA11798",
      "name": "Servicios para Mascotas",
      "total_items_in_this_category": 653
    },
    {
      "id": "MLA91083",
      "name": "Servicios para Oficinas",
      "total_items_in_this_category": 262
    },
    {
      "id": "MLA9038",
      "name": "Transporte",
      "total_items_in_this_category": 2316
    },
    {
      "id": "MLA1229",
      "name": "Viajes y Turismo",
      "total_items_in_this_category": 1218
    }
  ],
  "attribute_types": "none",
  "settings": {
    "adult_content": false,
    "buying_allowed": true,
    "buying_modes": [
      "classified"
    ],
    "coverage_areas": "optional",
    "currencies": [
      "ARS",
      "USD"
    ],
    "fragile": false,
    "immediate_payment": "optional",
    "item_conditions": [
      "not_allowed"
    ],
    "items_reviews_allowed": true,
    "max_description_length": 50000,
    "max_pictures_per_item": 12,
    "max_sub_title_length": 70,
    "max_title_length": 60,
    "price": "optional",
    "restrictions": [
    ],
    "rounded_address": false,
    "seller_contact": "required",
    "shipping_modes": [
      "not_specified",
      "custom"
    ],
    "shipping_options": [
    ],
    "shipping_profile": "not_allowed",
    "show_contact_information": true,
    "simple_shipping": "not_allowed",
    "stock": "optional",
    "tags": [
    ],
    "vip_subdomain": "servicio",
    "mirror_category": null,
    "listing_allowed": false,
    "maximum_price": null,
    "minimum_price": null
  },
  "meta_categ_id": null,
  "attributable": false
}

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.

curl https://api.mercadolibre.com/categories/MLA58257
{
  "id": "MLA58257",
  "name": "Estudios de Grabación",
  "picture": null,
  "permalink": null,
  "total_items_in_this_category": 37,
  "path_from_root": [
    {
      "id": "MLA1540",
      "name": "Servicios"
    },
    {
      "id": "MLA122264",
      "name": "Arte, Música y Cine"
    },
    {
      "id": "MLA94730",
      "name": "Música"
    },
    {
      "id": "MLA58257",
      "name": "Estudios de Grabación"
    }
  ],
  "children_categories": [
  ],
  "attribute_types": "none",
  "settings": {
    "adult_content": false,
    "buying_allowed": true,
    "buying_modes": [
      "classified"
    ],
    "coverage_areas": "optional",
    "currencies": [
      "ARS",
      "USD"
    ],
    "fragile": false,
    "immediate_payment": "optional",
    "item_conditions": [
      "not_allowed"
    ],
    "items_reviews_allowed": true,
    "max_description_length": 50000,
    "max_pictures_per_item": 12,
    "max_sub_title_length": 70,
    "max_title_length": 60,
    "price": "optional",
    "restrictions": [
    ],
    "rounded_address": false,
    "seller_contact": "required",
    "shipping_modes": [
      "not_specified",
      "custom"
    ],
    "shipping_options": [
    ],
    "shipping_profile": "not_allowed",
    "show_contact_information": true,
    "simple_shipping": "not_allowed",
    "stock": "optional",
    "tags": [
    ],
    "vip_subdomain": "servicio",
    "mirror_category": null,
    "listing_allowed": true,
    "maximum_price": null,
    "minimum_price": null
  },
  "meta_categ_id": null,
  "attributable": false
}

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 de produtos por categoria.


Rota da raiz

Quando você está posicionado em uma categoria, pode saber qual é a rota da raiz para a categoria selecionada. Veja como o Mercado Livre usa a rota para mostrar a categoria do produto:

image-category (1)

Encontrar a melhor categoria para seu produto

A categoria folha é a última categoria da árvore e a única em que você pode publicar produtos. A escolha da categoria certa para seu produto determinará a rapidez com que ele será encontrado pelos compradores, melhorando suas chances de venda. Por isso, nós recomendamos utilizar a nossa ferramenta de predição de Categorias antes de publicar um produto.

Talvez algumas das categorias não tenham boas sugestões, por isso, você deverá fazer com que o usuário de seu sistema realize um mapeamento das categorias manualmente para encontrar seus produtos. Um processo mais simples poderia ser a utilização da API de Categorias e a navegação pela árvore de categorias, para detectar qual é a melhor opção. Você deve usar só aquelas categorias recuperadas da API que não tenham subcategorias relacionadas. Outra opção poderia ser encontrar produtos similares no Mercado Livre para usar a categoria deles.


Seguinte: Gerenciamento das áreas de cobertura.