Sales events (DEAL)

Sellers advised by Mercado Libre commercial team are regularly invited to participate in different website campaigns. If you received an invitation of a specific campaign and want to join, use the resources below.



Contents

→Sales events details
→Items in a Sales events
→Filtering by items and status
→Specify items for a Sales events
→Modify items
→Delete items


Sales events details

Example:

curl -H 'Authorization: Bearer $ACCESS_TOKEN' -X GET https://api.mercadolibre.com/marketplace/seller-promotions/promotions/MLM1907?promotion_type=DEAL&user_id=523132944

Response:

{
   "id": "MLM1907",
   "type": "DEAL",
   "status": "started",
   "start_date": "2020-01-31T07:59:00Z",
   "finish_date": "2022-11-01T16:59:00Z",
   "deadline_date": "2021-02-01T16:59:00Z",
   "name": "Name Deal"
}

You can check the response fields in Manage promotions to see the details of each.


Possible status

pending: promotion approved but not yet started.
started: active promotion.
finished: finished promotion.


Items in a Sales events

Example:

curl -H 'Authorization: Bearer $ACCESS_TOKEN' -X GET https://api.mercadolibre.com/marketplace/seller-promotions/promotions/MLM1907/items?user_id=523132944

Response:

{
   "results": [
       {
           "id": "MLM831246926",
           "status": "rejected",
           "price": 5.68,
           "original_price": 15.13,
           "currency_id": "USD"
       },
       {
           "id": "MLM831248496",
           "status": "pending_approval",
           "price": 100,
           "original_price": 327.65,
           "currency_id": "USD"
       },
       {
           "id": "MLM831320922",
           "status": "rejected",
           "price": 90,
           "original_price": 327.65,
           "currency_id": "USD"
       }
   ],
   "paging": {
       "offset": 0,
       "limit": 50,
       "total": 3
   }
}

Possible item status

approved: item approved for a deal.
pending_approval: item pending approval for a deal.
rejected: item rejected for a deal.


Filtering by items and status


Request:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/seller-promotions/promotions/$PROMOTION_ID?promotion_type=DEAL&status=$STATUS&item_id=$ITEM_ID

Filtering by item example:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' /seller-promotions/promotions/MLM860/items?promotion_type=DEAL&item_id=MLM1300001800

Response:

{
   "results": [
       {
           "id": "MLM1300001800",
           "status": "approved",
           "price": 439.11,
           "original_price": 462.18
       }
   ],
   "paging": {...}
}

Filtering by approved status example:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' /seller-promotions/promotions/MLM860/items?promotion_type=DEAL&status=approved

Response:

{
   "results": [
      {
            "id": "MLM1300041716",
            "status": "approved",
            "price": 372.71,
            "original_price": 392.37
        },
        {
            "id": "MLM1300041766",
            "status": "approved",
            "price": 358.47,
            "original_price": 377.33
        },
],
   "paging": [...]
}

Specify items for a Sales events

Once you are invited to participate in a campaign, you can specify the products to be included.

Request:

curl -H 'Authorization: Bearer $ACCESS_TOKEN' -X POST -d 
{
	"deal_id": "$DEAL_ID",
	"regular_price": "$REGULAR_PRICE",
	"deal_price": "$DEAL_PRICE",	
	"promotion_type": "DEAL"
}
https://api.mercadolibre.com/marketplace/seller-promotions/items/$ITEM_ID&user_id=$USER_ID

Example:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -d 
{ 
   "deal_id":"MLM1907",
   "regular_price":327.65,
   "deal_price":100,
   "promotion_type":"DEAL"
} 
https://api.mercadolibre.com/marketplace/seller-promotions/items/MLM831248496&user_id=523132944

Response:

{
  "price": 100,
  "original_price": 327.65,
  "currency_id": "USD"
}

Parameters

deal_id: promotion identification.
regular_price: item price before inclusion in the promotion.
deal_price: promotion item price.
promotion_type: type of promotion (DEAL).

 

Modify items

Perform the task below to change promotion items:

Request:

curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' -d 
{
	"deal_id": "$DEAL_ID",
	"regular_price": "$REGULAR_PRICE",
	"deal_price": "$DEAL_PRICE",	
	"promotion_type": "DEAL"
}
https://api.mercadolibre.com/marketplace/seller-promotions/items/$ITEM_ID&user_id=$USER_ID

Example:

curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' -d
{
   "deal_id":"MLM1907",
   "regular_price":327.65,
   "deal_price":220,
   "promotion_type":"DEAL"
}
https://api.mercadolibre.com/marketplace/seller-promotions/items/MLM831248496&user_id=523132944

Response:

{
  "price": 220,
  "original_price": 327.65,
  "currency_id": "USD"
}

Delete items

Request:

curl -H 'Authorization: Bearer $ACCESS_TOKEN' -X DELETE https://api.mercadolibre.com/marketplace/seller-promotions/items/$ITEM_ID?user_id=$USER_ID&promotion_type=$PROMOTION_TYPE&deal_id=$DEAL_ID

Example:

curl -H 'Authorization: Bearer $ACCESS_TOKEN' -X DELETE https://api.mercadolibre.com/marketplace/seller-promotions/items/MLM831320922?user_id=523132944&promotion_type=DEAL&deal_id=MLM1907

Next: Regular Deal (PRICE_DISCOUNT).