Last update 25/08/2022

Traditional Campaigns

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.

 



Consult Traditional 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/MLA686?promotion_type=DEAL

Response:

{
  "id": "MLA686",
  "type": "DEAL",
  "status": "started",
  "start_date": "2019-02-04T17:50:00Z",
  "finish_date": "2020-10-31T17:20:00Z",
  "deadline_date": "2020-09-30T02:00:00Z",
  "name": "HOTSALE"
}

Check manage promotions to see the details of each response field.

 

Status

Find below the different traditional campaign statuses:

Status Description
pending promotion approved but not yet started.
started active promotion.
finished finished promotion.



Check Items in a Traditional 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/MLB1234/items?promotion_type=DEAL'

Response:

{
   "results": [
       {
           "id": "MLB21995793456",
           "status": "candidate",
           "price": 0,
           "original_price": 0
       },
       {
           "id": "MLB2199578643",
           "status": "candidate",
           "price": 0,
           "original_price": 0
       },
         ],
   "paging": {
       "offset": 0,
       "limit": 50,
       "total": 2
   }
}

 

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
Nota:
The new campaigns have items with candidate status, but there are still old campaigns that do not have items with this status.

Specify Items for a Traditional 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_id":"$DEAL_ID",
   "regular_price":$REGULAR_PRICE,
   "deal_price":$DEAL_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_id":"MLA1804",
   "regular_price":350,
   "deal_price":240,
   "promotion_type":"DEAL"
}' 
https://api.mercadolibre.com/seller-promotions/items/MLA876768946

Response:

{
  "price": 240,
  "original_price": 350
}

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).

 

Change 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/seller-promotions/items/$ITEM_ID

Example:

curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN'
-d'{
   "deal_id":"MLA1804",
   "regular_price":350,
   "deal_price":220,
   "promotion_type":"DEAL"
}'
https://api.mercadolibre.com/seller-promotions/items/MLB1676902612

Response:

{
  "price": 220,
  "original_price": 350
}

 

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&deal_id=$DEAL_ID'

Example:

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

 

Resposta: Status 200 OK

 

Next Post: Mercado Libre co-funded campaigns

banner footer

Subscribe to our Newletter

or register to recieve the latest news about our API