Custos por vender

Documentação do Mercado Livre

Confira todas as informações necessárias sobre as APIs Mercado Livre.

Última atualização em 06/03/2026

Custos por vender

O calculador de listing prices é um recurso somente leitura que oferece muitas formas de conhecer os custos ao vender um artigo pelo Mercado Livre, para que o vendedor possa saber exatamente quanto custará vender em determinado listing_type para um site, categoria, moeda, logística e quantidade específicos.

Importante:

O Mercado Livre atualizou a estrutura de custos de envio. O fixed_fee já não é calculado apenas pelo preço do produto, mas depende do tipo de logística do vendedor.

Datas de ativação:

Brasil: 02/03
Argentina: 12/03
Colombia: 23/03
Chile: 06/04
México: 08/04

Se você não enviar os parâmetros `logistic_type`, `shipping_mode` e `billable_weight` (obrigatório na Argentina), o fixed fee calculado não coincidirá com o que realmente será cobrado do vendedor.

Descrição de atributos

Atributo	Descrição
currency_id	ID de moeda dos custos.
listing_exposure	Nível de exposição do anúncio.
listing_fee_amount	Custos por anunciar.
listing_fee_details	Array que mostra o detalhe dos custos por anunciar: - fixed_fee: taxa fixa por anunciar - gross_amount: valor bruto de comissão (sem aplicar descontos)
listing_type_id	ID do tipo de anúncio.
listing_type_name	Nome do tipo de anúncio.
requires_picture	Mostra se o tipo de anúncio requer, pelo menos, uma imagem.
sale_fee_amount	Custos por vender.
sale_fee_details	Array que mostra o detalhe dos custos por vender: - financing_add_on_fee: custos por adicionar parcelas. - fixed_fee: taxa fixa por vender. - gross_amount: valor bruto de comissão (sem aplicar descontos). - meli_percentage_fee: custos por vender na plataforma (aplica apenas MLA). - percentage_fee: porcentagem de comissão total.

Lembre-se:

Os tipos de anúncio ou listing_type disponíveis para Marketplace são free, gold_special, gold_pro (pode variar segundo o site).
Filtrar por channel para ver as comissões específicas. Caso contrário, você verá por padrão as de marketplace.
Respeitar a relação listing_type + tag ver opções aplica apenas MLA.
Conheça mais sobre custos por vender um produto e opções de parcelas (MLA).
Segundo o site, pode variar a quantidade de atributos na resposta.

Obter o custo de envio de acordo com a nova estrutura

O Mercado Livre atualiza a estrutura de custos de envio para as vendas.

O fixed fee já não é calculado apenas em função do preço do produto, mas também segundo o tipo de logística e o modo de envio que o vendedor usa.

Se você não enviar os novos parâmetros, o fixed fee que obtiver na sua integração não vai coincidir com o que realmente é cobrado. Isso pode gerar:

Informação incorreta mostrada a quem usa sua aplicação.
Diferenças entre os custos projetados e os custos reais.

Com esta consulta você poderá obter o custo real por vender um produto.

Adicione os parâmetros shipping_mode , logistic_type e billable_weight (obrigatório para Argentina) para obter um cálculo mais preciso das comissões.

Chamada:

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

Exemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' \
  "https://api.mercadolibre.com/sites/MLA/listing_prices?price=5000¤cy_id=ARS&category_id=MLA418448&listing_type_id=gold_pro&logistic_type=drop_off&shipping_mode=me2&billable_weight=5828&tags=ahora-3"

Resposta:

[
   [
  {
    "currency_id": "ARS",
    "listing_type_id": "gold_pro",
    "listing_type_name": "Premium",
    "listing_exposure": "highest",
    "listing_fee_amount": 0,
    "listing_fee_details": {
      "fixed_fee": 0,
      "gross_amount": 0
    },
    "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"
  }
]

Parâmetros:

price (number): Define o preço de venda do item.
currency_id (string): Indica a moeda do item usando o identificador de moeda do site.
category_id (string): Especifica a categoria do item mediante seu category_id.
listing_type_id (string): Determina o tipo de anúncio que você aplica ao item.
logistic_type (string): Define o tipo logístico do envio associado ao item. Obter de Documentação
- drop_off: Mercado Envios Drop Off. Modo: me2.
- cross_docking: Mercado Envios Coleta. Modo: me2.
- xd_drop_off: Mercado Envios Places. Modo: me2.
- self_service: Mercado Envios Flex. Modo: me2.
- turbo: Mercado Envios Turbo. Modo: me2.
- fulfillment: Mercado Envios Full. Modo: me2.
- default: Logística padrão. Modo: me1.
- custom: Personalizado. Modo: custom.
- not_specified: Não especificado. Modo: not_specified.
shipping_mode (string): Indica o modo de envio que você usa para o anúncio. Obter de Documentação
- me2: Mercado Envios 2 - Logística gerenciada pelo Mercado Livre
- me1: Mercado Envios 1 - Logística própria do vendedor ou terceiros
- custom: Envio personalizado com tabela de preços do vendedor
- not_specified: Sem modo de envio especificado
billable_weight (number): Envie o peso faturável do pacote, em gramas. Exemplo: 5828 (Obrigatório para Argentina). Obter de Documentação
tags (string): Atribui a campanha de parcelas ativa para o item (disponível apenas na Argentina). Exemplo: ahora-3

Lógica de cálculo

Conheça a nova lógica de cálculo de custos. Essas regras se aplicam assim que cada site ativar esta nova estrutura.

Brasil, Colômbia, Chile, México:

Preço < TH + ME2: Apenas Flex (self_service) cobra custo fixo. Os demais modelos não geram cobrança.
ME1 / custom / not_specified: Sempre é cobrado custo fixo (quando preço < TH).
Preço ≥ TH: Não há cobrança de custo fixo em nenhum caso.
Peso faturável: Não se aplica.
Taxa de venda (sale_fee): Sempre é cobrada uma porcentagem do preço, de acordo com a categoria do produto.

* TH (Limite): Limite de envio grátis obrigatório definido por cada site. Consulte as FAQs de pricing para conhecer os valores específicos.

Filtrar por preço

Recupera informação detalhada sobre tipos de anúncios filtrando pelo preço associado.

Chamada:

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

Exemplo:

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

Resposta:

[
    {
        "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_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": "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"
    }
]

Filtrar por preço e listing type

Recupera informação detalhada sobre tipos de anúncios filtrando pelo preço e listing_type associados.

Chamada:

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

Exemplo:

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

Resposta:

[
    {
        "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"
    }
]

Filtrar por preço e quantidade

Recupera informação detalhada sobre tipos de anúncios filtrando pelo preço e quantidade associados.

Chamada

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

Exemplo:

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

Resposta:

 [
      {
          "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"
      }
  ]

Filtrar por preço e categoria

Recupera informação detalhada sobre tipos de anúncios filtrando pelo preço e categoria do anúncio associados.

Chamada:

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

Exemplo:

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

Resposta:

[
  {
      "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"
  }
]

Filtrar por preço e moeda

Recupera informação detalhada sobre tipos de anúncios filtrando pelo preço e tipo de moeda local associados.

Chamada:

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

Exemplo:

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

Resposta:

[
      {
          "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"
      }
  ]

Filtrar por preço, listing_type e categoria

Recupera informação detalhada sobre tipos de anúncios filtrando por listing_type e categoria do anúncio associados.

Chamada:

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

Exemplo:

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

Resposta:

{
    "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"
}

Filtrar por categorias, preço, tipo de moeda e tipo de logística

Recupera informação detalhada sobre tipos de anúncios filtrando pela categoria, preço, tipo de moeda local, e tipo de logística associados.

Chamada:

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

Exemplo:

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

Resposta:

[
      {
          "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"
      }
  ]

Filtrar por preço, categoria, tags e listing_type

Recupera informação detalhada sobre tipos de anúncios filtrando pelo preço, categoria do anúncio, tags, e listing_type associados.

Chamada:

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

Exemplo:

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

Resposta:

{
  "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": 25.86,
  "sale_fee_details": {
      "financing_add_on_fee": 10.36,
      "fixed_fee": 0,
      "gross_amount": 25.86,
      "meli_percentage_fee": 15.5,
      "percentage_fee": 25.86
  },
  "stop_time": "2043-06-01T00:00:00.000-04:00"
}

Consultar itens de Supermarket

Para calcular a comissão de um item de supermarket, envie o parâmetro `tags` com o valor `supermarket_eligible`.

Chamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' \
"https://api.mercadolibre.com/sites/MLA/listing_prices?price=500&category_id=MLA1403&tags=supermarket_eligible

Erro

{
  "message": "The parameter 'price' has to be a number",
  "error": "bad_request",
  "status": 400,
  "cause": [
  ]
}

Conheça mais sobre:

Campanhas com parcelas para Marketplace (aplica apenas a MLA).
Tipos de anúncio.