Documentación Mercado Libre

Descubre toda la información que debes conocer sobre las APIs de Mercado Libre.
circulos azuis em degrade

Documentación

Última actualización 25/09/2024

Gestionar sugerencias de precios

Las sugerencias de precios en Mercado Libre es una recomendación que ofrece la plataforma para ayudar a los vendedores a establecer un precio competitivo para sus productos. Esta sugerencia se basa en un análisis de los precios actuales de artículos similares en la plataforma y plataformas externas, el historial de ventas y la demanda del producto. El objetivo es guiar al vendedor para que fije un precio que sea atractivo para los compradores, incrementando así las posibilidades de venta y mejorando su posicionamiento en los resultados de búsqueda.

Esta recomendación es parte de las herramientas que Mercado Libre proporciona para optimizar las ventas, y aunque es opcional seguirla, hacerlo puede resultar en beneficios significativos como una mayor visibilidad y un aumento en las ventas.

Obtener items con sugerencias de precios por vendedor

Devuelve un listado de items_id que tengan sugerencias de precios para un seller_id específico.

Pre condiciones para obtener sugerencias de precios por vendedor

  • Debe consultarse sobre un usuario existente

Llamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' 
https://api.mercadolibre.com/suggestions/user/$USER_ID/items

Ejemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' 
https://api.mercadolibre.com/suggestions/user/12345678/items

Respuesta:

{
    "total": 3,
    "items": [
        "MLM2098685855",
        "MLM3092970874",
        "MLM2081093293"
    ]
}

Campos de la respuesta:

La respuesta de un GET al recurso suggestions/user/$USER_ID/items proporcionará los siguientes parámetros

  • total: Cantidad total de ítems con sugerencias
  • items: Lista de IDs de ítems con sugerencias.

Obtener detalle de la sugerencia de precios por item_id

Para consultar el precio sugerido para asignarle a un ítem específico, es necesario realizar un GET al recurso /suggestions/items/{itemId}/details

Pre condiciones para obtener sugerencias de precios

  • Debe consultarse sobre un ítem existente

Llamada:

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

Ejemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' 
https://api.mercadolibre.com/suggestions/items/MLA12345678/details

Respuesta:

{
    "item_id": "MLM2077308861",
    "status": "with_benchmark_highest",
    "currency_id": "MXN",
    "ratio": 0,
    "current_price": {
        "amount": 150000,
        "usd_amount": 0
    },
    "suggested_price": {
        "amount": 230,
        "usd_amount": 0
    },
    "lowest_price": {
        "amount": 230,
        "usd_amount": 0
    },
    "costs": {
        "selling_fees": 67.5,
        "shipping_fees": 73
    },
    "applicable_suggestion": false,
    "percent_difference": 100,
    "metadata": {
        "graph": [
            {
                "price": {
                    "amount": 50000,
                    "usd_amount": 0
                },
                "info": {
                    "title": "Mate De Test No Ofertar",
                    "sold_quantity": 0
                }
            }
        ],
        "compared_values": 1
    },
    "promotion_detail": {
        "unhealthy_reason": "no_sales",
        "days_unhealthy": 30,
        "campaign_start_date": "2024-06-16",
        "campaign_end_date": "2024-07-20",
        "promotion_id": "P-MLC13857010",
        "discount_percent": 30,
        "campaign_name": "UNHEALTHY_STOCK"
    },
    "last_updated": "01-08-2024 11:30:07"
}

Campos de la respuesta

La respuesta de un GET al recurso /suggestions/items/{{itemId}}/details proporcionará los siguientes parámetros:

  • item_id: Identificador del ítem
  • status: Estado de la sugerencia de precios en relación con el benchmark de competencia. Las posibles sugerencias de precio son:
    • with_benchmark_highest
    • not_optin_applied
  • currency_id: Identificador de la moneda en la que se expresan los precios
  • ratio: Relación entre el precio actual y el precio sugerido
  • current_price: Precio actual del ítem.
    • amount: Monto en la moneda local.
    • usd_amount: Monto en dólares estadounidenses.
  • suggested_price: Precio sugerido comparando con la competencia.
    • suggested_price_amount: Monto sugerido en la moneda local.
    • usd_amount: Monto sugerido en dólares estadounidenses.
  • lowest_price: Precio mínimo existente en este ítem
    • amount: Precio expresado en moneda local
    • usd_amount: Precio expresado en dólares
  • costs: Costos relacionados con la venta del ítem
    • selling_fees: Costos por la venta del ítem.
    • shipping_fees: Costos por el envío del ítem.
  • applicable_suggestion: Si la sugerencia de precio es aplicable para este ítem o no.
  • percent_difference: Porcentaje de diferencia entre el precio actual y el sugerido.
  • metadata:
    • graph: Lista de objetos que contienen detalles de ítems similares para comparar.
    • price: Precio del ítem similar.
      • amount: Precio en la moneda local.
      • usd_amount: Precio convertido a dólares estadounidenses.
  • info:
    • title: Nombre de la publicación
    • sold_quantity: Cantidad vendida del ítem
  • compared_values: Cantidad de valores comparados.
  • last_updated: Fecha de la última sugerencia de precio.
  • Posibles errores al consultar sugerencias de precios de un ítem

    Al consultar la sugerencia de precios de un ítem, es posible que te encuentres con los siguientes errores. Es crucial que entiendas la causa de cada uno y sepas cómo corregirlos, para manejar eficientemente la situación. Aquí tienes la información necesaria para identificar y resolver estos problemas.

    Response bad req:

    {
        "message": "client id not allowed",
        "error": "",
        "status": 400,
        "cause": []
    }

    El item no pertenece al seller:

    {
        "message": "Caller is not the item's owner",
        "error": "",
        "status": 401,
        "cause": []
    }

    No autorizado:

    {
        "code": "unauthorized",
        "message": "invalid access token"
    }

    Item consultado no cuenta con sugerencias:

    {
        "message": "item price suggestion not found, item id: [MLM2890672004], error: [kvs: key not found]",
        "error": "",
        "status": 404,
        "cause": []
    }

    Siguiente: Automatizaciones de precios