Documentation Mercado Libre

Check out all the necessary information about APIs Mercado Libre.
circulos azuis em degrade

Documentation

Last update 28/12/2022

Deal of the day (DOD)

Sellers are regularly invited to participate in different website promotions. If you received an invitation to participate in a daily deal and want to join, use the resources below.





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