Co-Funded Campaigns

Sellers are regularly invited to participate in different website campaigns.
The main characteristic of this type of campaign is that Mercado Libre pays a percentage of the offered discount.
If you received an invitation and want to join, use the resources below.

Check campaign details

For Deal promotion details, perform the query below:

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

Response:

{
  "id": "P-MLB1806015",
  "type": "MARKETPLACE_CAMPAIGN",
  "status": "started",
  "start_date": "2023-04-20T02:00:00Z",
  "finish_date": "2023-08-01T02:00:00Z",
  "deadline_date": "2023-08-01T01:00:00Z",
  "name": "Campanha de teste v2",
  "benefits": {
      "type": "REBATE",
      "meli_percent": 5,
      "seller_percent": 25
  }
}

Specific campaign fields

Benefits: promotion benefit details.

• type: type of benefit.
• meli_percent: percentage contributed by Mercado Libre.

Status

Find below the different co-funded campaign statuses:

Check campaign items

Perform the query below to see candidate items and/or the items included in a co-funded campaign:

Request:

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

Response:

{
  "results": [
      {
          "id": "MLB3293401659",
          "status": "started",
          "price": 700,
          "original_price": 1000,
          "offer_id": "OFFER-MLB3293401659-177366",
          "meli_percentage": 5,
          "seller_percentage": 25,
          "start_date": "2023-04-23T23:06:53Z",
          "end_date": "2023-08-01T02:00:00Z"
      }
  ],
  "paging": {
      "offset": 0,
      "limit": 50,
      "total": 1
  }
}

When a new campaign is created, all applicable items are selected. The initial item (status) is "candidate" with no assigned offer id. When the seller adds an item to the campaign, item status changes and a unique "offer_id" is assigned.

Item status

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

Indicate items for a campaign

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

Request:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' \
-d '{
   "promotion_id":"$PROMOTION_ID",
   "promotion_type":"$PROMOTION_TYPE"
}'
https://api.mercadolibre.com/seller-promotions/items/$ITEM_ID?app_version=v2

Example:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' \
-d '{
   "promotion_id":"P-MLA147001",
   "promotion_type":"MARKETPLACE_CAMPAIGN"
}'
https://api.mercadolibre.com/seller-promotions/items/MLB3293401659?app_version=v2

Response:

{
  "offer_id": "OFFER-MLB3293401659-177366",
  "price": 700,
  "original_price": 1000
}

Parameters

promotion_id: promotion identification.
promotion_type: type of promotion (MARKETPLACE_CAMPAIGN).

Modify items

Since prices cannot be changed directly, follow the steps below to change the price of an item included in a volume discount campaign.

Steps:

• Delete the item from the campaign
• Change item price just like regular price synchronization
• Add the item back to the campaign


Note:
- Since items included in co-funded campaigns (marketplace campaign) have no fixed price, when the price of an included item rises, it will be automatically removed from the offer and you will not be able to add it back.
- We recommend checking if the item is participating in a volume discount campaign before making (manual or automatic) price changes.



Delete items

Perform the task below to delete Items for a Co-Funded Campaigns

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&offer_id=$OFFER_ID

Example:

curl -X DELETE -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://api.mercadolibre.com/seller-promotions/items/MLB1834747833?promotion_type=MARKETPLACE_CAMPAIGN&promotion_id=P-MLB379009&offer_id=MLB1834747833-9eafadd4-16d2-49ae-b272-9a7a34585cb8&app_version=v2'




Response: Status 200 OK




Next: Volume discount campaigns