Relist your items

Relist is an action that you may only do when your listing is in status “closed”, manually or through API. Relisting implies the creation of a NEW item with the exact same elements as, what we call, its parent.
You can send a PUT request with a closed status at any time your item is active or paused and close it your self.

Contents:

Considerations

You’ll find that according to the type of item you’ve listed, some components will show different behaviours when they are relisted:

Bids & Visits:
Items inherit historical bids and visits. Classifieds items don’t get bids, but they inherit historic visits.
Questions: Only not_answered questions on the parent item will be inherit when relisted.
Reviews: It’s a special feature for the “Services” category in Classifieds items. When a Service is relisted, it will inherit the reviews from the parent item in order to keep reviews up to date.

Notes:

  • Auction items don’t inherit any of these.
  • The titles in items with bids can be modify.

Make a GET call to the Items API and check the attribute sold_quantity to know how many bids your item has had:
Call:

curl GET -X https://api.mercadolibre.com/items/MLA516387765

Example:

"initial_quantity": 3,
  "available_quantity": 3,
  "sold_quantity": 1,

 

Check current status and expiration date

Before making any changes you may need to check your item’s status and expiration date. Make a call to the item’s resource with your item_id:
Call:

curl GET -x https://api.mercadolibre.com/items/{item_id}

Once you got a response, check the stop_time element to get the expiration date of the item. This information is also available in the response body you receive when successfully listing the item in the first place, so maybe if you keep a database you may want to store it.

As stated before, relisting an item generates a NEW item, which means that the Item ID MercadoLibre assigns to that item will be a new one. You will be able to obtain this new ID from the JSON in the response body you receive when successfully relisting your items. The parent_id attribute on the API links to the original item.

Relist your item

Remember that items must be in a closed status in order to relist them. Then you just need to make a POST to the relist resource and send price, quantity and listing_type_id on the request body.
Example:

curl -X POST -H "Content-Type: application/json" -d '{
  "price": 20000,
  "quantity": 1,
  "listing_type_id": "silver"
}' https://api.mercadolibre.com/items/{item_id}/relist?access_token=$ACCESS_TOKEN

If your item has been successfully relisted, you will receive a 201 Created response status. Keep in mind that it might take some minutes before you see the item listed in our site. To relist an item with variations, please check this article.

Relisting standard variations

If your listing finished but you still have some variations in stock, you can relist them sending only the current variations, together with the available quantity and price of each of them.
Example:

curl -X POST -H "Content-Type: application/json" -d'{
    "listing_type_id": "bronze",
    "variations": [
        {
            "id": 10448277573,
            "price": 1,
            "quantity": 200
        },
        {
            "id": 10448277576,
            "price": 4,
            "quantity": 200
        },
        {
            "id": 10448293016,
            "price": 2,
            "quantity": 200
        }
    ] }' https://api.mercadolibre.com/items/MLA599074368/relist?access_token=$ACCESS_TOKEN

Response:

{  
   "id":"MLA599099879",
   "site_id":"MLA",
   "title":"Test Item - No Ofertar",
   "subtitle":null,
   "seller_id":202593498,
   "category_id":"MLA374515",
   "official_store_id":null,
   "price":4,
   "base_price":4,
   "original_price":null,
   "currency_id":"ARS",
   "initial_quantity":600,
   "available_quantity":600,
   "sold_quantity":0,
   "buying_mode":"buy_it_now",
   "listing_type_id":"bronze",
   "start_time":"2016-01-07T18:00:38.518Z",
   "stop_time":"2016-03-07T18:00:38.518Z",
   "end_time":"2016-03-07T18:00:38.518Z",
   "condition":"new",
   "permalink":"http://articulo.mercadolibre.com.ar/MLA-599099879-test-item-no-ofertar-_JM",
   "thumbnail":"http://mla-s2-p.mlstatic.com/749311-MLA20539854842_012016-I.jpg",
   "secure_thumbnail":"https://a248.e.akamai.net/mla-s2-p.mlstatic.com/749311-MLA20539854842_012016-I.jpg",
   "pictures":[  
      {  
         "id":"749311-MLA20539854842_012016",
         "url":"http://mla-s2-p.mlstatic.com/749311-MLA20539854842_012016-O.jpg",
         "secure_url":"https://a248.e.akamai.net/mla-s2-p.mlstatic.com/749311-MLA20539854842_012016-O.jpg",
         "size":"300x300",
         "max_size":"300x300",
         "quality":""
      },
      {  
         "id":"710411-MLA20539854841_012016",
         "url":"http://mla-s1-p.mlstatic.com/710411-MLA20539854841_012016-O.jpg",
         "secure_url":"https://a248.e.akamai.net/mla-s1-p.mlstatic.com/710411-MLA20539854841_012016-O.jpg",
         "size":"401x500",
         "max_size":"500x622",
         "quality":""
      },
      {  
         "id":"230411-MLA20540036877_012016",
         "url":"http://mla-s2-p.mlstatic.com/230411-MLA20540036877_012016-O.jpg",
         "secure_url":"https://a248.e.akamai.net/mla-s2-p.mlstatic.com/230411-MLA20540036877_012016-O.jpg",
         "size":"236x455",
         "max_size":"236x455",
         "quality":""
      }
   ],
   "video_id":null,
   "descriptions":[  
      {  
         "id":"MLA599099879-1003435516"
      }
   ],
   "accepts_mercadopago":true,
   "non_mercado_pago_payment_methods":[  

   ],
   "shipping":{  
      "mode":"not_specified",
      "local_pick_up":false,
      "free_shipping":false,
      "methods":[  

      ],
      "dimensions":null,
      "tags":[  

      ]
   },
   "international_delivery_mode":"none",
   "seller_address":{  
      "id":175597910,
      "comment":"",
      "address_line":"Test Address 123",
      "zip_code":"1414",
      "city":{  
         "id":"",
         "name":"Palermo"
      },
      "state":{  
         "id":"AR-C",
         "name":"Capital Federal"
      },
      "country":{  
         "id":"AR",
         "name":"Argentina"
      },
      "latitude":-34.5711496,
      "longitude":-58.4232966,
      "search_location":{  
         "neighborhood":{  
            "id":"",
            "name":""
         },
         "city":{  
            "id":"TUxBQ0NBUGZlZG1sYQ",
            "name":"Capital Federal"
         },
         "state":{  
            "id":"TUxBUENBUGw3M2E1",
            "name":"Capital Federal"
         }
      }
   },
   "seller_contact":null,
   "location":{  

   },
   "geolocation":{  
      "latitude":-34.5711496,
      "longitude":-58.4232966
   },
   "coverage_areas":[  

   ],
   "attributes":[  
      {  
         "id":"GENDER",
         "name":"Género",
         "value_id":"female",
         "value_name":"Mujer",
         "attribute_group_id":"DFLT",
         "attribute_group_name":"Otros"
      },
      {  
         "id":"Season",
         "name":"Season",
         "value_id":"Season-All-Season",
         "value_name":"All-Season",
         "attribute_group_id":"DFLT",
         "attribute_group_name":"Otros"
      }
   ],
   "listing_source":"",
   "variations":[  
      {  
         "id":10449631060,
         "attribute_combinations":[  
            {  
               "id":"83000",
               "name":"Color Primario",
               "value_id":"92028",
               "value_name":"Blanco"
            },
            {  
               "id":"93000",
               "name":"Talle",
               "value_id":"101994",
               "value_name":"S"
            }
         ],
         "price":1,
         "available_quantity":200,
         "sold_quantity":0,
         "picture_ids":[  
            "749311-MLA20539854842_012016"
         ],
         "seller_custom_field":null,
         "attributes":[  

         ]
      },
      {  
         "id":10449631063,
         "attribute_combinations":[  
            {  
               "id":"83000",
               "name":"Color Primario",
               "value_id":"91994",
               "value_name":"Rosa"
            },
            {  
               "id":"73001",
               "name":"Color Secundario",
               "value_id":"82035",
               "value_name":"Crema"
            },
            {  
               "id":"93000",
               "name":"Talle",
               "value_id":"101995",
               "value_name":"M"
            }
         ],
         "price":4,
         "available_quantity":200,
         "sold_quantity":0,
         "picture_ids":[  
            "710411-MLA20539854841_012016",
            "230411-MLA20540036877_012016"
         ],
         "seller_custom_field":"21000093",
         "attributes":[  

         ]
      },
      {  
         "id":10449631067,
         "attribute_combinations":[  
            {  
               "id":"83000",
               "name":"Color Primario",
               "value_id":"91994",
               "value_name":"Rosa"
            },
            {  
               "id":"93000",
               "name":"Talle",
               "value_id":"101996",
               "value_name":"L"
            }
         ],
         "price":2,
         "available_quantity":200,
         "sold_quantity":0,
         "picture_ids":[  
            "710411-MLA20539854841_012016"
         ],
         "seller_custom_field":null,
         "attributes":[  

         ]
      }
   ],
   "status":"not_yet_active",
   "sub_status":[  

   ],
   "tags":[  
      "dragged_bids_and_visits"
   ],
   "warranty":null,
   "catalog_product_id":null,
   "seller_custom_field":null,
   "parent_item_id":"MLA599074368",
   "differential_pricing":null,
   "deal_ids":[  

   ],
   "automatic_relist":false,
   "date_created":"2016-01-07T18:00:38.701Z",
   "last_updated":"2016-01-07T18:00:38.701Z"
}

Relisting custom variations

If your listing finished but you still have some variations in stock, you can relist them sending the variations you wish to keep, available quantity, and price of each of them.
Example:

curl -X POST -H "Content-Type: application/json" -d'{
    "listing_type_id": "bronze",
    "variations": [
        {
            "id": 10541993184,
            "price": 1000,
            "quantity": 2
        },
        {
            "id": 10541993186,
            "price": 1000,
            "quantity": 2
        },
                {
            "id": 10542199553,
            "price": 1000,
            "quantity": 1
        }
    ] }' https://api.mercadolibre.com/items/MLA601053403/relist?access_token=¢ACCESS_TOKEN

As you can see in the response, when a product is relisted, a new listing is generated so we will renew your variations “Item_id” and “Id”.

Please rate this