Documentación Mercado Libre

Descubre toda la información que debes conocer sobre las APIs de Mercado Libre.
circulos azuis em degrade

Documentación

Última actualización 10/07/2024

Daily deal

Sellers are regularly invited to participate in different website promotions. If you received an invitation to participate in a daily deal and want to join, use the resources below.





Check items in a daily deal

Perform the query below to check the items included in a daily deal.


Request:

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

Example:

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
   }
}

Response fields

id: item identification.
start_date: campaign start date.
finish_date: campaign end date.
status: promotion item status. (see table)
price: promotion item price. In case the status of the item is candidate, it refers to the suggested price.
max_discounted_price: is the lowest price at which that promotion can be offered.
min_discounted_price:mis the highest price allowed for that promotion (i.e. the lowest discount allowed).
stock: information value of minimum item stock when a candidate goes to a promotion.


Item status

The table below shows the possible item status in this type of promotion.

Status Description
candidate Candidate item to participate in the promotion.
pending Programmed promotion item.
started Promotion active item.
finished Item deleted from campaign.


Specify items for a daily deal

Once you are invited to participate in a deal of the day, you can specify the candidates to be included.

Request:

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 

Example:

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

Response:

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

Parameters

deal_price: promotion item price.
promotion_type: type of promotion DOD (deal of the day).


Delete items

Note:
Once activated, offers cannot be removed. Due to their short duration, we expect the seller to commit to keeping them active throughout their cycle. However, if the seller no longer wishes to offer the promotion, they canpause the item.

Use this resource to remove an item offer.

Request:

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

Example:

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

Response: Status 200 OK



Next post: Lightning Deal