Traditional Campaigns

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:

Status	Description
pending	Promotion approved but not yet started.
started	Active promotion.
finished	Finished promotion.

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.

Status	Description
candidate	Item eligible for deal.
pending	Item sent to deal but not started.
started	Item with deal already started.
finished	Item deleted from 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