Custos por vender

Listing Prices é um recurso somente leitura que oferece muitas maneiras de saber quais são as taxas para vender um produto no Mercado Livre, para que o vendedor saiba exatamente qual será seu custo ao vender em um determinado listing_type de um site, categoria, moeda e quantidade determinados.

Conteúdos

→Descrição de atributos
→Por preço e listing_type
→Filtrar por preço e categoria
→Por preço e moeda
→Filtrar por tipo de publicação e categoria


Descrição de atributos

Atributo Descrição
listing_type_id ID do tipo de publicação.
listing_type_name Nome do tipo de publicação.
listing_exposure Nível de exposição da publicação.
requires_picture Mostra se o tipo de publicação exige pelo menos uma imagem.
currency_id ID da moeda das taxas.
listing_fee_amount Montante de taxas da publicação.
sale_fee_amount Montante de taxas da venda.

Por preço e listing_type

Recupera os diferentes tipos de publicações associadas ao tipo de publicação Gold em moeda local quando o preço do produto é 500.

Exemplo:

curl -X GET https://api.mercadolibre.com/sites/$SITE_ID/listing_prices?price=500&listing_type_id=gold_pro

Resposta:

 [
    {
        "listing_type_id": "gold_pro",
        "listing_type_name": "Premium",
        "listing_exposure": "highest",
        "requires_picture": true,
        "currency_id": "BRL",
        "listing_fee_amount": 0,
        "sale_fee_amount": 80,
        "free_relist": false,
        "stop_time": "2041-09-05T00:00:00.000-04:00"
    }
]

Filtrar por preço e categoria

Recupera os diferentes tipos de publicações e cada uma das taxas associadas em moeda local, quando o preço do produto é 500 e a categoria é MLB1055.

Exemplo:

curl -X GET https://api.mercadolibre.com/sites/$SITE_ID/listing_prices?price=500&category_id=MLB1055

Resposta:

[
    {
        "listing_type_id": "gold_pro",
        "listing_type_name": "Premium",
        "listing_exposure": "highest",
        "requires_picture": true,
        "currency_id": "BRL",
        "listing_fee_amount": 0,
        "sale_fee_amount": 80,
        "free_relist": false,
        "stop_time": "2041-09-08T00:00:00.000-04:00"
    },
    {
        "listing_type_id": "gold_premium",
        "listing_type_name": "Diamante",
        "listing_exposure": "highest",
        "requires_picture": true,
        "currency_id": "BRL",
        "listing_fee_amount": 0,
        "sale_fee_amount": 0,
        "free_relist": false,
        "stop_time": "2021-11-12T00:00:00.000-04:00"
    },
    {
        "listing_type_id": "gold_special",
        "listing_type_name": "Clássico",
        "listing_exposure": "highest",
        "requires_picture": true,
        "currency_id": "BRL",
        "listing_fee_amount": 0,
        "sale_fee_amount": 55,
        "free_relist": false,
        "stop_time": "2041-09-08T00:00:00.000-04:00"
    },
    {
        "listing_type_id": "gold",
        "listing_type_name": "Ouro",
        "listing_exposure": "high",
        "requires_picture": true,
        "currency_id": "BRL",
        "listing_fee_amount": 0,
        "sale_fee_amount": 0,
        "free_relist": false,
        "stop_time": "2021-11-12T00:00:00.000-04:00"
    },
    {
        "listing_type_id": "silver",
        "listing_type_name": "Prata",
        "listing_exposure": "mid",
        "requires_picture": false,
        "currency_id": "BRL",
        "listing_fee_amount": 0,
        "sale_fee_amount": 0,
        "free_relist": false,
        "stop_time": "2021-11-12T00:00:00.000-04:00"
    },
    {
        "listing_type_id": "bronze",
        "listing_type_name": "Bronze",
        "listing_exposure": "low",
        "requires_picture": false,
        "currency_id": "BRL",
        "listing_fee_amount": 0,
        "sale_fee_amount": 0,
        "free_relist": false,
        "stop_time": "2021-11-12T00:00:00.000-04:00"
    },
    {
        "listing_type_id": "free",
        "listing_type_name": "Grátis",
        "listing_exposure": "lowest",
        "requires_picture": true,
        "currency_id": "BRL",
        "listing_fee_amount": 0,
        "sale_fee_amount": 0,
        "free_relist": false,
        "stop_time": "2021-11-12T00:00:00.000-04:00"
    }
]

Por preço e moeda

Recupera os diferentes tipos de publicações e cada uma das taxas associadas em moeda local, quando o preço do produto é US$ 5.000.

Exemplo:

curl -X GET https://api.mercadolibre.com/sites/$SITE_ID/listing_prices?price=5000¤cy_id=USD

Resposta:

[
    {
        "listing_type_id": "gold_pro",
        "listing_type_name": "Premium",
        "listing_exposure": "highest",
        "requires_picture": true,
        "currency_id": "BRL",
        "listing_fee_amount": 0,
        "sale_fee_amount": 4224,
        "free_relist": false,
        "stop_time": "2041-09-05T00:00:00.000-04:00"
    },
    {
        "listing_type_id": "gold_premium",
        "listing_type_name": "Diamante",
        "listing_exposure": "highest",
        "requires_picture": true,
        "currency_id": "BRL",
        "listing_fee_amount": 0,
        "sale_fee_amount": 0,
        "free_relist": false,
        "stop_time": "2021-11-09T00:00:00.000-04:00"
    },
    {
        "listing_type_id": "gold_special",
        "listing_type_name": "Clássico",
        "listing_exposure": "highest",
        "requires_picture": true,
        "currency_id": "BRL",
        "listing_fee_amount": 0,
        "sale_fee_amount": 2904,
        "free_relist": false,
        "stop_time": "2041-09-05T00:00:00.000-04:00"
    },
    {
        "listing_type_id": "gold",
        "listing_type_name": "Ouro",
        "listing_exposure": "high",
        "requires_picture": true,
        "currency_id": "BRL",
        "listing_fee_amount": 0,
        "sale_fee_amount": 0,
        "free_relist": false,
        "stop_time": "2021-11-09T00:00:00.000-04:00"
    },
    {
        "listing_type_id": "silver",
        "listing_type_name": "Prata",
        "listing_exposure": "mid",
        "requires_picture": false,
        "currency_id": "BRL",
        "listing_fee_amount": 0,
        "sale_fee_amount": 0,
        "free_relist": false,
        "stop_time": "2021-11-09T00:00:00.000-04:00"
    },
    {
        "listing_type_id": "bronze",
        "listing_type_name": "Bronze",
        "listing_exposure": "low",
        "requires_picture": false,
        "currency_id": "BRL",
        "listing_fee_amount": 0,
        "sale_fee_amount": 0,
        "free_relist": false,
        "stop_time": "2021-11-09T00:00:00.000-04:00"
    },
    {
        "listing_type_id": "free",
        "listing_type_name": "Grátis",
        "listing_exposure": "lowest",
        "requires_picture": true,
        "currency_id": "BRL",
        "listing_fee_amount": 0,
        "sale_fee_amount": 0,
        "free_relist": false,
        "stop_time": "2021-11-09T00:00:00.000-04:00"
    }
]

Filtrar por tipo de publicação e categoria

Recupera a comissão associada ao tipo de publicação Gold quando o ID da categoria é MLA1055.

Exemplo:

curl -X GET https://api.mercadolibre.com/sites/$SITE_ID/listing_prices/gold_pro?price=500&category_id=MLB1055

Resposta:

{
    "listing_type_id": "gold_pro",
    "listing_type_name": "Premium",
    "listing_exposure": "highest",
    "requires_picture": true,
    "currency_id": "BRL",
    "listing_fee_amount": 0,
    "sale_fee_amount": 80,
    "free_relist": false,
    "stop_time": "2041-09-08T00:00:00.000-04:00"
}

Próximo: Descrição de produtos.

ou registre-se para receber as últimas notícias sobre nossa API