Predictor de categorías

El nuevo recurso de predicción de categorías ayuda a que los vendedores y desarrolladores puedan predecir, de la mejor manera, en qué categoría deberían publicar un artículo determinado. A diferencia del antiguo predictor, este nuevo nos permite reconocer el dominio y los atributos logrando una mejor calidad en las publicaciones.
Actualmente, el nuevo predictor está disponible para todos los sitios donde opera Mercado Libre. Te recomendamos migrar tu desarrollo y comenzar a utilizarlo.

Mira nuestro webinar sobre Predictor de categorías:




Contenidos

→Nuevo predictor de categorías
    ↳Parámetros obligatorios
    ↳Parámetros opcionales
    ↳Campos de respuesta

→Antiguo predictor de categorías
    ↳Predicción mediante GET
    ↳Predicción mediante POST
    ↳Parámetros
    ↳Campos de respuesta
   


Nuevo 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 https://api.mercadolibre.com/sites/$SITE_ID/domain_discovery/search?q=$Q

Ejemplo:

curl -X GET 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.


Nota:
Este predictor no devolverá información que el category_predictor antiguo retornaba, por lo tanto en el caso de los campos path_from_root, shipping_modes y variations podrán obtenerse del recurso /categories.

Antiguo predictor de categorías

Importante:
Próximamente, el antiguo predictor de categorías no estará disponible. Te recomendamos migrar tu desarrollo y comenzar a utilizar el nuevo predictor de categorías.


Predicción mediante GET

Es posible utilizar el método GET para predecir un artículo por vez:

curl -X GET https://api.mercadolibre.com/sites/MLB/category_predictor/predict?title=Ipod%20Touch%20Apple%2016gb%205%20Gera%C3%A7%C3%A3o`

Predicción mediante POST

Es posible utilizar el método POST para predecir múltiples (hasta 1.000) artículos por vez. Se recomienda este método cuando es necesario predecir múltiples items.

curl -X POST -H "Content-Type: application/json" -d '[{"title": "Ipod Touch Apple 16gb 5 Geração","category_from": "MLB1743"},{"title": "Ipod Touch Apple 16gb 5 Geração","category_from": "MLB1743"}]' https://api.mercadolibre.com/sites/MLB/category_predictor/predict

Parámetros

title: el título del artículo a predecir. Debe ser un título completo en el idioma del sitio. Este parámetro es obligatorio.
category_from: este parámetro acepta una categoría de nivel 1 y se utiliza para limitar la predicción al subárbol que abarca desde category_from hasta la raíz. Este parámetro es opcional.
price: el precio del artículo a predecir. El objetivo de este parámetro es ofrecer información adicional para mejorar la predicción. Este parámetro es opcional.
seller_id: ID del vendedor del artículo a predecir. El objetivo de este parámetro es ofrecer información adicional para mejorar la predicción. Este parámetro es opcional.


Campos de respuesta

id: es el ID de la categoría predicha para el artículo.
name: es el nombre de la categoría predicha.
prediction_probability: es la confiabilidad de la predicción. Este valor oscila entre [0, 1]: los valores más próximos a cero indican poca confiabilidad mientras que los más cercanos próximos 1 indican alta confiabilidad.
path_from_root: es la lista con las categorías desde la raíz hasta la hoja (la categoría predicha). Cada categoría está representada por los atributos ID y NAME.
variations: sólo aparece cuando la categoría predicha soporta variaciones.
shipping_modes: modos de envío soportados por la categoría predicha.