Documentación Mercado Libre
Descubre toda la información que debes conocer sobre las APIs de Mercado Libre.Documentación
Co-Funded Campaigns
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:
Status | Description |
---|---|
pending_approval | Promotion approved. |
pending | Promotion approved but not yet started |
started | active promotion. |
finished | finished promotion. |
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.
Status | Description |
---|---|
candidate | candidate item to participate in the promotion. |
pending | approved and programmed promotion item. |
started | campaign active item. |
finished | Item deleted from 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
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