Categorización de productos
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
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:
Siguiente: Publica productos.