• API Docs
  • Guia para productos
  • Precios de productos
Última actualización 17/03/2023

Precios de productos

Gestiona los precios relacionados a un producto y calcula el mejor precio para un producto dependiendo la fecha y contexto.


Obtener precio de venta actual

Importante:
Próximamente, daremos de baja el campo price en la API de /items, por lo tanto, te recomendamos que empiece a trabajar con este recurso para obtener el precio de venta del producto.

Identifica el precio de venta de un producto, utilizando el recurso items/$ITEM_ID/sale_price enviando el parámetro context de acuerdo al canal de la publicación que quieres consultar, se detallarán los posibles valores de este parámetro más adelante.


Nota:
En casos que el producto tenga promociones activas (con diferencia de precio para niveles de Mercado Puntos), también es posible usar el parámetro de context, para obtener el precio por nivel del comprador, ejemplo: buyer_loyalty_3.
Este parámetro no esta disponible para los sites MLU y MPE

Valores posibles para el parámetro context:


  • channel_marketplace
  • channel_mshops
  • channel_proximity (productos publicados en Mercado Pago)
  • buyer_loyalty_3
  • buyer_loyalty_4
  • buyer_loyalty_5
  • buyer_loyalty_6

Para conocer el channel del producto puede consultar el array de channels en el recurso /items.


Llamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/$ITEM_ID/sale_price?context=$CONTEXT

Ejemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/MLB3191390879/sale_price?context=channel_marketplace

Respuesta:

{
   "price_id": "1",
   "amount": 800,
   "regular_amount": null,
   "currency_id": "BRL",
   "reference_date": "2023-02-15T00:23:53Z"
}

Descripción de los campos

  • price_id: ID del precio.
  • amount: precio actual del producto.
  • regular_amount: precio original del producto, en casos que tenga promoción.
  • currency_id: ID de la moneda a la que se refiere el campo amount y regular_amount.
  • reference_date: fecha para la cual está calculando el precio de venta.

Obtener precios del producto

Esta API trae todos los precios originales que puede tener un producto en los diferentes canales donde está publicado.


Llamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/$ITEM_ID/prices

Ejemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/MLB3191390879/prices?

Respuesta:

{
   "id": "MLB3191390879",
   "prices": [
       {
           "id": "1",
           "type": "standard",
           "amount": 800,
           "regular_amount": null,
           "currency_id": "BRL",
           "last_updated": "2023-02-14T18:43:58Z",
           "conditions": {
               "context_restrictions": [
                   "channel_marketplace"
               ],
               "start_time": null,
               "end_time": null
           }
       },
       {
           "id": "2",
           "type": "standard",
           "amount": 650,
           "regular_amount": null,
           "currency_id": "BRL",
           "last_updated": "2023-02-14T18:43:58Z",
           "conditions": {
               "context_restrictions": [
                   "channel_mshops"
               ],
               "start_time": null,
               "end_time": null
           }
       }
   ]
}

Descripción de los campos

  • id: ID del producto.
  • price: monto definido por el vendedor para la publicación en ese contexto.
    • type: tipo de precio. Standard: valor indicado por el vendedor sin promociones.
    • amount: precio del producto.
    • regular_amount: precio original del producto, en casos que tenga promoción.
    • currency_id: ID de la moneda a la que se refiere el campo amount regular_amount.
    • conditions: condiciones bajo las cuales puede aplicar el precio en cuestión.
      • context_restrictions: canal que se aplica el precio.

Notificaciones sobre precios

Para recibir notificaciones sobre los precios, debes suscribirte al tópico items_prices, después de recibir la notificación debe consultar el recurso de /sale_price.