Pricing Reference

Get items with price references by seller

Returns a list of items_id that have price references for a specific seller_id.

Preconditions for getting price references by seller

• Must query an existing user

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:

The response of a GET to the /marketplace/benchmarks/user/$USER_ID/items resource will provide the following parameters

total: total number of items.

items: list of items represented by a string value.

Get price reference details by item_id

To query the referred price to assign to a specific item, you need to perform a GET on the resource /marketplace/benchmarks/items/$ITEM_ID/details

Preconditions for obtaining price references

• Must query an existing item

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/MLB5324094348/details?

Response:

{
    "item_id": "MLB5324094348",
    "status": "no_benchmark_ok",
    "currency_id": "BRL",
    "ratio": 5.51,
    "strategy_type": "similar_price",
    "current_price": {
        "amount": 2755,
        "usd_amount": 500
    },
    "suggested_price": {
        "amount": 2755,
        "usd_amount": 500
    },
    "estimated_taxes": {
        "amount": 2459.57,
        "usd_amount": 446.75
    },
    "lowest_price": {
        "amount": 0,
        "usd_amount": 0
    },
    "internal_price": {
        "amount": 2755,
        "usd_amount": 500
    },
    "external_price": {
        "amount": 0,
        "usd_amount": 0
    },
    "percent_difference": 0,
    "costs": {
        "selling_fees": 82.5,
        "shipping_fees": 7.53
    },
    "applicable_suggestion": false,
    "metadata": {
        "type": "",
        "graph": [
            {
                "item_id": "",
                "price": {
                    "amount": 8540.5,
                    "usd_amount": 1550
                },
                "info": {
                    "thumbnail": "",
                    "title": "Teste E Teste Ads 2",
                    "url": "",
                    "sold_quantity": 0
                },
                "quantity": 0,
                "current": false,
                "suggested": false
            }
        ],
        "compared_values": 1
    },
    "external_metadata": {
        "rival_info": null,
        "compared_values": 0
    },
    "last_updated": "09-12-2025 14:33:36"
}

Response fields

item_id: ID of the item.
status: Status of the price reference in relation to the competition benchmark. The possible price references are:

• no_benchmark_lowest: item price is lower than the reference price.
• no_benchmark_ok: item price equals the reference price.
• with_benchmark_high: item price is greater than the reference price.
• with_benchmark_highest: item price is higher than both the reference price and the maximum price of its competitors.

currency_id: currency used, in this case, "MXN" (Mexican Peso).
ratio: Relationship between the current price and the reference price.
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: reference 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: reference price compared internally at Mercado Libre.
applicable_suggestion: whether the price reference is applicable to this item or not.
percent_difference: percentage difference between the current price and the reference price (27%).
costs: costs associated with the item, including "selling_fees" (150 MXN) and "shipping_fees" (31.25 MXN).

last_updated: last price reference date.
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 referenced (false in this case).
• compared_values: indicates the number of compared values (1 in this case).

Possible errors when querying an item's price references

When querying an item's price reference, you may encounter the following errors. It is crucial that you understand the cause of each one and know how to correct them, to efficiently handle the situation. Here you have the necessary information to identify and resolve these problems.

Next: Manage automations.