Last update 25/08/2022

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 deal of the day

Perform the query below to check the items included in a deal of the day:


Example:

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

Response:

{
  "results": [
    {
           "id": "MLA833682552",
           "status": "candidate",
           "price": 2260,
           "original_price": 2429,
           "max_original_price": 3643,
           "stock": {
               "min": 20
           }
       },
       {
           "id": "MLA915916697",
           "status": "candidate",
           "price": 5070,
           "original_price": 5879,
           "max_original_price": 8818,
           "stock": {
               "min": 20
           }
       },
       {
           "id": "MLA915917360",
           "status": "candidate",
           "price": 5800,
           "original_price": 8260,
           "max_original_price": 12390,
           "stock": {
               "min": 20
           }
       },
       {
           "id": "MLA850940784",
           "status": "candidate",
           "price": 2530,
           "original_price": 2699,
           "max_original_price": 4198,
           "stock": {
               "min": 20
           }
       }
  ],
  "paging": {
    "offset": 0,
    "limit": 50,
    "total": 4
  }
}

Response fields

id: item identification.
status: promotion item status. (see table)
price: promotion item price. A candidate, item status makes reference to suggested price.
original_price: current item price.
max_original_price: maximum price for an item as original_price to participate in promotion.
stock: information value of minimum item stock when a candidate goes to a promotion.


Item status

The table below shows the possible item statuses 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 deal of the day.

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",
   "original_price":$LIST_PRICE,
   "promotion_type":"$PROMOTION_TYPE"
}' https://api.mercadolibre.com/seller-promotions/items/$ITEM_ID

Example:

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

Response:

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

Parameters

deal_price: promotion item price.
original_price: item price before inclusion in the promotion.
start_date: discount start date.
promotion_type: type of promotion “deal of the day” (DOD).


Delete items

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?promotion_type=$PROMOTION_TYPE

Example:

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

Response: Status 200 OK

Next post: Lightning Deal

banner footer

Subscribe to our Newletter

or register to recieve the latest news about our API