Documentação do Mercado Livre

Confira todas as informações necessárias sobre as APIs Mercado Livre.
circulos azuis em degrade

Documentação

Última atualização em 05/12/2023

Ofertas do dia

Importante:
A partir de 10 de janeiro de 2024 eliminaremos a versão anterior do recurso /seller-promotions.
Para obter a resposta com a nova versão, envie a query param app_version=v2. Consulte a documentação de cada campanha para conhecer as mudanças.

Os vendedores são convidados periodicamente a participar de diversas promoções que acontecem no site. Se você recebeu o convite para participar de uma oferta do dia e deseja ingressar, poderá fazê-lo com os seguintes recursos.





Consultar itens de campanha

Para conhecer os itens que fazem parte de uma oferta do dia faça a seguinte consulta:


Chamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://api.mercadolibre.com/seller-promotions/promotions/$PROMOTION_ID/items?promotion_type=DOD&app_version=v2'

Exemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/seller-promotions/promotions/DOD-MLB1000/items?promotion_type=DOD&app_version=v2

Response:

{
   "results": [
       {
           "id": "MLB3500438494",
           "start_date": "2023-04-20T00:00:00",
           "finish_date": "2023-04-20T23:59:59",
           "status": "candidate",
           "price": 3900,
           "original_price": 4000,
           "max_discounted_price": 3960,
           "min_discounted_price": 1200,
           "stock": {
                 "min": 1,
                 "max": 5
             }


       },


{
           "id": "MLB833682552",
           "start_date": "2023-04-20T00:00:00",
           "finish_date": "2023-04-20T23:59:59",
           "status": "candidate",
           "price": 4900,
           "original_price": 5000,
           "max_discounted_price": 4960,
           "min_discounted_price": 2200,
           "stock": {
                 "min": 1,
                 "max": 5
             }


       },
{
           "id": "MLB915917360",
           "start_date": "2023-04-20T00:00:00",
           "finish_date": "2023-04-20T23:59:59",
           "status": "candidate",
           "price": 5900,
           "original_price": 6000,
           "max_discounted_price": 5960,
           "min_discounted_price": 3200,
           "stock": {
                 "min": 1,
                 "max": 5
             }


       }


   ],
   "paging": {
       "offset": 0,
       "limit": 50,
       "total": 3
   }
}

Campos de respuesta

id: identificador do item.
start_date: data de início da campanha.
finish_date: data de término da campanha.
status: status do item na promoção. (Veja a tabela)
price: preço do item na promoção. Caso o status do item seja candidato, refere-se ao preço sugerido.
original_price: preço atual do item.
max_discounted_price: é o preço de valor mais baixo pelo qual essa promoção pode ser oferecida.
min_discounted_price: é o preço mais alto permitido para aquela promoção (ou seja, o menor desconto permitido).
stock: valor informativo sobre o stock mínimo que você deve ter do item ao enviar um candidato em uma promoção.


Estados do item

Na tabela a seguir você encontra os possíveis estados que os itens podem assumir neste tipo de promoção.

Estados Descrição
candidate Candidato a participar da promoção.
pending Promoção programada.
started Ativo na promoção.
finished Eliminado da campanha.


Indicar itens

Após ser convidado a participar de uma oferta do dia, você pode indicar quais produtos candidatos deseja incluir nela.

Chamada:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' 
-d '{ 
   "deal_price":"deal_price",
   "promotion_type":"$PROMOTION_TYPE"
}' 
https://api.mercadolibre.com/seller-promotions/items/$ITEM_ID?app_version=v2 

Exemplo:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' 
-d '{ 
   "deal_price": 14999,
   "promotion_type":"DOD"
}' 
https://api.mercadolibre.com/seller-promotions/items/MLA876768946?app_version=v2

Resposta:

{
  "price": 14999,
  "original_price": 17000
}

Parâmetros

deal_price: preço do item na promoção.
promotion_type: tipo de promoção DOD (oferta do dia).


Eliminar itens

Com este recurso você poderá eliminar a oferta do item.

Chamada:

curl -X DELETE -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/seller-promotions/items/$ITEM_ID?app_version=v2&promotion_type=$PROMOTION_TYPE

Exemplo:

curl -X DELETE -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/seller-promotions/items/MLA632979587??app_version=v2&promotion_type=DOD'

Seguinte: Ofertas relâmpago