The Listing Prices API it’s a read only resource that offers many ways to know the fees of listing an item in MercadoLibre, so a seller can know exactly how much it’s going to cost to list under a certain listing_type for a given site, category, currency and quantity.
Attribute description
| Attribute | Description |
| listing_type_id | Listing type ID |
| listing_type_name | Listing type name |
| listing_exposure | Listing exposure level |
| requires_picture | Shows if the listing type requires at least one picture |
| currency_id | Currency id of the fees |
| listing_fee_amount | Listing fee amount |
| selling_fee_amount | Selling fee amount |
Filter by price
Retrieves different listing types and each associated fee in the local currency where the item prices is 5000.
EXAMPLE
curl -X GET https://api.mercadolibre.com/sites/:site_id/listing_prices?price=5000
RESPONSE
[
{
"listing_type_id": "gold_pro",
"listing_type_name": "Oro Premium Sin Interés",
"listing_exposure": "highest",
"requires_picture": true,
"currency_id": "MXN",
"listing_fee_amount": 0,
"sale_fee_amount": 750,
"free_relist": false,
"stop_time": "2014-12-20T10:25:27.290-04:00"
},
{
"listing_type_id": "gold_premium",
"listing_type_name": "Oro Premium",
"listing_exposure": "highest",
"requires_picture": true,
"currency_id": "MXN",
"listing_fee_amount": 450,
"sale_fee_amount": 325,
"free_relist": false,
"stop_time": "2014-12-20T10:25:27.264-04:00"
},
{
"listing_type_id": "gold_special",
"listing_type_name": "Oro Profesional",
"listing_exposure": "highest",
"requires_picture": true,
"currency_id": "MXN",
"listing_fee_amount": 0,
"sale_fee_amount": 475,
"free_relist": false,
"stop_time": "2014-12-20T10:25:27.277-04:00"
},
{
"listing_type_id": "gold",
"listing_type_name": "Oro",
"listing_exposure": "high",
"requires_picture": true,
"currency_id": "MXN",
"listing_fee_amount": 175,
"sale_fee_amount": 325,
"free_relist": false,
"stop_time": "2014-12-20T10:25:27.260-04:00"
},
{
"listing_type_id": "silver",
"listing_type_name": "Plata",
"listing_exposure": "mid",
"requires_picture": false,
"currency_id": "MXN",
"listing_fee_amount": 50,
"sale_fee_amount": 325,
"free_relist": false,
"stop_time": "2014-12-20T10:25:27.270-04:00"
},
{
"listing_type_id": "bronze",
"listing_type_name": "Bronce",
"listing_exposure": "low",
"requires_picture": false,
"currency_id": "MXN",
"listing_fee_amount": 0,
"sale_fee_amount": 500,
"free_relist": false,
"stop_time": "2014-12-20T10:25:27.256-04:00"
},
{
"listing_type_id": "free",
"listing_type_name": "Gratuita",
"listing_exposure": "lowest",
"requires_picture": false,
"currency_id": "MXN",
"listing_fee_amount": 0,
"sale_fee_amount": 0,
"free_relist": false,
"stop_time": "2014-10-28T10:25:27.274-04:00"
}
]
By price and listing_type
Retrieves listing fee associated to listing type Gold in the local currency where the item price is 5000.
EXAMPLE
curl -X GET https://api.mercadolibre.com/sites/:site_id/listing_prices?price=5000&listing_type_id=gold
RESPONSE
[
{
"listing_type_id": "gold",
"listing_type_name": "Oro",
"listing_exposure": "high",
"requires_picture": true,
"currency_id": "MXN",
"listing_fee_amount": 175,
"sale_fee_amount": 325,
"free_relist": false,
"stop_time": "2014-12-20T10:26:20.115-04:00"
}
]
Filter by listing type and quantity
Retrieves different listing types and each associated fee in the local currency where the item price is 5000 and item quantity is 5.
EXAMPLE
curl -X GET https://api.mercadolibre.com/sites/:site_id/listing_prices?price=5000&quantity=5
RESPONSE
[
{
"listing_type_id": "gold_pro",
"listing_type_name": "Oro Premium Sin Interés",
"listing_exposure": "highest",
"requires_picture": true,
"currency_id": "MXN",
"listing_fee_amount": 0,
"sale_fee_amount": 750,
"free_relist": false,
"stop_time": "2014-12-20T10:26:34.546-04:00"
},
{
"listing_type_id": "gold_premium",
"listing_type_name": "Oro Premium",
"listing_exposure": "highest",
"requires_picture": true,
"currency_id": "MXN",
"listing_fee_amount": 1250,
"sale_fee_amount": 325,
"free_relist": false,
"stop_time": "2014-12-20T10:26:34.508-04:00"
},
{
"listing_type_id": "gold_special",
"listing_type_name": "Oro Profesional",
"listing_exposure": "highest",
"requires_picture": true,
"currency_id": "MXN",
"listing_fee_amount": 0,
"sale_fee_amount": 475,
"free_relist": false,
"stop_time": "2014-12-20T10:26:34.535-04:00"
},
{
"listing_type_id": "gold",
"listing_type_name": "Oro",
"listing_exposure": "high",
"requires_picture": true,
"currency_id": "MXN",
"listing_fee_amount": 875,
"sale_fee_amount": 325,
"free_relist": false,
"stop_time": "2014-12-20T10:26:34.496-04:00"
},
{
"listing_type_id": "silver",
"listing_type_name": "Plata",
"listing_exposure": "mid",
"requires_picture": false,
"currency_id": "MXN",
"listing_fee_amount": 250,
"sale_fee_amount": 325,
"free_relist": false,
"stop_time": "2014-12-20T10:26:34.518-04:00"
},
{
"listing_type_id": "bronze",
"listing_type_name": "Bronce",
"listing_exposure": "low",
"requires_picture": false,
"currency_id": "MXN",
"listing_fee_amount": 0,
"sale_fee_amount": 500,
"free_relist": false,
"stop_time": "2014-12-20T10:26:34.492-04:00"
},
{
"listing_type_id": "free",
"listing_type_name": "Gratuita",
"listing_exposure": "lowest",
"requires_picture": false,
"currency_id": "MXN",
"listing_fee_amount": 0,
"sale_fee_amount": 0,
"free_relist": false,
"stop_time": "2014-10-28T10:26:34.525-04:00"
}
]
Filter by price and category
Retrieves different listing types and each associated fee in the local currency where the item price is 5000 and the category is MLA1744.
EXAMPLE
curl -X GET https://api.mercadolibre.com/sites/:site_id/listing_prices?price=5000&category_id=MLA1744
RESPONSE
[
{
"listing_type_id": "gold_premium",
"listing_type_name": "Oro Premium",
"listing_exposure": "highest",
"requires_picture": true,
"currency_id": "ARS",
"listing_fee_amount": 250,
"sale_fee_amount": 0,
"free_relist": false,
"stop_time": "2014-12-20T10:27:09.174-04:00"
},
{
"listing_type_id": "gold",
"listing_type_name": "Oro",
"listing_exposure": "high",
"requires_picture": true,
"currency_id": "ARS",
"listing_fee_amount": 175,
"sale_fee_amount": 0,
"free_relist": false,
"stop_time": "2014-12-20T10:27:09.184-04:00"
},
{
"listing_type_id": "silver",
"listing_type_name": "Plata",
"listing_exposure": "mid",
"requires_picture": false,
"currency_id": "ARS",
"listing_fee_amount": 99,
"sale_fee_amount": 0,
"free_relist": false,
"stop_time": "2014-12-20T10:27:09.178-04:00"
},
{
"listing_type_id": "free",
"listing_type_name": "Gratuita",
"listing_exposure": "lowest",
"requires_picture": false,
"currency_id": "ARS",
"listing_fee_amount": 0,
"sale_fee_amount": 0,
"free_relist": false,
"stop_time": "2014-10-31T10:27:09.181-04:00"
}
]
By price and currency
Retrieves different listing types and each associated fee in the local currency where the item price is 5000 USD.
EXAMPLE
curl -X GET https://api.mercadolibre.com/sites/:site_id/listing_prices?price=5000¤cy_id=USD
RESPONSE
[
{
"listing_type_id": "gold_premium",
"listing_type_name": "Oro Premium",
"listing_exposure": "highest",
"requires_picture": true,
"currency_id": "ARS",
"listing_fee_amount": 800,
"sale_fee_amount": 825,
"free_relist": false,
"stop_time": "2014-12-20T10:27:40.766-04:00"
},
{
"listing_type_id": "gold_special",
"listing_type_name": "Oro Profesional",
"listing_exposure": "highest",
"requires_picture": true,
"currency_id": "ARS",
"listing_fee_amount": 0,
"sale_fee_amount": 4446.75,
"free_relist": false,
"stop_time": "2014-12-20T10:27:40.784-04:00"
},
{
"listing_type_id": "gold",
"listing_type_name": "Oro",
"listing_exposure": "high",
"requires_picture": true,
"currency_id": "ARS",
"listing_fee_amount": 480,
"sale_fee_amount": 825,
"free_relist": false,
"stop_time": "2014-12-20T10:27:40.781-04:00"
},
{
"listing_type_id": "silver",
"listing_type_name": "Plata",
"listing_exposure": "mid",
"requires_picture": false,
"currency_id": "ARS",
"listing_fee_amount": 160,
"sale_fee_amount": 825,
"free_relist": false,
"stop_time": "2014-12-20T10:27:40.770-04:00"
},
{
"listing_type_id": "bronze",
"listing_type_name": "Bronce",
"listing_exposure": "low",
"requires_picture": false,
"currency_id": "ARS",
"listing_fee_amount": 0,
"sale_fee_amount": 1210,
"free_relist": false,
"stop_time": "2014-12-20T10:27:40.773-04:00"
},
{
"listing_type_id": "free",
"listing_type_name": "Gratuita",
"listing_exposure": "lowest",
"requires_picture": false,
"currency_id": "ARS",
"listing_fee_amount": 0,
"sale_fee_amount": 0,
"free_relist": false,
"stop_time": "2014-10-28T10:27:40.776-04:00"
}
]
Filter by listing type and category
Retrieves listing fee associated to listing type Gold where the category id is MLA1743.
EXAMPLE
curl -X GET https://api.mercadolibre.com/sites/:site_id/listing_prices/gold?category_id=MLA1743
RESPONSE
{
"listing_type_id": "gold",
"listing_type_name": "Oro",
"listing_exposure": "high",
"requires_picture": true,
"currency_id": "ARS",
"listing_fee_amount": 175,
"sale_fee_amount": 0,
"free_relist": false,
"stop_time": "2014-12-20T10:28:10.032-04:00"
}
By category
Retrieves different listing types and each associated fee in the local currency where the category id is MLA1743.
EXAMPLE
curl -X GET https://api.mercadolibre.com/sites/:site_id/listing_prices?category_id=MLA1743
RESPONSE
[
{
"listing_type_id": "gold_premium",
"listing_type_name": "Oro Premium",
"listing_exposure": "highest",
"requires_picture": true,
"currency_id": "ARS",
"listing_fee_amount": 250,
"sale_fee_amount": 0,
"free_relist": false,
"stop_time": "2014-12-20T10:28:36.532-04:00"
},
{
"listing_type_id": "gold",
"listing_type_name": "Oro",
"listing_exposure": "high",
"requires_picture": true,
"currency_id": "ARS",
"listing_fee_amount": 175,
"sale_fee_amount": 0,
"free_relist": false,
"stop_time": "2014-12-20T10:28:36.550-04:00"
},
{
"listing_type_id": "silver",
"listing_type_name": "Plata",
"listing_exposure": "mid",
"requires_picture": false,
"currency_id": "ARS",
"listing_fee_amount": 99,
"sale_fee_amount": 0,
"free_relist": false,
"stop_time": "2014-12-20T10:28:36.537-04:00"
},
{
"listing_type_id": "free",
"listing_type_name": "Gratuita",
"listing_exposure": "lowest",
"requires_picture": false,
"currency_id": "ARS",
"listing_fee_amount": 0,
"sale_fee_amount": 0,
"free_relist": false,
"stop_time": "2014-10-31T10:28:36.542-04:00"
}
]