Categorización de productos

Las categorías son un conjunto jerárquico de grupos donde enumeramos los artículos de naturaleza similar y denominamos Árbol de Categorías. Las categorías ayudan a los compradores a encontrar el producto con solo buscar una o pocas categorías para encontrar lo que le interesa y los vendedores utilizan las categorías para aumentar las posibilidades de vender. Como cada sitio (MLA, MLB, MLM, MLC, etc.) tiene su conjunto único de categorías, antes de publicar un producto y deberás elegir en cuál publicar. Para esto, te recomendamos utilizar el nuevo predictor de categorías que ayuda a que los vendedores y desarrolladores puedan predecir, de la mejor manera, en qué categoría deberían publicar un artículo determinado. Sino, podrás explorar la estructura de categorías y elegir en cuál deseas publicar. Para ayudarte, puedes descargar la jerarquía completa de categorías con ID y nombres cortos desde nuestra API.

Contenidos

→Encuentra las categorías con el nuevo predictor
→Categorías por site
→Categorías JSON
→Nombre
→Path from root

Encuentra las categorías con el nuevo predictor

Elegir la categoría correcta para tu artículo determinará la rapidez con que los compradores lo encontrarán y mejorará tus posibilidades de venderlo. Para eso, te recomendamos utilizar el nuevo recurso de predicción de categorías que te ayudará a predecir, de la mejor manera, en qué categoría se deben publicar los productos. Para más información, puedes ver el último webinar realizado sobre el nuevo Predictor.

Categorías por site

El recurso /sites puede ofrecerte la estructura de categorías para un país en particular, en este caso 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 categorías de segundo nivel o información relacionada con categorías específicas, debes utilizar el recuso Categorías y enviar el ID de categoría como parámetro URL. El siguiente ejemplo muestra la categoría “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 puedes ver, obtienes los atributos “path_from_root” y children_categories. Utiliza estos atributos para explorar el árbol de categorías y encontrar la categoría específica para tu artículo.

Categorías JSON

Realizar una llamada a una categoría específica te permitirá conocer la información y descripción específica de la misma. A continuación encontrarás la descripción de algunos de estos atributos.

Llamada:

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

Ejemplo:

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

Respuesta:

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

Nombre

Este atributo muestra un nombre corto, por el cual no puedes buscar. Si estás interesado en buscar utilizando ID de categorías, puedes utilizar la siguiente solicitud:

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

Accede a más información sobre cómo buscar productos por categoría.

Path from root

Cuando estás en una categoría, puedes conocer el path from root de la categoría seleccionada. Observa cómo MercadoLibre utiliza esta ruta para mostrar la categoría del artículo:

Siguiente: Publica productos.