Pular para o conteúdo principal

Categorias de produtos

Encontrando a categoria​

A categoria é uma forma de classificar o seu produto dentro do Mercado Livre, e é importante classificar corretamente para possibilitar que a venda seja efetuada com sucesso, e também para expandir o alcance do seu anúncio.

Para definir a categoria existem duas formas principais:

  • Utilizando Preditor de Categorias
  • Fazendo uma requisição e analisando os tipos de categorias

Utilizando o Preditor de Categorias​

O preditor de categorias é um endpoint na qual você passa dois parâmetros obrigatórios e dois opcionais e ele retorna uma lista de exemplo de produtos classificados de forma adequada.

  • Obrigatórios:
    • SITE_ID: representa o id do Mercado Livre que você precisa, exemplo: MLB, MLA...
    • QUERY: representa o texto que você deseja pesquisar, utilize o título do produto, ou uma frase que você gostaria que estivesse relacionada com o seu anúncio
  • Opcionais:
    • limit: representa o número máximo de exemplos que serão retornados. Valor precisa estar no intervalo [1, 8].
    • target: pode ser constituído por core ou classified, dependendo da vertical em que está sendo publicado.

A chamada é feita da seguinte forma:

  curl -X GET -H 'Authorization: Bearer {ACCESS_TOKEN}' https://api.mercadolibre.com/sites/{SITE_ID}/domain_discovery/search?limit={limit}&target={target}&q={QUERY}

Exemplo, digamos que você queira publicar um anúncio de um iPhone no MLB e quer no máximo 3 exemplos de bons anúncios, você pode fazer a seguinte requisição:

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

Nesse caso foramm passados MLB (SITE_ID), celular iphone (QUERY) e 3 (limit)

Reposta:

[
  {
    domain_id: "MLB-CELLPHONES",
    domain_name: "Celulares",
    category_id: "MLB1055",
    category_name: "Celulares e Smartphones",
    attributes: [
      {
        id: "BRAND",
        name: "Marca",
        value_id: "9344",
        value_name: "Apple",
      },
      {
        id: "LINE",
        name: "Linha",
        value_id: "58993",
        value_name: "iPhone",
      },
    ],
  },
];

Perceba que o limit representa um valor máximo e não um valor exato da quantidade de elementos no retorno.

Com essas informações basta copiar e adequar ao seu produto em específico ou, caso esse resultado não seja satifatório, refinar a sua busca, melhorando os termos da query, e encontrar exemplos melhores.

Categorias do Site​

Outra forma de descobrir a qual categoria pertence o seu item é verificando as categorias que existem no site que você deseja publicar, as categorias de MLB não são necessariamente as mesmas de MLA. Para buscar essas categorias é necessário fazer uma requisição dessa forma:

  curl https://api.mercadolibre.com/sites/{SITE_ID}/categories

SITE_ID representa o id do site MLB, MLA, etc...

Exemplo:

  curl https://api.mercadolibre.com/sites/MLB/categories

Resposta:

[
  {
    id: "MLB5672",
    name: "Acessórios para Veículos",
  },
  {
    id: "MLB271599",
    name: "Agro",
  },
  {
    id: "MLB1403",
    name: "Alimentos e Bebidas",
  },
  {
    Restante das Categorias...
  }
];

Dessa forma você obtém todas as categorias que existem em um site específico, mas essas categorias possuem informações específicas, inclusive categorias filhas.

Atributos específicos de uma categoria​

Para buscar os atributos específicos de uma categoria é necessário ter o id da categoria (valor retornado no tópico anterior) e fazer a seguinte requisição:

  curl https://api.mercadolibre.com/categories/{CATEGORY_ID}

Onde CATEGORY_ID é o id da categoria desejada

Exemplo:

  curl https://api.mercadolibre.com/categories/MLB5672

Resposta:

  {
    "id": "MLB5672",
    "name": "Acessórios para Veículos",
    "picture": "https://http2.mlstatic.com/storage/categories-api/images/6fc20d84-2ce6-44ee-8e7e-e5479a78eab0.png",
    "permalink": "https://www.mercadolivre.com.br/c/acessorios-para-veiculos",
    "total_items_in_this_category": 133563998,
    "path_from_root": [
      {
        "id": "MLB5672",
        "name": "Acessórios para Veículos"
      }
    ],
    "children_categories": [
      {
        "id": "MLB1747",
        "name": "Aces. de Carros e Caminhonetes",
        "total_items_in_this_category": 15854474
      },
      {
        "id": "MLB1771",
        "name": "Aces. de Motos e Quadriciclos",
        "total_items_in_this_category": 2591284
      },
      {
        "id": "MLB6005",
        "name": "Acessórios Náuticos",
        "total_items_in_this_category": 111693
      },
      {
        Demais categorias filhas...
      }
    ],
    "attribute_types": "attributes",
    "settings": {
      "adult_content": false,
      "buying_allowed": true,
      "buying_modes": [
        "auction",
        "buy_it_now"
      ],
      "catalog_domain": "MLB-LIGHT_VEHICLE_ACCESSORIES",
      "coverage_areas": "not_allowed",
      "currencies": [
        "BRL"
      ],
      "fragile": false,
      "immediate_payment": "required",
      "item_conditions": [
        "used",
        "not_specified",
        "new"
      ],
      "items_reviews_allowed": false,
      "listing_allowed": false,
      "max_description_length": 50000,
      "max_pictures_per_item": 12,
      "max_pictures_per_item_var": 10,
      "max_sub_title_length": 70,
      "max_title_length": 60,
      "max_variations_allowed": 100,
      "maximum_price": null,
      "maximum_price_currency": "BRL",
      "minimum_price": 7,
      "minimum_price_currency": "BRL",
      "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_options": [
        "custom"
      ],
      "shipping_profile": "optional",
      "show_contact_information": false,
      "simple_shipping": "optional",
      "stock": "required",
      "sub_vertical": null,
      "subscribable": false,
      "tags": [
      ],
      "vertical": null,
      "vip_subdomain": "produto",
      "buyer_protection_programs": [
        "delivered",
        "undelivered"
      ],
      "status": "enabled"
    },
    "channels_settings": [
      {
        "channel": "mshops",
        "settings": {
          "minimum_price": 0
        }
      },
      {
        "channel": "proximity",
        "settings": {
          "status": "disabled"
        }
      },
      {
        "channel": "mp-merchants",
        "settings": {
          "buying_modes": [
            "buy_it_now"
          ],
          "immediate_payment": "required",
          "minimum_price": 1,
          "status": "enabled"
        }
      },
      {
        "channel": "mp-link",
        "settings": {
          "buying_modes": [
            "buy_it_now"
          ],
          "immediate_payment": "required",
          "minimum_price": 1,
          "status": "enabled"
        }
      }
    ],
    "meta_categ_id": null,
    "attributable": false,
    "date_created": "2018-04-25T08:12:56.000Z"
  }

Existem diversas regras definidas na resposta que um anúncio feito para essa categoria deve seguir, além disso, caso você queira melhorar o seu alcance e consequentemente as chances de seu produto ser encontrado, é recomendado que você faça a mesma requisição para a categoria filha que mais se adeque ao seu produto, e repita o processo recursivamente (para as filhas das filhas, e assim por diante) até que chegue a uma categoria sem filhos, isso vai filtrar melhor o seu produto dentro do Mercado Livre.

Bônus: Buscando produtos por categoria​

Você também pode procurar exemplos de publicações a partir do ID de uma categoria em específico fazendo uma requisição da seguinte forma:

  curl https://api.mercadolibre.com/sites/{SITE_ID}/search?category={CATEGORY_ID}

Encontrando assim exemplos de como montar sua própria requisição de inserção.

Exemplo:

  curl https://api.mercadolibre.com/sites/MLB/search?category=MLB5672