Concorrência no catálogo

No catálogo, as publicações competem para obter as vendas da página do produto e um algoritmo determina quem será o vencedor dessas vendas com base nas características da publicação e do próprio vendedor, como Preço da publicação, Parcelamento sem juros, Envio full, grátis ou no dia. Além disso, falaremos de "o vencedor" de uma maneira única, embora eventualmente o vendedor possa estar ganhando em geral, mas não em particular para certos usuários (por exemplo, se eles morarem muito longe e não receberem um envio no dia).

Conteúdos

→Receber notificações de publicações competindo no catálogo
→Conhecer o preço para ganhar
    ↳Conhecer a publicação que está ganhando um produto
    ↳Listagem de publicações para um produto


Receber notificações de publicações competindo no catálogo

Com o tópico Item competition você pode se inscrever e receber notificações das mudanças de status dos itens do catálogo, e permitirá que você reconheça o item que modifica seu status de competição para vencedor ou vice-versa. Para visualizar as informações do concorrente e analisar as condições sob as quais o vendedor está competindo para ganhar a página do produto, utilize o recurso /price_to_win para saber quais ações tomar.



Conhecer o preço para ganhar

Importante:
Os vendedores que compartilham condições de venda de seus produtos semelhantes às do vencedor do catálogo, têm uma parte de visibilidade na página do produto e seu status é "sharing_first_place".

Com o recurso /price_to_win?SiteId=$SITE_ID&version=v2 você reconhece o status da publicação do catálogo: pode estar ganhando, compartilhando primeiro, perdendo ou listado. O último significa que você tem motivos pelos quais o posto não está concorrendo.
Você também pode construir uma tabela de competição para comparar as condições dos itens e melhorá-los com base na competição. Com essa funcionalidade em seu desenvolvimento, os vendedores saberão quais condições melhorar para ganhar a página do produto.


Exemplo de item perdendo

Chamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/$ITEM_ID/price_to_win?siteId=$SITE_ID&version=v2
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/MLA123456789/price_to_win?siteId=MLA&version=v2

Resposta:

{
   "item_id": "MLA901414479",
   "current_price": 12999,
   "currency_id": "ARS",
   "price_to_win": 11500,
   "boosts": [
       {
           "id": "same_day_shipping",
           "status": "boosted",
           "description": "Envíos en el día por Mercado Envíos"
       },
       {
           "id": "fulfillment",
           "status": "opportunity",
           "description": "Mercado Envíos Full"
       },
       {
           "id": "free_installments",
           "status": "opportunity",
           "description": "Cuotas sin interés"
       },
       {
           "id": "free_shipping",
           "status": "not_apply",
           "description": "Envíos gratis por Mercado Envíos"
       },
       {
           "id": "shipping_collect",
           "status": "boosted",
           "description": "Mercado Envíos Colecta"
       }
   ],
   "status": "competing",
   "competitors_sharing_first_place": "null",
   "visit_share": "minimum",
   "consistent": true,
   "reason": [],
   "catalog_product_id": "MLA16107499",
   "winner": {
       "item_id": "MLA884484295",
       "price": 13499,
       "currency_id": "ARS",
       "boosts": [
           {
               "id": "same_day_shipping",
               "status": "boosted",
               "description": "Envíos en el día por Mercado Envíos"
           },
           {
               "id": "fulfillment",
               "status": "opportunity",
               "description": "Mercado Envíos Full"
           },
           {
               "id": "free_installments",
               "status": "boosted",
               "description": "Cuotas sin interés"
           },
           {
               "id": "free_shipping",
               "status": "not_apply",
               "description": "Envíos gratis por Mercado Envíos"
           },
           {
               "id": "shipping_collect",
               "status": "boosted",
               "description": "Mercado Envíos Colecta"
           }
       ]
   }
}

Exemplo de item ganhando

Chamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/$ITEM_ID/price_to_win?siteId=$SITE_ID&version=v2

Exemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/MLA123456789/price_to_win?siteId=MLA&version=v2

Resposta:

{
   "item_id": "MLA884484295",
   "current_price": 13499,
   "currency_id": "ARS",
   "price_to_win": 13499,
   "boosts": [
       {
           "id": "same_day_shipping",
           "status": "boosted",
           "description": "Envíos en el día por Mercado Envíos"
       },
       {
           "id": "fulfillment",
           "status": "opportunity",
           "description": "Mercado Envíos Full"
       },
       {
           "id": "free_installments",
           "status": "boosted",
           "description": "Cuotas sin interés"
       },
       {
           "id": "free_shipping",
           "status": "not_apply",
           "description": "Envíos gratis por Mercado Envíos"
       },
       {
           "id": "shipping_collect",
           "status": "boosted",
           "description": "Mercado Envíos Colecta"
       }
   ],
   "status": "winning",
   "competitors_sharing_first_place": "0",
   "visit_share": "maximum",
    "consistent": true,
   "reason": [],
   "catalog_product_id": "MLA16107499",
   "winner": {
       "item_id": "MLA884484295",
       "price": 13499,
       "currency_id": "ARS",
       "boosts": [
           {
               "id": "same_day_shipping",
               "status": "boosted",
               "description": "Envíos en el día por Mercado Envíos"
           },
           {
               "id": "fulfillment",
               "status": "opportunity",
               "description": "Mercado Envíos Full"
           },
           {
               "id": "free_installments",
               "status": "boosted",
               "description": "Cuotas sin interés"
           },
           {
               "id": "free_shipping",
               "status": "not_apply",
               "description": "Envíos gratis por Mercado Envíos"
           },
           {
               "id": "shipping_collect",
               "status": "boosted",
               "description": "Mercado Envíos Colecta"
           }
       ]
   }
}

Exemplo de item compartilhando primeiro

Nota:
O status “sharing_first_place” identifica todos os vendedores com a melhor oferta e um nível de exposição compartilhada no Catálogo.

Exemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/MLA123456710/price_to_win?siteId=MLA&version=v2

Resposta:

{
   "item_id": "MLA901414479",
   "current_price": 12999,
   "currency_id": "ARS",
   "price_to_win": 11500,
   "boosts": [
       {
           "id": "same_day_shipping",
           "status": "boosted",
           "description": "Envíos en el día por Mercado Envíos"
       },
       {
           "id": "fulfillment",
           "status": "opportunity",
           "description": "Mercado Envíos Full"
       },
       {
           "id": "free_installments",
           "status": "opportunity",
           "description": "Cuotas sin interés"
       },
       {
           "id": "free_shipping",
           "status": "not_apply",
           "description": "Envíos gratis por Mercado Envíos"
       },
       {
           "id": "shipping_collect",
           "status": "boosted",
           "description": "Mercado Envíos Colecta"
       }
   ],
   "status": "sharing_first_place",
   "competitors_sharing_first_place": "2",
   "visit_share": "medium",
   "consistent": true,
   "reason": [],
   "catalog_product_id": "MLA16107499",
   "winner": {
       "item_id": "MLA884484295",
       "price": 13499,
       "currency_id": "ARS",
       "boosts": [
           {
               "id": "same_day_shipping",
               "status": "boosted",
               "description": "Envíos en el día por Mercado Envíos"
           },
           {
               "id": "fulfillment",
               "status": "opportunity",
               "description": "Mercado Envíos Full"
           },
           {
               "id": "free_installments",
               "status": "boosted",
               "description": "Cuotas sin interés"
           },
           {
               "id": "free_shipping",
               "status": "not_apply",
               "description": "Envíos gratis por Mercado Envíos"
           },
           {
               "id": "shipping_collect",
               "status": "boosted",
               "description": "Mercado Envíos Colecta"
           }
       ]
   }
}

Exemplo de item que não concorre

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/MLA123456710/price_to_win?siteId=MLA&version=v2

Resposta:

{
   "item_id":"MLA123456710",
   "current_price":68000,
   "currency_id":"ARS",
   "price_to_win":null,
   "boosts":{
      "same_day_shipping":false,
      "fulfillment":false,
      "free_installments":false,
      "free_shipping":true,
      "cross_docking":false,
      "drop_off":true,
      "shipping_quarantine":false
   },
   "status":"listed",
   "competitors_sharing_first_place": null,
   "visit_share": "minimum",
   "reason":[
      "item_paused"
   ]
}

Campos da resposta

price_to_win: preço (na moeda atual da publicação) para ser o ganhador. Isto é que, fazendo um PUT ao recurso /itens com o preço sugerido, você garante ser o ganhador.
boosts: características da publicação que proporcionam chances de ganhar, tais como:

  • same_day_shipping: Envios no dia com Mercado Envios.
  • fulfillment: Mercado Envios Full.
  • free_installments: Parcelamento sem juros.
  • free_shipping: Frete grátis com Mercado Envios.
  • shipping_quarantine: Envio normal.
  • shipping_collect: Mercado Envios Coleta.
  • Agora, você pode reconhecer dentro do impulso o estado deles e desenhar uma tabela de comparação de acordo.

    Estado dos boost Detalhe
    boosted tem a condição de venda e atualmente aplica o aumento.
    not_boosted possui a condição de venda, mas não é um boost que aumenta as chances de ganhar.
    opportunity não possui condição de venda. Caso aplique, melhoraria as chances de ganhar.
    not_apply a condição de vendas não se aplica como um boost ao produto em que o item concorre.
    Nota:
    Essas informações permitem comparar rapidamente com a segunda listagem sobre a publicação do item que está ganhando a página do produto.

    status indica se o produto está ganhando para o público em geral ou para segmentos minoritários, como aqueles que não aproveitam o frete diário. Quando está ganhando, o valor está ganhando, caso contrário estará competindo por quem está perdendo e um novo valor é adicionado sharing_first_place para quando o primeiro lugar é compartilhado e eles são divididos entre todos aqueles que compartilhe o primeiro lugar em Com base em suas condições, os níveis de visibilidade na página do produto.

    competitors_sharing_first_place indica o número de vendedores que compartilham o primeiro lugar. Também vai depender dos estados:

    • Winning: Será 0, pois ser o vencedor leva todas as vendas e visibilidade no catálogo.
    • Competing: será null, já que ao perder tem que melhorar as condições para compartilhar o primeiro lugar ou ganhar.
    • Listed: será null, já que ao perder tem que melhorar as condições para compartilhar o primeiro lugar ou ganhar.
    • Sharing_first_place: número de vendedores competindo pelo primeiro lugar.

    visit_share: nível de visibilidade da publicação do catálogo. Os valores podem variar dependendo dos estados:

    • Winning: Sempre será maximum.
    • Competing: Sempre será minimum.
    • Sharing_first_place: Sempre será medium.

    reason: razão pela qual o item não está competindo. Os valores possíveis são:

    Reason Descrição
    non_trusted_seller O vendedor não está na lista de permissões de fraude. Não pode competir. Ele aparece nas listagens em segundo plano.
    reputation_below_threshold O vendedor não atinge a reputação mínima para ganhar. Não pode competir. Aparece apenas nas listagens.
    winner_has_better_reputation O vendedor tem uma reputação que pode competir, mas há um vencedor com uma reputação melhor. No momento, ele aparece apenas nas listagens (caixa amarela com vencedor verde).
    manufacturing_time O item possui manufacturing time, aparece apenas nas listagens e não pode vencer porque o vencedor possui estoque imediato.
    temporarily_winning_manufacturing_time O item possui manufacturing time, está ganhando temporariamente porque não há concorrentes no mesmo nível de reputação sem MF.
    temporarily_competing_manufacturing_time O item tiene manufacturing time, esta compitiendo temporalmente porque no hay competidores en el mismo nivel de reputación sin MF, el winner también tiene MF.
    temporarily_winning_best_reputation_available O vendedor não é verde, mas tem uma reputação que pode ganhar e é a melhor oferta disponível. Ele está ganhando temporariamente. Se uma oferta melhor aparecer, pare de ganhar.
    temporarily_competing_best_reputation_available O vendedor não é verde, mas é a melhor reputação disponível, está competindo temporariamente. O vencedor também é da mesma reputação. Se um best-seller aparecer, ele será listado apenas novamente.
    item_paused O item está em pausa, não pode ser listado.
    item_not_opted_in O item não fiz opt in, não pode ser listado ou é um item de teste.

    Neste chamado, você deverá utilizar um item_id de uma publicação de catálogo, no caso de não poder fazê-lo, você obterá um código de erro 4XX.
    Além disso, existem variáveis como a reputação, que são utilizadas para determinar o ganhador. Contudo, para um bom vendedor, as variáveis acima serão as utilizadas para determinar o ganhador.

    Conheçer a publicação que está ganhando um produto

    Usando o recurso de /products/{product_id} , além de conhecer as características e o status do produto, você pode reconhecer a publicação que está ganhando a página do produto com o campo buy_box_winner.



    Listagem de publicações para um produto

    Se você precisar conhecer quais são os itens (de todos os vendedores) que concorrem pelas vendas de um produto em particular, tem um recurso que entrega a você essas informações.

    Chamada:

    curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/products/$PRODUCT_ID/items

    Exemplo:

    curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/products/MLB6309815/items

    Resposta simplificada:

    {
      "paging": {
        "total": 7,
        "offset": 0,
        "limit": 100
      },
      "results": [
        {
          "item_id": "MLA824759321",
          "category_id": "MLA1055",
          "seller_id": 90205574,
          "price": 13999,
          "currency_id": "ARS",
          "sold_quantity": 0,
          "available_quantity": 1,
          "installments": {
            "quantity": 1,
            "amount": 13999,
            "rate": 0,
            "currency_id": "ARS"
          },
          "shipping": {
            "mode": "me2",
            "tags": [
              "mandatory_free_shipping"
            ],
            "free_shipping": true,
            "logistic_type": "fulfillment",
            "store_pick_up": false
          },
          "warranty": "Garantía de fábrica: 1 años",
          "condition": "new",
          "sale_terms": [
            {
              "id": "INVOICE",
              "name": "Facturación",
              "value_id": "6891885",
              "value_name": "Factura A",
              "value_struct": null
            },
            {
              "id": "WARRANTY_TYPE",
              "name": "Tipo de garantía",
              "value_id": "2230279",
              "value_name": "Garantía de fábrica",
              "value_struct": null
            },
            {
              "id": "WARRANTY_TIME",
              "name": "Tiempo de garantía",
              "value_id": null,
              "value_name": "1 años",
              "value_struct": {
                "number": 1,
                "unit": "años"
              }
            }
          ],
          "official_store_id": null,
          "original_price": null,
          "listing_type_id": "gold_special",
          "accepts_mercadopago": true,
          "seller_address": {
            "city": {
              "id": "TUxBQ0xBWmI3M2Q3",
              "name": "Santa Fe"
            },
            "state": {
              "id": "TUxBUFNBTmU5Nzk2",
              "name": "Santa Fe"
            },
            "neighborhood": {
              "id": "TUxBQk9UUjQyMjJa",
              "name": "Otros Barrios"
            }
          },
          "international_delivery_mode": "none",
          "tags": [
            "extended_warranty_eligible",
            "good_quality_picture",
            "good_quality_thumbnail",
            "immediate_payment",
            "cart_eligible"
          ],
          "tier": ""
        },
        {},
        {},
        {},
        {},
        {},
        {}
      ]
    }

    Tenha em conta que em "results" terá os itens que estão competindo para ganhar esse produto.

    Filtro

    available_filters como parâmetro na URI é possível.

    Atualmente, você tem as seguintes opções de filtragem:

    Parâmetro Valor Descrição
    official_store all Para mostrar apenas produtos com vencedor de Lojas Oficiais.
    official_store_id id Para mostrar os produtos vencedores de uma loja oficial.
    discount 10-100 Para mostrar os produtos vencedores com desconto maior ou igual a 10%.
    price 100-200 Para produtos vencedores com preço entre 100 e 200.
    *100 para produtos com vencedor com preço maior ou igual a 100.
    *200 para produtos com vencedor com preço menor ou igual a 200.
    installments no_interest Para produtos com vencedor com parcelamentos sem juros.
    shipping fulfillment Para produtos com vencedor com FBM.
    shipping mercadoenvios Para produtos com vencedor sem FBM.
    shipping_cost free Para produtos com vencedor com frete grátis.
    shipping_time sameday/ nextday Deve ser usado junto com a query param b.buyer_zones, que indica em quais áreas o comprador está localizado.
    seller_id id Obter o vencedor user_id

    Exemplo:

    curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/products/MLB6309815/items?shipping=free

    Conheça mais sobre Concorrência em catálogo.


    Seguinte: Destaque especial "Recomendado".

ou registre-se para receber as últimas notícias sobre nossa API