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. Antes de publicar un producto, utiliza el predictor de categorías para predecir, de la mejor manera, en qué categoría deberías publicarlo.
Además, podrás explorar la estructura de categorías y elegir en cuál deseas publicar descargando la jerarquía completa de categorías con ID y nombres cortos desde nuestra API.

Contenidos

→Predictor de categorías
    ↳Parámetros obligatorios
    ↳Parámetros opcionales
    ↳Campos de respuesta
→Categorías por site
→Categorías JSON
→Nombre
→Path from root
→Descargar categorías


Predictor de categorías

Te permite aumentar la precisión de la predicción que realices, mira nuestro webinar sobre Predictor de categorías:.




Realiza una llamada GET para predecir un artículo por vez y así, podrás reconocer la categoría con los atributos que debes cargar para que la publicación tenga calidad. Ten en cuenta que la respuesta estará compuesta de un listado de predicciones a partir del título provisto, siendo la primera la de mayor probabilidad.


Parámetros obligatorios

site_id: es el sitio en el que realizas la publicación.
q: es el título del artículo a predecir y debe estar completamente en el idioma del sitio (español o portugués).


Parámetros opcionales

limit: por defecto, el límite será de 4 con un máximo de 8, por lo que podrías definir un limit entre 1 a 8.
target: puede estar compuesto por core (Producto) o classified (Clasificados) dependiendo la vertical en el que estés publicando.


Llamada: 

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

Ejemplo:

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

Respuesta:

[
  {
    "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 de respuesta

domain_id: es el ID del dominio que predices para el artículo.
domain_name: es el nombre del dominio que predices.
category_id: es el ID de la categoría que predices para el articulo.
category_name: es el nombre de la categoría que predices.
attributes: Listado de atributos para la categoría que se predijo.


Para obtener información de los campos path_from_root, shipping_modes y variations, consulta el recurso de /categories.


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:
image-category (1)


Descargar categorías

Por último, y en caso de no poder utilizar el Predictor de categorías, podrás descargar el árbol de categorías.


Siguiente: Publica productos.

o regístrate para recibir las últimas novedades sobre nuestra API