Última actualización 24/05/2023

Precios de productos

Importante:
Estamos trabajando para actualizar la calidad de esta API y ofrecer vistas públicas y privadas para consultar precios de productos.
Próximamente, eliminaremos:
- el campo price de la API de /items
- los recursos antiguos /prices/types/standard/channels/mshops utilizados para Mercado Shops
Estos deprecados serán comunicado con más de 30 días de anticipación. Te recomendamos comenzar a utilizar esta API de /prices.

A partir de ahora, si publicas y sincronizas items debes consultar los precios relacionados a un producto y contexto (canal y/o nivel de comprador) con las siguientes APIs. Además, puedes conocer el valor exacto de venta. Recuerda que para crear un item y editarlo debes continuar haciéndolo mediante la API de /items. Próximamente, habilitaremos un endpoint para editar precios.

En Mercado Libre puedes ver los precios de la siguiente manera:



Notificaciones sobre precios

Importante:
Próximamente, cuando el campo prices sea deprecado de la API /items, las notificaciones de ítems ya no comunicarán cambios 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 /prices.


Obtener precio de venta actual

Identifica el precio de venta de un producto enviando el parámetro context (canal de venta o nivel del comprador) que quieras consultar. Además, recibirás información sobre las promociones asociadas al ítem: de manera privada (consultas autenticadas), con mayor detalle y de manera pública, con información reducida.


Nota:
Envía por lo menos un channel a la vez y opcional puedes agregar cada nivel de loyalty_level también para cada petición.
Para conocer el canal del producto puede consultar el array de channels en el recurso /items.

Valores posibles para el parámetro context

Canales de venta:

  • channel_marketplace: canal Mercado Libre.
  • channel_mshops: canal Mercado Shops disponible para MLA, MLB, MLM, MLC y MCO. Si aún no trabajas con este canal, conoce más sobre Mercado Shops.
  • channel_proximity, mp_merchants y mp_links: canal de productos publicados en Mercado Pago. Próximamente estarán habilitados.

Nivel del comprador (no disponible en MLU y MPE)

  • buyer_loyalty_3
  • buyer_loyalty_4
  • buyer_loyalty_5
  • buyer_loyalty_6

Llamada:

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

Ejemplo:

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

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 de venta del producto.
  • regular_amount: precio original del producto, en casos que tenga promoción. El precio tachado del precio ganador también es calculado, y se puede tomar de varias fuentes. No necesariamente será el mismo 'regular_amount' del recurso /prices.
  • 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

Conoce todos los tipos de precio, siempre y cuando estén vigentes, 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. Proximamente vamos a disponibilizar el dato de precio promocional.
    • 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 o nivel de loyalty. Conceptualmente son restricciones que solo 'compiten' por ser el precio de venta si el contexto cumple con esos valores, por lo que está restringido a esos valores.