Preditor de categorias

O novo recurso de preditor de categorias ajuda vendedores e desenvolvedores a preverem melhor em qual categoria eles devem publicar um item específico. Diferentemente do antigo sugestor, este novo permite reconhecer o domínio e os atributos que alcançam melhor qualidade nas publicações.
Atualmente, o novo preditor está disponível para todos os sites do Mercado Livre. Recomendamos que você atualize seu desenvolvimento e comece a utilizá-lo.

Veja nosso webinar sobre Predictor de categorias:




Conteúdos

→Novo preditor de categorias
    ↳Parâmetros obrigatórios
    ↳Parâmetros opcionais
    ↳Campos da resposta

→Antigo preditor de categorias
    ↳Sugestão por GET
    ↳Sugestão por POST
    ↳Parámetros
    ↳Campos da resposta
   


Novo preditor de categorias

Você poderá executar o GET em um item de cada vez para obter as categorias com os atributos a serem carregados para que a publicação tenha boa qualidade. Tenha em conta que o resultado será compostos por uma lista de sugestões a partir do título utilizado, sendo que o primeiro resultado é considerado de maior probabilidade.


Parâmetros obrigatórios

site_id: é o site no qual você publica.
q: é o título do artigo a prever e deve estar completamente no idioma do site.


Parâmetros opcionais

limit: o valor padrão será 4, mas pode chegar a 8, para que você possa definir um limite entre 1 e 8.
target: pode ser constituído por core ou classified, dependendo da vertical em que está sendo publicado.


Chamada:

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

Exemplo:

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

Resposta:

[
  {
    "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 da resposta

domain_id: ID do domínio previsto para o item.
domain_name: nome do domínio previsto.
category_id: ID da categoria prevista para o item.
category_name: nome da categoria prevista.
attributes: Lista de atributos para a categoria prevista.


Nota:
Esse recurso não retornará informações que o antigo category_predictor retornava; portanto, no caso dos campos path_from_root, shipping_modes e variations, eles podem ser obtidos no recurso /categories.

Antigo preditor de categorias

Importante:
Em breve, o antigo category_predict não estará disponível. Recomendamos que você migre seu desenvolvimento e comece a usar o novo recurso.

Parámetros

title: Título do produto a ser sugerido. Deve ser um título completo no idioma do site. Esse parâmetro é obrigatório.
category_from: Esse parâmetro aceita uma categoria de nível 1 e é utilizado para limitar a sugestão à subárvore que abrange da category_from como raiz. Esse parâmetro é opcional.
price: O preço do produto a ser sugerido. O objetivo desse parâmetro é apresentar mais informações para melhorar a sugestão. Esse parâmetro é opcional.
seller_id: ID do vendedor do produto a ser sugerido. O objetivo desse parâmetro é apresentar mais informações para melhorar a sugestão. Esse parâmetro é opcional.


Sugestão por GET

É possível usar o método GET para realizar a sugestão de um produto por vez.

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


Sugestão por POST

É possível usar o método POST para realizar a sugestão de múltiplos (até 1.000) produtos por vez. Recomenda-se a utilização desse método quando for preciso sugerir múltiplos produtos.

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


Campos de resposta

id: ID da categoria sugerida para o produto.
name: Nome da categoria sugerida.
prediction_probability: Confiabilidade da sugestão. Esse valor oscila entre [0, 1]: os valores mais próximos de zero indicam pouca confiabilidade, enquanto os mais próximos de 1, indicam alta confiabilidade.
path_from_root: Lista contendo as categorias que vão da raiz até a folha (categoria sugerida). Cada categoria é representada pelos atributos ID e NAME.
variations: Esse campo só é exibido quando a categoria sugerida aceita alterações.
shipping_modes: Tipos de envio aceitos pela categoria sugerida.