Escolha o tipo de serviço
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:

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.
