Documentation Mercado Libre

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

Documentation

Last update 26/02/2024

Deals of the day

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 following resources.





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

--header 'X-Caller-Id: merchant_id' \
--header 'version: v2' \
--header 'X-Client-Id: merchant_id' \

Example:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://api.mercadolibre.com/marketplace/seller-promotions/promotions/DOD-MLM1000/items?user_id=1317418851' \
--header 'version: v2' \
--header 'X-Caller-Id: 1317417907' \
--header 'X-Client-Id: 1317417907' \

Response:

{
   "results": [
       {
           "id": "MLM2184798066",
           "status": "candidate",
           "price": 30,
           "original_price": 0,
           "currency_id": "USD",
           "start_date": "2024-02-16T21:00:00",
           "finish_date": "2024-02-17T20:59:59",
           "max_discounted_price": 25.7,
           "min_discounted_price": 0.5
       },
       {
           "id": "MLM2184694464",
           "status": "candidate",
           "price": 100,
           "original_price": 0,
           "currency_id": "USD",
           "start_date": "2024-02-16T21:00:00",
           "finish_date": "2024-02-17T20:59:59",
           "max_discounted_price": 85.5,
           "min_discounted_price": 1.7
       },
       {
           "id": "MLM2184616078",
           "status": "candidate",
           "price": 130,
           "original_price": 0,
           "currency_id": "USD",
           "start_date": "2024-02-16T21:00:00",
           "finish_date": "2024-02-17T20:59:59",
           "max_discounted_price": 111.2,
           "min_discounted_price": 2.3
       }
   ],
   "paging": {
       "offset": 0,
       "limit": 50,
       "total": 3,
       "searchAfter": ""
   }
}

Response fields:

  • id: item identification.
  • start_date: campaign start date.
  • finish_date: campaign end date.
  • status: promotion item status. (see table)
  • currency_id:
  • price: promotion item price. In case the status of the item is candidate, it refers to the suggested price.
  • original_price: current item price.
  • max_discounted_price: is the lowest price at which that promotion can be offered.
  • min_discounted_price: is the highest price allowed for that promotion (i.e. the lowest discount allowed).

Item status

The table below shows the possible item status in this type of promotion.


Status Description
candidate Candidate item to participate in the promotion.
pending Programmed promotion item.
started Promotion active item.
finished Item deleted from campaign.

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 'https://api.mercadolibre.com/marketplace/seller-promotions/items/MLM2184798066?user_id=1317418851' \
    --header 'Authorization: Bearer' \
    --header 'version: v2' \
    --header 'X-Caller-Id: 1317417907' \
    --header 'X-Client-Id: 1317417907' \
    
    --data '{
        "deal_id": "DOD-MLM1000",
        "original_price": 30,
        "deal_price": 20,
        "promotion_type": "DOD"
    }

Response:

{
    "price": 20,
    "original_price": 30,
    "currency_id": "USD"
}

Parameters

  • deal_price: promotion item price.
  • original_price: item price before included in the promotion.
  • start_date discount start date.
  • promotion_type: type of promotion“deal of the day” (DOD).

Delete items

Use this resource to remove an item offer.


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&promotion_id=$DEAL_ID
    --header 'Authorization: Bearer ' \
    --header 'X-Caller-Id:  \
    --header 'X-Client-Id:  \
    --header 'version: v2' \

Example:

curl -X DELETE -H 'https://api.mercadolibre.com/marketplace/seller-promotions/items/MLM2184798066?user_id=1317418851&promotion_type=DOD&promotion_id=DOD-MLM1000'\
    --header 'Authorization: Bearer ' \
    --header 'X-Caller-Id: 1317417907' \
    --header 'X-Client-Id: 1317417907' \
    --header 'version: v2' \

Response: Status 200 OK



Next: Lightning Deal (LIGHTNING).