Traditional Campaigns

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

View campaign details

For DEAL promotion details, perform the query below:

Request:

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

Response:

{
  "id": "P-MLB1806019",
  "type": "DEAL",
  "status": "started",
  "start_date": "2023-04-20T03:00:00Z",
  "finish_date": "2023-08-01T02:00:00Z",
  "deadline_date": "2023-08-01T01:00:00Z",
  "name": "HOTSALE"
}

Status

Find below the different traditional campaign statuses:

View items in a campaign

Perform the query below to see the items included in a traditional campaign:

Request:

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

Response:

{
  "results": [
      {
          "id": "MLB3295112047",
          "status": "started",
          "price": 4000,
          "original_price": 5000,
          "top_deal_price": 3000
      },
      {
          "id": "MLB3293389813",
          "status": "candidate",
          "price": 0,
          "original_price": 3000.5,
          "min_discounted_price": 900.15
      },
      {
          "id": "MLB3500418540",
          "status": "candidate",
          "price": 0,
          "original_price": 2000,
          "min_discounted_price": 600
      },
      {
          "id": "MLB3500450682",
          "status": "candidate",
          "price": 0,
          "original_price": 3000,
          "min_discounted_price": 900
      },
      {
          "id": "MLB3500438432",
          "status": "candidate",
          "price": 0,
          "original_price": 3000.5,
          "min_discounted_price": 900.15
      }
  ],
  "paging": {
      "offset": 0,
      "limit": 50,
      "total": 5
  }
}

Parameters

id: id del ítem.
status: status of the item in the campaign.
price: price of the item in the campaign.
original_price: price of the item without discount.
min_discounted_price: minimum price that the seller can put on the item in the campaign. It is the biggest discount that the item can have.
top_deal_price: price of the item for the best buyers, with Mercado Puntos level 3 to 6. This field will only appear if the item is active in the campaign and if the seller entered a value for it at the time of adding the item to the campaign.

Item status

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

Indicate items for a campaign

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

Request:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN'
-d '{ 
   "deal_price":$DEAL_PRICE,
   "top_deal_price":$TOP_DEAL_PRICE
   "promotion_id":"$PROMOTION_ID"
   "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": 4000,
  "top_deal_price": 3000,
  "promotion_id": "P-MLB1806019",
  "promotion_type": "DEAL"
 }' 
https://api.mercadolibre.com/seller-promotions/items/MLB3295112047?app_version=v2

Response:

{
  "price": 4000,
  "top_price": 3000,
  "original_price": 5000
}

Parameters

deal_price: items price in the promotion.
top_deal_price: item price for best buyers, with Mercado Puntos level 3 to 6 (it is optional to report this price).
promotion_id: promotion identification.
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_price":$DEAL_PRICE,
   "top_deal_price":$TOP_DEAL_PRICE,
   "promotion_id":"$PROMOTION_ID"
   "promotion_type":"DEAL"
}'
https://api.mercadolibre.com/seller-promotions/items/$ITEM_ID?app_version=v2

Example:

curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN'
-d'{
  "deal_price": 3900,
  "top_deal_price": 3000,
  "promotion_id": "P-MLB1806019",
  "promotion_type": "DEAL"
 }'
https://api.mercadolibre.com/seller-promotions/items/MLB3295112047?app_version=v2

Response:

{
  "price": 3900,
  "top_price": 3000,
  "original_price": 5000
}

Delete items

Perform the task below to delete Items for a Traditional Campaign

Request:

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

Example:

curl -X DELETE -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://api.mercadolibre.com/seller-promotions/items/MLB3295112047?promotion_type=DEAL?promotion_type=DEAL&promotion_id=P-MLB1806019=&app_version_v2'

Resposta: Status 200 OK

Next: Co-funded campaigns