Documentation Mercado Libre
Check out all the necessary information about APIs Mercado Libre.
Documentation
Deal of the day (DOD)

Check items in a deal of the day
Request:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/marketplace/seller-promotions/promotions/DOD-MLA1000/items?promotion_type=DOD
Example:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/marketplace/seller-promotions/promotions/DOD-MLM1000/items?user_id=481244699
Response:
{
"results": [
{
"id": "MLM745913661",
"status": "candidate",
"price": 26.05,
"original_price": 0,
"currency_id": "USD",
"stock": {
"min": 10,
"max": 15
}
},
{
"id": "MLM755504940",
"status": "candidate",
"price": 22.2,
"original_price": 0,
"currency_id": "USD",
"stock": {
"min": 10,
"max": 15
}
},
{
"id": "MLM755504940",
"status": "pending",
"price": 22.2,
"original_price": 0,
"currency_id": "USD"
}
],
"paging": {
"offset": 0,
"limit": 50,
"total": 3
}
}
Response fields
id: item identification.
status: promotion item status.
- candidate: candidate item to participate in the promotion.
- pending: programmed promotion item
- started: promotion active item
price: promotion item price. A candidate, item status makes reference to suggested price.
original_price: current item price.
max_original_price: maximum price for an item as original_price to participate in promotion.
stock: information value of minimum item stock when a candidate goes to a promotion.
Specify items for a deal of the day.
Once you are invited to participate in a deal of the day, you can specify the candidates to be included.
Request:
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -d
{
"deal_id":"$DEAL_ID",
"deal_price":$DEAL_PRICE,
"original_price":$LIST_PRICE,
"promotion_type":"$PROMOTION_TYPE"
}
https://api.mercadolibre.com/marketplace/seller-promotions/items/$ITEM_ID?user_id=$USER_ID
Example:
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -d
{
"deal_id": "DOD-MLM1000",
"original_price": 21.89,
"deal_price": 15,
"promotion_type": "DOD"
}
https://api.mercadolibre.com/marketplace/seller-promotions/items/MLM755504940?user_id=481244699
Response:
{
"price": 15,
"original_price": 21.89,
"currency_id": "USD"
}
Parameters
deal_price: promotion item price.
original_price: item price before inclusion in the promotion.
promotion_type: type of promotion“deal of the day” (DOD).
Delete item deal
Request:
curl -X DELETE -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/marketplace/seller-promotions/items/$ITEM_ID?user_id=$USER_ID&promotion_type=DOD&deal_id=$DEAL_ID
Example:
curl -X DELETE -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/marketplace/seller-promotions/items/MLM755504940?user_id=481244699&promotion_type=DOD&deal_id=DOD-MLM1000
Next post: Lightning Deal (LIGHTNING).