Pricing Suggestion

Get items by user

This will allow you to obtain a list of all items from the seller that have an opportunity for price improvement.

Request:

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

Example:

curl -H 'Authorization: Bearer $ACCESS_TOKEN' -X GET https://api.mercadolibre.com/marketplace/benchmarks/user/1305627900/items

Response:

{
    "total": 3,
    "items": [
        "MLB3770847075",
        "MLB3746732952",
        "MLB3690598506"
    ]
}

Response fields

total: total number of items.

items: list of items represented by a string value.

Get item detail

This request will allow you to obtain, for a particular item, all the information related to the price improvement opportunity.

Request:

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

Example:

curl -H 'Authorization: Bearer $ACCESS_TOKEN' -X GET https://api.mercadolibre.com/marketplace/benchmarks/items/MLB3746732952/details?

Response:

{
    "item_id": "MLB3746732952",
    "status": "no_benchmark_ok",
    "currency_id": "BRL",
    "ratio": 5.87,
    "strategy_type": "similar_price",
    "current_price": {
        "amount": 6104.8,
        "usd_amount": 1040
    },
    "suggested_price": {
        "amount": 6104.8,
        "usd_amount": 1040
    },
    "estimated_taxes": {
        "amount": 5736.81,
        "usd_amount": 977.29
    },
    "lowest_price": {
        "amount": 6000,
        "usd_amount": 1022.15
    },
    "internal_price": {
        "amount": 6104.8,
        "usd_amount": 1040
    },
    "external_price": {
        "amount": 0,
        "usd_amount": 0
    },
    "percent_difference": 0,
    "costs": {
        "selling_fees": 171.6,
        "shipping_fees": 39.42
    },
    "applicable_suggestion": false,
    "metadata": {
        "type": "",
        "graph": [
            {
                "item_id": "",
                "price": {
                    "amount": 12487.38,
                    "usd_amount": 2127.32
                },
                "info": {
                    "thumbnail": "",
                    "title": "Mochila Negra",
                    "url": "",
                    "sold_quantity": 0
                },
                "quantity": 0,
                "current": false,
                "suggested": false
            },
            {
                "item_id": "",
                "price": {
                    "amount": 12487.38,
                    "usd_amount": 2127.32
                },
                "info": {
                    "thumbnail": "",
                    "title": "Mochila Negra",
                    "url": "",
                    "sold_quantity": 0
                },
                "quantity": 0,
                "current": false,
                "suggested": false
            },
            {
                "item_id": "",
                "price": {
                    "amount": 12487.38,
                    "usd_amount": 2127.32
                },
                "info": {
                    "thumbnail": "",
                    "title": "Mochila Negra",
                    "url": "",
                    "sold_quantity": 0
                },
                "quantity": 0,
                "current": false,
                "suggested": false
            },
            {
                "item_id": "",
                "price": {
                    "amount": 20450,
                    "usd_amount": 3483.82
                },
                "info": {
                    "thumbnail": "",
                    "title": "Mochila De Lona De Anime De Una Pieza",
                    "url": "",
                    "sold_quantity": 0
                },
                "quantity": 0,
                "current": false,
                "suggested": false
            },
            {
                "item_id": "",
                "price": {
                    "amount": 20450,
                    "usd_amount": 3483.82
                },
                "info": {
                    "thumbnail": "",
                    "title": "Mochila De Lona De Anime De Una Pieza",
                    "url": "",
                    "sold_quantity": 0
                },
                "quantity": 0,
                "current": false,
                "suggested": false
            }
        ],
        "compared_values": 5
    },
    "external_metadata": {
        "rival_info": null,
        "compared_values": 0
    },
    "last_updated": "25-06-2024 10:35:55"
}

Response fields

item_id: ID of the item.
status: status of the item, in this case, "with_benchmark_highest". Available values:

• no_benchmark_lowest: item price is lower than the suggested price.
• no_benchmark_ok: item price equals the suggested price.
• with_benchmark_high: item price is greater than the suggested price.
• with_benchmark_highest: item price is greater than the suggested price and is equal to or greater than the maximum price among all the prices with which the item is compared.

currency_id: currency used, in this case, "MXN" (Mexican Peso).
ratio: ratio associated with the price of the item.
current_price: current price of the item, including the "amount" (20170 MXN) and the equivalent "usd_amount" (1000 USD).

• amount: price expressed in local currency.
• usd_amount: price expressed in dollars.

suggested_price: suggested price for the item, including the "amount" (15127.5 MXN) and the equivalent "usd_amount" (750 USD).
lowest_price:
estimated_taxes: estimated taxes for the item, including the "amount" and the equivalent "usd_amount".
internal_price: suggested price compared internally at Mercado Libre.
percent_difference: percentage difference between the current price and the suggested price (27%).
costs: costs associated with the item, including "selling_fees" (150 MXN) and "shipping_fees" (31.25 MXN).
metadata: metadata about the item.

type: type of metadata. Available values: similar_price and adjusted_price.

graph: additional information about a related item.

• item_id: no information provided.
• price: provides the price details for the related item, including the amount (3047.39 MXN) and the equivalent usd_amount (177.38 USD).
• info: only title information is shared.
• quantity: no information provided.
• current: specifies whether the related item is the current item (false in this case).
• suggested: specifies whether the related item is suggested (false in this case).
• compared_values: indicates the number of compared values (1 in this case).

Errors

Next: Manage automations.