Documentación Mercado Libre
Descubre toda la información que debes conocer sobre las APIs de Mercado Libre.Documentación
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:
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