Deals of the day

Check items in a deal of the day

Request:

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

--header 'X-Caller-Id: {CALLER_ID}' \
--header 'version: v2' \
--header 'X-Client-Id: {CLIENT_ID}' \

Example:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://api.mercadolibre.com/marketplace/seller-promotions/promotions/DOD-MLM1000/items?user_id=1317418851' \
--header 'version: v2' \
--header 'X-Caller-Id: 1317417907' \
--header 'X-Client-Id: 1317417907' \

Response:

{
   "results": [
       {
           "id": "MLM2184798066",
           "status": "candidate",
           "price": 30,
           "original_price": 0,
           "currency_id": "USD",
           "start_date": "2024-02-16T21:00:00",
           "finish_date": "2024-02-17T20:59:59",
           "max_discounted_price": 25.7,
           "min_discounted_price": 0.5
       },
       {
           "id": "MLM2184694464",
           "status": "candidate",
           "price": 100,
           "original_price": 0,
           "currency_id": "USD",
           "start_date": "2024-02-16T21:00:00",
           "finish_date": "2024-02-17T20:59:59",
           "max_discounted_price": 85.5,
           "min_discounted_price": 1.7
       },
       {
           "id": "MLM2184616078",
           "status": "candidate",
           "price": 130,
           "original_price": 0,
           "currency_id": "USD",
           "start_date": "2024-02-16T21:00:00",
           "finish_date": "2024-02-17T20:59:59",
           "max_discounted_price": 111.2,
           "min_discounted_price": 2.3
       }
   ],
   "paging": {
       "offset": 0,
       "limit": 50,
       "total": 3,
       "searchAfter": ""
   }
}

Response fields:

• id: item identification.
• start_date: campaign start date.
• finish_date: campaign end date.
• status: promotion item status. (see table)
• currency_id:
• price: promotion item price. In case the status of the item is candidate, it refers to the suggested price.
• original_price: current item price.
• max_discounted_price: is the lowest price at which that promotion can be offered.
• min_discounted_price: is the highest price allowed for that promotion (i.e. the lowest discount allowed).

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 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_id":"$DEAL_ID",
       "deal_price":$DEAL_PRICE,
       "original_price":$LIST_PRICE,
       "promotion_type":"$PROMOTION_TYPE"
    }
    https://api.mercadolibre.com/marketplace/seller-promotions/items/$ITEM_ID?user_id=$USER_ID

Example:

curl -X POST 'https://api.mercadolibre.com/marketplace/seller-promotions/items/MLM2184798066?user_id=1317418851' \
    --header 'Authorization: Bearer' \
    --header 'version: v2' \
    --header 'X-Caller-Id: 1317417907' \
    --header 'X-Client-Id: 1317417907' \
    
    --data '{
        "deal_id": "DOD-MLM1000",
        "original_price": 30,
        "deal_price": 20,
        "promotion_type": "DOD"
    }

Response:

{
    "price": 20,
    "original_price": 30,
    "currency_id": "USD"
}

Parameters

• deal_price: promotion item price.
• original_price: item price before included 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/marketplace/seller-promotions/items/$ITEM_ID?user_id=$USER_ID&promotion_type=DOD&promotion_id=$DEAL_ID
    --header 'Authorization: Bearer ' \
    --header 'X-Caller-Id:  \
    --header 'X-Client-Id:  \
    --header 'version: v2' \

Example:

curl -X DELETE -H 'https://api.mercadolibre.com/marketplace/seller-promotions/items/MLM2184798066?user_id=1317418851&promotion_type=DOD&promotion_id=DOD-MLM1000'\
    --header 'Authorization: Bearer ' \
    --header 'X-Caller-Id: 1317417907' \
    --header 'X-Client-Id: 1317417907' \
    --header 'version: v2' \

Response: Status 200 OK

Next: Lightning Deal (LIGHTNING).