Listing prices calculator

The Listing Prices API is 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.

Contents:

Attribute description

AttributeDescription
listing_type_idListing type ID
listing_type_nameListing type name
listing_exposureListing exposure level
requires_pictureShows if the listing type requires at least one picture
currency_idCurrency id of the fees
listing_fee_amountListing fee amount
selling_fee_amountSelling fee amount

Filter by price

Retrieves different listing types and each associated fee 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

Response:

{
    "listing_type_id": "gold_pro",
    "listing_type_name": "Oro Premium Full",
    "listing_exposure": "highest",
    "requires_picture": true,
    "currency_id": "ARS",
    "listing_fee_amount": 0,
    "sale_fee_amount": 1150,
    "free_relist": false,
    "stop_time": "2016-04-22T10:31:44.135-04:00"
},
{
    "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": 375,
    "free_relist": false,
    "stop_time": "2016-04-22T10:31:44.119-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": 525,
    "free_relist": false,
    "stop_time": "2016-04-22T10:31:44.121-04:00"
},
{
    "listing_type_id": "gold",
    "listing_type_name": "Oro",
    "listing_exposure": "high",
    "requires_picture": true,
    "currency_id": "ARS",
    "listing_fee_amount": 150,
    "sale_fee_amount": 375,
    "free_relist": false,
    "stop_time": "2016-04-22T10:31:44.133-04:00"
},
{
    "listing_type_id": "silver",
    "listing_type_name": "Plata",
    "listing_exposure": "mid",
    "requires_picture": false,
    "currency_id": "ARS",
    "listing_fee_amount": 50,
    "sale_fee_amount": 375,
    "free_relist": false,
    "stop_time": "2016-04-22T10:31:44.127-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": 550,
    "free_relist": false,
    "stop_time": "2016-04-22T10:31:44.130-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": "2016-04-22T10:31:44.116-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": "ARS",
    "listing_fee_amount": 150,
    "sale_fee_amount": 375,
    "free_relist": false,
    "stop_time": "2016-04-22T10:32:39.264-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 Full",
    "listing_exposure": "highest",
    "requires_picture": true,
    "currency_id": "ARS",
    "listing_fee_amount": 0,
    "sale_fee_amount": 1150,
    "free_relist": false,
    "stop_time": "2016-04-22T10:33:22.631-04:00"
},
{
    "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": 375,
    "free_relist": false,
    "stop_time": "2016-04-22T10:33:22.614-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": 525,
    "free_relist": false,
    "stop_time": "2016-04-22T10:33:22.617-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": 375,
    "free_relist": false,
    "stop_time": "2016-04-22T10:33:22.628-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": 375,
    "free_relist": false,
    "stop_time": "2016-04-22T10:33:22.622-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": 550,
    "free_relist": false,
    "stop_time": "2016-04-22T10:33:22.624-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": "2016-04-22T10:33:22.611-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": 357,
    "sale_fee_amount": 0,
    "free_relist": false,
    "stop_time": "2016-04-22T10:33:58.127-04:00"
  },
  {
    "listing_type_id": "gold",
    "listing_type_name": "Oro",
    "listing_exposure": "high",
    "requires_picture": true,
    "currency_id": "ARS",
    "listing_fee_amount": 267,
    "sale_fee_amount": 0,
    "free_relist": false,
    "stop_time": "2016-04-22T10:33:58.135-04:00"
  },
  {
    "listing_type_id": "silver",
    "listing_type_name": "Plata",
    "listing_exposure": "mid",
    "requires_picture": false,
    "currency_id": "ARS",
    "listing_fee_amount": 147,
    "sale_fee_amount": 0,
    "free_relist": false,
    "stop_time": "2016-04-22T10:33:58.130-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": "2016-03-23T10:33:58.132-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_pro",
    "listing_type_name": "Oro Premium Full",
    "listing_exposure": "highest",
    "requires_picture": true,
    "currency_id": "ARS",
    "listing_fee_amount": 0,
    "sale_fee_amount": 1150,
    "free_relist": false,
    "stop_time": "2016-04-22T10:34:27.793-04:00"
  },
  {
    "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": 375,
    "free_relist": false,
    "stop_time": "2016-04-22T10:34:27.779-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": 525,
    "free_relist": false,
    "stop_time": "2016-04-22T10:34:27.782-04:00"
  },
  {
    "listing_type_id": "gold",
    "listing_type_name": "Oro",
    "listing_exposure": "high",
    "requires_picture": true,
    "currency_id": "ARS",
    "listing_fee_amount": 150,
    "sale_fee_amount": 375,
    "free_relist": false,
    "stop_time": "2016-04-22T10:34:27.791-04:00"
  },
  {
    "listing_type_id": "silver",
    "listing_type_name": "Plata",
    "listing_exposure": "mid",
    "requires_picture": false,
    "currency_id": "ARS",
    "listing_fee_amount": 50,
    "sale_fee_amount": 375,
    "free_relist": false,
    "stop_time": "2016-04-22T10:34:27.786-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": 550,
    "free_relist": false,
    "stop_time": "2016-04-22T10:34:27.788-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": "2016-04-22T10:34:27.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": 267,
  "sale_fee_amount": 0,
  "free_relist": false,
  "stop_time": "2016-04-22T10:35:02.225-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": 357,
    "sale_fee_amount": 0,
    "free_relist": false,
    "stop_time": "2016-04-22T10:35:31.996-04:00"
  },
  {
    "listing_type_id": "gold",
    "listing_type_name": "Oro",
    "listing_exposure": "high",
    "requires_picture": true,
    "currency_id": "ARS",
    "listing_fee_amount": 267,
    "sale_fee_amount": 0,
    "free_relist": false,
    "stop_time": "2016-04-22T10:35:32.006-04:00"
  },
  {
    "listing_type_id": "silver",
    "listing_type_name": "Plata",
    "listing_exposure": "mid",
    "requires_picture": false,
    "currency_id": "ARS",
    "listing_fee_amount": 147,
    "sale_fee_amount": 0,
    "free_relist": false,
    "stop_time": "2016-04-22T10:35:31.999-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": "2016-03-23T10:35:32.003-04:00"
  }

Please rate this