Listing types and exposures

Listings types by site

Site	Premium "id": "gold_pro"	Classic "id": "gold_special"
MLB
MLM
MCO
MLC

With this API you can consult the available listing type per site.

Request:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/marketplace/sites/$SITE_ID/listing_types

Example:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/marketplace/sites/MLB/listing_types

Example:

[
   {
       "site_id": "MLB",
       "id": "gold_pro",
       "name": "Premium"
   },
   {
       "site_id": "MLB",
       "id": "gold_special",
       "name": "Clássico"
   }
]

Create marketplace item with "gold_special" listing type

Example:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN'  -H 'Content-Type: application/json' https://api.mercadolibre.com/marketplace/items/CBT1234 
{
  "config": [
    {
      "site_id": "MLB",
      "logistic_type": "remote",
      "price":11.23,
      "listing_type_id": "gold_special"
    }
  ]
}

See more about creating marketplace items.

Edit listing type

If you have items in MLB and MCO with "gold_pro" (Premium), you can update to "gold_special" (Classic).

Request:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -H "Accept: application/json" -d
{
  "id": "gold_special"
}
https://api.mercadolibre.com/marketplace/items/$ITEM_ID/listing_type

Get available upgrades

You can make upgrades to higher listing types to give your listings more exposure on our sites. If you need to make an upgrade, you can check which listing types are available for your item. Listings are allowed to have downgrades from gold_pro to gold_special and back anytime.

Example:

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

Response:

[
   {
       "site_id": "MLB",
       "id": "gold_pro",
       "name": "Premium"
   }
]

Next: Product identifiers.