Documentação do Mercado Livre

Confira todas as informações necessárias sobre as APIs Mercado Livre.
circulos azuis em degrade

Documentação do

Última atualização em 02/11/2023

Fees for listing

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.


Attribute description

Attribute Description
currency_id Cost currency ID.
listing_exposure Level of exposure of the publication.
listing_fee_amount Costs for publishing.
listing_fee_details Array that shows the detail of the costs for publishing: - fixed_fee: fixed fee for publishing
- gross_amount: gross commission value (without applying discounts)
listing_type_id Listing type ID
listing_type_name Listing type name
requires_picture Shows if the listing type requires at least one picture.
selling_fee_amount Selling fee amount.
sale_fee_details Array that shows the detail of the costs to sell:
- financing_add_on_fee: costs for adding fees.
- fixed_fee: fixed charge for selling (applies only MLA).
- gross_amount: gross commission value (without applying discounts).
- meli_percentage_fee: costs for selling on the platform (applies only MLA).
- percentage_fee: total commission percentage.

Remember:

  • The publication types or listing_type available for Marketplace and Mshops are free, gold_special, gold_pro (may vary by site).
  • Filter by channel to see the specific commissions. Otherwise, you will see by default those of marketplace.
  • Respect the listing_type + tag relationship (see options applies only MLA).
  • Learn more about costs to sell a product and fee options .
  • Depending on the site, the number of attributes in the response may vary.

Filter by price

Recover detailed information on types of publications by filtering by the associated price.

Request:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/$SITE/listing_prices?price=$PRICE

Example:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/MLA/listing_prices?price=5000

Response:

[
    {
        "currency_id": "ARS",
        "free_relist": false,
        "listing_exposure": "highest",
        "listing_fee_amount": 0,
        "listing_fee_details": {
            "fixed_fee": 0,
            "gross_amount": 0
        },
        "listing_type_id": "gold_pro",
        "listing_type_name": "Premium",
        "mapping": "gold_pro",
        "requires_picture": true,
        "sale_fee_amount": 2000,
        "sale_fee_details": {
            "financing_add_on_fee": 23,
            "fixed_fee": 200,
            "gross_amount": 2000,
            "meli_percentage_fee": 13,
            "percentage_fee": 36
        },
        "stop_time": "2043-06-01T00:00:00.000-04:00"
    },
    {
        "currency_id": "ARS",
        "free_relist": false,
        "listing_exposure": "highest",
        "listing_fee_amount": 0,
        "listing_fee_details": {
            "fixed_fee": 0,
            "gross_amount": 0
        },
        "listing_type_id": "gold_premium",
        "listing_type_name": "Oro Premium",
        "mapping": "gold_special",
        "requires_picture": true,
        "sale_fee_amount": 0,
        "sale_fee_details": {
            "financing_add_on_fee": 0,
            "fixed_fee": 0,
            "gross_amount": 0,
            "meli_percentage_fee": 0,
            "percentage_fee": 0
        },
        "stop_time": "2023-08-05T00:00:00.000-04:00"
    },
    {
        "currency_id": "ARS",
        "free_relist": false,
        "listing_exposure": "highest",
        "listing_fee_amount": 0,
        "listing_fee_details": {
            "fixed_fee": 0,
            "gross_amount": 0
        },
        "listing_type_id": "gold_special",
        "listing_type_name": "Clásica",
        "mapping": "gold_special",
        "requires_picture": true,
        "sale_fee_amount": 850,
        "sale_fee_details": {
            "financing_add_on_fee": 0,
            "fixed_fee": 200,
            "gross_amount": 850,
            "meli_percentage_fee": 13,
            "percentage_fee": 13
        },
        "stop_time": "2043-06-01T00:00:00.000-04:00"
    },
    {
        "currency_id": "ARS",
        "free_relist": false,
        "listing_exposure": "high",
        "listing_fee_amount": 0,
        "listing_fee_details": {
            "fixed_fee": 0,
            "gross_amount": 0
        },
        "listing_type_id": "gold",
        "listing_type_name": "Oro",
        "mapping": "gold_special",
        "requires_picture": true,
        "sale_fee_amount": 0,
        "sale_fee_details": {
            "financing_add_on_fee": 0,
            "fixed_fee": 0,
            "gross_amount": 0,
            "meli_percentage_fee": 0,
            "percentage_fee": 0
        },
        "stop_time": "2023-08-05T00:00:00.000-04:00"
    },
    {
        "currency_id": "ARS",
        "free_relist": false,
        "listing_exposure": "mid",
        "listing_fee_amount": 0,
        "listing_fee_details": {
            "fixed_fee": 0,
            "gross_amount": 0
        },
        "listing_type_id": "silver",
        "listing_type_name": "Plata",
        "mapping": "gold_special",
        "requires_picture": false,
        "sale_fee_amount": 0,
        "sale_fee_details": {
            "financing_add_on_fee": 0,
            "fixed_fee": 0,
            "gross_amount": 0,
            "meli_percentage_fee": 0,
            "percentage_fee": 0
        },
        "stop_time": "2023-08-05T00:00:00.000-04:00"
    },
    {
        "currency_id": "ARS",
        "free_relist": false,
        "listing_exposure": "low",
        "listing_fee_amount": 0,
        "listing_fee_details": {
            "fixed_fee": 0,
            "gross_amount": 0
        },
        "listing_type_id": "bronze",
        "listing_type_name": "Bronce",
        "mapping": "gold_special",
        "requires_picture": false,
        "sale_fee_amount": 0,
        "sale_fee_details": {
            "financing_add_on_fee": 0,
            "fixed_fee": 0,
            "gross_amount": 0,
            "meli_percentage_fee": 0,
            "percentage_fee": 0
        },
        "stop_time": "2023-08-05T00:00:00.000-04:00"
    },
    {
        "currency_id": "ARS",
        "free_relist": false,
        "listing_exposure": "lowest",
        "listing_fee_amount": 0,
        "listing_fee_details": {
            "fixed_fee": 0,
            "gross_amount": 0
        },
        "listing_type_id": "free",
        "listing_type_name": "Gratuita",
        "mapping": "free",
        "requires_picture": true,
        "sale_fee_amount": 0,
        "sale_fee_details": {
            "financing_add_on_fee": 0,
            "fixed_fee": 0,
            "gross_amount": 0,
            "meli_percentage_fee": 0,
            "percentage_fee": 0
        },
        "stop_time": "2023-08-05T00:00:00.000-04:00"
    }
]

Filter by price and listing type

Recover detailed information about publication types by filtering by price and associated listing_type.

Request:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/$SITE/listing_prices?price=$PRICE&listing_type_id=$LISTING_TYPE_ID

Example:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/MLA/listing_prices?price=5290&listing_type_id=gold_special

Response:

[
    {
        "currency_id": "ARS",
        "free_relist": false,
        "listing_exposure": "highest",
        "listing_fee_amount": 0,
        "listing_fee_details": {
            "fixed_fee": 0,
            "gross_amount": 0
        },
        "listing_type_id": "gold_special",
        "listing_type_name": "Clásica",
        "mapping": "gold_special",
        "requires_picture": true,
        "sale_fee_amount": 887.7,
        "sale_fee_details": {
            "financing_add_on_fee": 0,
            "fixed_fee": 200,
            "gross_amount": 887.7,
            "meli_percentage_fee": 13,
            "percentage_fee": 13
        },
        "stop_time": "2043-06-01T00:00:00.000-04:00"
    }
]

Filter by price and quantity

Recover detailed information on types of publications by filtering by the associated price and quantity.

Request:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/$SITE/listing_prices?price=$PRICE&quantity=$QUANTITY

Example:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/MLA/listing_prices?price=10630&quantity=80

Response:

[
{
    "currency_id": "ARS",
    "free_relist": false,
    "listing_exposure": "highest",
    "listing_fee_amount": 0,
    "listing_fee_details": {
        "fixed_fee": 0,
        "gross_amount": 0
    },
    "listing_type_id": "gold_pro",
    "listing_type_name": "Premium",
    "mapping": "gold_pro",
    "requires_picture": true,
    "sale_fee_amount": 3826.8,
    "sale_fee_details": {
        "financing_add_on_fee": 23,
        "fixed_fee": 0,
        "gross_amount": 3826.8,
        "meli_percentage_fee": 13,
        "percentage_fee": 36
    },
    "stop_time": "2043-06-01T00:00:00.000-04:00"
},
{
    "currency_id": "ARS",
    "free_relist": false,
    "listing_exposure": "highest",
    "listing_fee_amount": 0,
    "listing_fee_details": {
        "fixed_fee": 0,
        "gross_amount": 0
    },
    "listing_type_id": "gold_premium",
    "listing_type_name": "Oro Premium",
    "mapping": "gold_special",
    "requires_picture": true,
    "sale_fee_amount": 0,
    "sale_fee_details": {
        "financing_add_on_fee": 0,
        "fixed_fee": 0,
        "gross_amount": 0,
        "meli_percentage_fee": 0,
        "percentage_fee": 0
    },
    "stop_time": "2023-08-05T00:00:00.000-04:00"
},
{
    "currency_id": "ARS",
    "free_relist": false,
    "listing_exposure": "highest",
    "listing_fee_amount": 0,
    "listing_fee_details": {
        "fixed_fee": 0,
        "gross_amount": 0
    },
    "listing_type_id": "gold_special",
    "listing_type_name": "Clásica",
    "mapping": "gold_special",
    "requires_picture": true,
    "sale_fee_amount": 1381.9,
    "sale_fee_details": {
        "financing_add_on_fee": 0,
        "fixed_fee": 0,
        "gross_amount": 1381.9,
        "meli_percentage_fee": 13,
        "percentage_fee": 13
    },
    "stop_time": "2043-06-01T00:00:00.000-04:00"
},
{
    "currency_id": "ARS",
    "free_relist": false,
    "listing_exposure": "high",
    "listing_fee_amount": 0,
    "listing_fee_details": {
        "fixed_fee": 0,
        "gross_amount": 0
    },
    "listing_type_id": "gold",
    "listing_type_name": "Oro",
    "mapping": "gold_special",
    "requires_picture": true,
    "sale_fee_amount": 0,
    "sale_fee_details": {
        "financing_add_on_fee": 0,
        "fixed_fee": 0,
        "gross_amount": 0,
        "meli_percentage_fee": 0,
        "percentage_fee": 0
    },
    "stop_time": "2023-08-05T00:00:00.000-04:00"
},
{
    "currency_id": "ARS",
    "free_relist": false,
    "listing_exposure": "mid",
    "listing_fee_amount": 0,
    "listing_fee_details": {
        "fixed_fee": 0,
        "gross_amount": 0
    },
    "listing_type_id": "silver",
    "listing_type_name": "Plata",
    "mapping": "gold_special",
    "requires_picture": false,
    "sale_fee_amount": 0,
    "sale_fee_details": {
        "financing_add_on_fee": 0,
        "fixed_fee": 0,
        "gross_amount": 0,
        "meli_percentage_fee": 0,
        "percentage_fee": 0
    },
    "stop_time": "2023-08-05T00:00:00.000-04:00"
},
{
    "currency_id": "ARS",
    "free_relist": false,
    "listing_exposure": "low",
    "listing_fee_amount": 0,
    "listing_fee_details": {
        "fixed_fee": 0,
        "gross_amount": 0
    },
    "listing_type_id": "bronze",
    "listing_type_name": "Bronce",
    "mapping": "gold_special",
    "requires_picture": false,
    "sale_fee_amount": 0,
    "sale_fee_details": {
        "financing_add_on_fee": 0,
        "fixed_fee": 0,
        "gross_amount": 0,
        "meli_percentage_fee": 0,
        "percentage_fee": 0
    },
    "stop_time": "2023-08-05T00:00:00.000-04:00"
},
{
    "currency_id": "ARS",
    "free_relist": false,
    "listing_exposure": "lowest",
    "listing_fee_amount": 0,
    "listing_fee_details": {
        "fixed_fee": 0,
        "gross_amount": 0
    },
    "listing_type_id": "free",
    "listing_type_name": "Gratuita",
    "mapping": "free",
    "requires_picture": true,
    "sale_fee_amount": 0,
    "sale_fee_details": {
        "financing_add_on_fee": 0,
        "fixed_fee": 0,
        "gross_amount": 0,
        "meli_percentage_fee": 0,
        "percentage_fee": 0
    },
    "stop_time": "2023-08-05T00:00:00.000-04:00"
}
]

Filter by price and category

Recover detailed information on publication types by filtering by the associated price and publication category.

Request:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/$SITE/listing_prices?price=$PRICE&category_id=$CATEGORY_ID

Example:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/MLA/listing_prices?price=19500&category_id=MLA120353

Response:

[
{
    "currency_id": "ARS",
    "free_relist": false,
    "listing_exposure": "highest",
    "listing_fee_amount": 0,
    "listing_fee_details": {
        "fixed_fee": 0,
        "gross_amount": 0
    },
    "listing_type_id": "gold_pro",
    "listing_type_name": "Premium",
    "mapping": "gold_pro",
    "requires_picture": true,
    "sale_fee_amount": 7507.5,
    "sale_fee_details": {
        "financing_add_on_fee": 23,
        "fixed_fee": 0,
        "gross_amount": 7507.5,
        "meli_percentage_fee": 15.5,
        "percentage_fee": 38.5
    },
    "stop_time": "2043-06-01T00:00:00.000-04:00"
},
{
    "currency_id": "ARS",
    "free_relist": false,
    "listing_exposure": "highest",
    "listing_fee_amount": 0,
    "listing_fee_details": {
        "fixed_fee": 0,
        "gross_amount": 0
    },
    "listing_type_id": "gold_premium",
    "listing_type_name": "Oro Premium",
    "mapping": "gold_special",
    "requires_picture": true,
    "sale_fee_amount": 0,
    "sale_fee_details": {
        "financing_add_on_fee": 0,
        "fixed_fee": 0,
        "gross_amount": 0,
        "meli_percentage_fee": 0,
        "percentage_fee": 0
    },
    "stop_time": "2023-08-05T00:00:00.000-04:00"
},
{
    "currency_id": "ARS",
    "free_relist": false,
    "listing_exposure": "highest",
    "listing_fee_amount": 0,
    "listing_fee_details": {
        "fixed_fee": 0,
        "gross_amount": 0
    },
    "listing_type_id": "gold_special",
    "listing_type_name": "Clásica",
    "mapping": "gold_special",
    "requires_picture": true,
    "sale_fee_amount": 3022.5,
    "sale_fee_details": {
        "financing_add_on_fee": 0,
        "fixed_fee": 0,
        "gross_amount": 3022.5,
        "meli_percentage_fee": 15.5,
        "percentage_fee": 15.5
    },
    "stop_time": "2043-06-01T00:00:00.000-04:00"
},
{
    "currency_id": "ARS",
    "free_relist": false,
    "listing_exposure": "high",
    "listing_fee_amount": 0,
    "listing_fee_details": {
        "fixed_fee": 0,
        "gross_amount": 0
    },
    "listing_type_id": "gold",
    "listing_type_name": "Oro",
    "mapping": "gold_special",
    "requires_picture": true,
    "sale_fee_amount": 0,
    "sale_fee_details": {
        "financing_add_on_fee": 0,
        "fixed_fee": 0,
        "gross_amount": 0,
        "meli_percentage_fee": 0,
        "percentage_fee": 0
    },
    "stop_time": "2023-08-05T00:00:00.000-04:00"
},
{
    "currency_id": "ARS",
    "free_relist": false,
    "listing_exposure": "mid",
    "listing_fee_amount": 0,
    "listing_fee_details": {
        "fixed_fee": 0,
        "gross_amount": 0
    },
    "listing_type_id": "silver",
    "listing_type_name": "Plata",
    "mapping": "gold_special",
    "requires_picture": false,
    "sale_fee_amount": 0,
    "sale_fee_details": {
        "financing_add_on_fee": 0,
        "fixed_fee": 0,
        "gross_amount": 0,
        "meli_percentage_fee": 0,
        "percentage_fee": 0
    },
    "stop_time": "2023-08-05T00:00:00.000-04:00"
},
{
    "currency_id": "ARS",
    "free_relist": false,
    "listing_exposure": "low",
    "listing_fee_amount": 0,
    "listing_fee_details": {
        "fixed_fee": 0,
        "gross_amount": 0
    },
    "listing_type_id": "bronze",
    "listing_type_name": "Bronce",
    "mapping": "gold_special",
    "requires_picture": false,
    "sale_fee_amount": 0,
    "sale_fee_details": {
        "financing_add_on_fee": 0,
        "fixed_fee": 0,
        "gross_amount": 0,
        "meli_percentage_fee": 0,
        "percentage_fee": 0
    },
    "stop_time": "2023-08-05T00:00:00.000-04:00"
},
{
    "currency_id": "ARS",
    "free_relist": false,
    "listing_exposure": "lowest",
    "listing_fee_amount": 0,
    "listing_fee_details": {
        "fixed_fee": 0,
        "gross_amount": 0
    },
    "listing_type_id": "free",
    "listing_type_name": "Gratuita",
    "mapping": "free",
    "requires_picture": true,
    "sale_fee_amount": 0,
    "sale_fee_details": {
        "financing_add_on_fee": 0,
        "fixed_fee": 0,
        "gross_amount": 0,
        "meli_percentage_fee": 0,
        "percentage_fee": 0
    },
    "stop_time": "2023-08-05T00:00:00.000-04:00"
}
]

Filter by price and currency

Recover detailed information on publication types by filtering by the associated price and local currency type.

Request

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/$SITE/listing_prices?price=$PRICE&currency_id=$CURRENCY_ID

Example:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/MLA/listing_prices?price=6649&currency_id=ARS

Response:

[
{
    "currency_id": "ARS",
    "free_relist": false,
    "listing_exposure": "highest",
    "listing_fee_amount": 0,
    "listing_fee_details": {
        "fixed_fee": 0,
        "gross_amount": 0
    },
    "listing_type_id": "gold_pro",
    "listing_type_name": "Premium",
    "mapping": "gold_pro",
    "requires_picture": true,
    "sale_fee_amount": 2593.64,
    "sale_fee_details": {
        "financing_add_on_fee": 23,
        "fixed_fee": 200,
        "gross_amount": 2593.64,
        "meli_percentage_fee": 13,
        "percentage_fee": 36
    },
    "stop_time": "2043-06-01T00:00:00.000-04:00"
},
{
    "currency_id": "ARS",
    "free_relist": false,
    "listing_exposure": "highest",
    "listing_fee_amount": 0,
    "listing_fee_details": {
        "fixed_fee": 0,
        "gross_amount": 0
    },
    "listing_type_id": "gold_premium",
    "listing_type_name": "Oro Premium",
    "mapping": "gold_special",
    "requires_picture": true,
    "sale_fee_amount": 0,
    "sale_fee_details": {
        "financing_add_on_fee": 0,
        "fixed_fee": 0,
        "gross_amount": 0,
        "meli_percentage_fee": 0,
        "percentage_fee": 0
    },
    "stop_time": "2023-08-05T00:00:00.000-04:00"
},
{
    "currency_id": "ARS",
    "free_relist": false,
    "listing_exposure": "highest",
    "listing_fee_amount": 0,
    "listing_fee_details": {
        "fixed_fee": 0,
        "gross_amount": 0
    },
    "listing_type_id": "gold_special",
    "listing_type_name": "Clásica",
    "mapping": "gold_special",
    "requires_picture": true,
    "sale_fee_amount": 1064.37,
    "sale_fee_details": {
        "financing_add_on_fee": 0,
        "fixed_fee": 200,
        "gross_amount": 1064.37,
        "meli_percentage_fee": 13,
        "percentage_fee": 13
    },
    "stop_time": "2043-06-01T00:00:00.000-04:00"
},
{
    "currency_id": "ARS",
    "free_relist": false,
    "listing_exposure": "high",
    "listing_fee_amount": 0,
    "listing_fee_details": {
        "fixed_fee": 0,
        "gross_amount": 0
    },
    "listing_type_id": "gold",
    "listing_type_name": "Oro",
    "mapping": "gold_special",
    "requires_picture": true,
    "sale_fee_amount": 0,
    "sale_fee_details": {
        "financing_add_on_fee": 0,
        "fixed_fee": 0,
        "gross_amount": 0,
        "meli_percentage_fee": 0,
        "percentage_fee": 0
    },
    "stop_time": "2023-08-05T00:00:00.000-04:00"
},
{
    "currency_id": "ARS",
    "free_relist": false,
    "listing_exposure": "mid",
    "listing_fee_amount": 0,
    "listing_fee_details": {
        "fixed_fee": 0,
        "gross_amount": 0
    },
    "listing_type_id": "silver",
    "listing_type_name": "Plata",
    "mapping": "gold_special",
    "requires_picture": false,
    "sale_fee_amount": 0,
    "sale_fee_details": {
        "financing_add_on_fee": 0,
        "fixed_fee": 0,
        "gross_amount": 0,
        "meli_percentage_fee": 0,
        "percentage_fee": 0
    },
    "stop_time": "2023-08-05T00:00:00.000-04:00"
},
{
    "currency_id": "ARS",
    "free_relist": false,
    "listing_exposure": "low",
    "listing_fee_amount": 0,
    "listing_fee_details": {
        "fixed_fee": 0,
        "gross_amount": 0
    },
    "listing_type_id": "bronze",
    "listing_type_name": "Bronce",
    "mapping": "gold_special",
    "requires_picture": false,
    "sale_fee_amount": 0,
    "sale_fee_details": {
        "financing_add_on_fee": 0,
        "fixed_fee": 0,
        "gross_amount": 0,
        "meli_percentage_fee": 0,
        "percentage_fee": 0
    },
    "stop_time": "2023-08-05T00:00:00.000-04:00"
},
{
    "currency_id": "ARS",
    "free_relist": false,
    "listing_exposure": "lowest",
    "listing_fee_amount": 0,
    "listing_fee_details": {
        "fixed_fee": 0,
        "gross_amount": 0
    },
    "listing_type_id": "free",
    "listing_type_name": "Gratuita",
    "mapping": "free",
    "requires_picture": true,
    "sale_fee_amount": 0,
    "sale_fee_details": {
        "financing_add_on_fee": 0,
        "fixed_fee": 0,
        "gross_amount": 0,
        "meli_percentage_fee": 0,
        "percentage_fee": 0
    },
    "stop_time": "2023-08-05T00:00:00.000-04:00"
}
]

Filter by price, listing_type and category

Recover detailed information on publication types by filtering by associated listing_type and publication category.

Request:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/$SITE/listing_prices?price=$PRICE&listing_type_id=$LISTING_TYPE_ID&category_id=$CATEGORY_ID

Example:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/MLA/listing_prices?price=10345&listing_type_id=gold_special&category_id=MLA120350

Response:

{
        "currency_id": "ARS",
        "free_relist": false,
        "listing_exposure": "highest",
        "listing_fee_amount": 0,
        "listing_fee_details": {
            "fixed_fee": 0,
            "gross_amount": 0
        },
        "listing_type_id": "gold_special",
        "listing_type_name": "Clásica",
        "requires_picture": true,
        "sale_fee_amount": 1603.48,
        "sale_fee_details": {
            "financing_add_on_fee": 0,
            "fixed_fee": 0,
            "gross_amount": 1603.48,
            "meli_percentage_fee": 15.5,
            "percentage_fee": 15.5
        },
        "stop_time": "2043-06-01T00:00:00.000-04:00"
    }

Filter by category, price, currency type, and logistics type

Recover detailed information on publication types by filtering by the associated category, price, local currency type, and logistics type.

Request:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/$SITE/listing_prices?category_id=$CATEGORY_ID&price=$PRICE&currency_id=$CURRENCY_ID&logistic_type=$LOGISTIC_TYPE

Example:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/MLA/listing_prices?category_id=MLA6711&price=80.12&currency_id=ARS&logistic_type=drop_off

Response:

[
      {
          "currency_id": "ARS",
          "free_relist": false,
          "listing_exposure": "highest",
          "listing_fee_amount": 0,
          "listing_fee_details":
          {
              "fixed_fee": 0,
              "gross_amount": 0
          },
          "listing_type_id": "gold_pro",
          "listing_type_name": "Premium",
          "requires_picture": true,
          "sale_fee_amount": 26.46,
          "sale_fee_details":
          {
              "financing_add_on_fee": 10.96,
              "fixed_fee": 0,
              "gross_amount": 26.46,
              "meli_percentage_fee": 15.5,
              "percentage_fee": 26.46
          },
          "stop_time": "2043-05-11T00:00:00.000-04:00"
      },
      {
          "currency_id": "ARS",
          "free_relist": false,
          "listing_exposure": "highest",
          "listing_fee_amount": 0,
          "listing_fee_details":
          {
              "fixed_fee": 0,
              "gross_amount": 0
          },
          "listing_type_id": "gold_premium",
          "listing_type_name": "Oro Premium",
          "requires_picture": true,
          "sale_fee_amount": 0,
          "sale_fee_details":
          {
              "financing_add_on_fee": 0,
              "fixed_fee": 0,
              "gross_amount": 0,
              "meli_percentage_fee": 0,
              "percentage_fee": 0
          },
          "stop_time": "2023-07-15T00:00:00.000-04:00"
      },
      {
          "currency_id": "ARS",
          "free_relist": false,
          "listing_exposure": "highest",
          "listing_fee_amount": 0,
          "listing_fee_details":
          {
              "fixed_fee": 0,
              "gross_amount": 0
          },
          "listing_type_id": "gold_special",
          "listing_type_name": "Clásica",
          "requires_picture": true,
          "sale_fee_amount": 15.5,
          "sale_fee_details":
          {
              "financing_add_on_fee": 0,
              "fixed_fee": 0,
              "gross_amount": 15.5,
              "meli_percentage_fee": 15.5,
              "percentage_fee": 15.5
          },
          "stop_time": "2043-05-11T00:00:00.000-04:00"
      },
      {
          "currency_id": "ARS",
          "free_relist": false,
          "listing_exposure": "high",
          "listing_fee_amount": 0,
          "listing_fee_details":
          {
              "fixed_fee": 0,
              "gross_amount": 0
          },
          "listing_type_id": "gold",
          "listing_type_name": "Oro",
          "requires_picture": true,
          "sale_fee_amount": 0,
          "sale_fee_details":
          {
              "financing_add_on_fee": 0,
              "fixed_fee": 0,
              "gross_amount": 0,
              "meli_percentage_fee": 0,
              "percentage_fee": 0
          },
          "stop_time": "2023-07-15T00:00:00.000-04:00"
      },
      {
          "currency_id": "ARS",
          "free_relist": false,
          "listing_exposure": "mid",
          "listing_fee_amount": 0,
          "listing_fee_details":
          {
              "fixed_fee": 0,
              "gross_amount": 0
          },
          "listing_type_id": "silver",
          "listing_type_name": "Plata",
          "requires_picture": false,
          "sale_fee_amount": 0,
          "sale_fee_details":
          {
              "financing_add_on_fee": 0,
              "fixed_fee": 0,
              "gross_amount": 0,
              "meli_percentage_fee": 0,
              "percentage_fee": 0
          },
          "stop_time": "2023-07-15T00:00:00.000-04:00"
      },
      {
          "currency_id": "ARS",
          "free_relist": false,
          "listing_exposure": "low",
          "listing_fee_amount": 0,
          "listing_fee_details":
          {
              "fixed_fee": 0,
              "gross_amount": 0
          },
          "listing_type_id": "bronze",
          "listing_type_name": "Bronce",
          "requires_picture": false,
          "sale_fee_amount": 0,
          "sale_fee_details":
          {
              "financing_add_on_fee": 0,
              "fixed_fee": 0,
              "gross_amount": 0,
              "meli_percentage_fee": 0,
              "percentage_fee": 0
          },
          "stop_time": "2023-07-15T00:00:00.000-04:00"
      },
      {
          "currency_id": "ARS",
          "free_relist": false,
          "listing_exposure": "lowest",
          "listing_fee_amount": 0,
          "listing_fee_details":
          {
              "fixed_fee": 0,
              "gross_amount": 0
          },
          "listing_type_id": "free",
          "listing_type_name": "Gratuita",
          "requires_picture": true,
          "sale_fee_amount": 0,
          "sale_fee_details":
          {
              "financing_add_on_fee": 0,
              "fixed_fee": 0,
              "gross_amount": 0,
              "meli_percentage_fee": 0,
              "percentage_fee": 0
          },
          "stop_time": "2023-07-15T00:00:00.000-04:00"
      }
  ]

Filter by price, category, tags, and listing_type

Recover detailed information about publication types by filtering by the associated price, publication category, tags, and listing_type.

Request:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/$SITE/listing_prices?price=$PRICE&category_id=$CATEGORY_ID&tags=$$CAMPAIGN_TAG_ID&listing_type_id=$LISTING_TYPE

Example:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/MLA/listing_prices?price=100&category_id=MLA3551&tags=ahora-3&listing_type_id=gold_pro

Response:

{
    "currency_id": "ARS",
    "free_relist": false,
    "listing_exposure": "highest",
    "listing_fee_amount": 0,
    "listing_fee_details": {
        "fixed_fee": 0,
        "gross_amount": 0
    },
    "listing_type_id": "gold_pro",
    "listing_type_name": "Premium",
    "requires_picture": true,
    "sale_fee_amount": 26.46,
    "sale_fee_details": {
        "financing_add_on_fee": 10.96,
        "fixed_fee": 0,
        "gross_amount": 26.46,
        "meli_percentage_fee": 15.5,
        "percentage_fee": 26.46
    },
    "stop_time": "2043-05-11T00:00:00.000-04:00"
}

Learn more about: