Items & Searches

This examples will help you work with items and make searches on MercadoLibre.

ResourceDescriptionExample
/itemsAllows listing items. POST

/items/{Item_id}Allows managing listings GET PUT

/items/validateValidate the JSON before posting an item. POST

/items/{Item_id}/available_upgradesReturns available listing types to upgrade an item exposure. GET

/items/{Item_id}/relistAllows to relist an item. GET

/items/{Item_id}/pictures/{picture_id}Manage item pictures. GET DELETE

/items/{Item_id}/picturesAdd and update pictures on your item. GET PUT

/items/{Item_id}/descriptionManage description for an item. GET PUT

/sites/{Site_id}/search?q=ipodRetrieves items from a search query. GET

/sites/{Site_id}/searchUrl?q=ipodSearch for any item in MercadoLibre. It will return an array of items url that match the search criteria. GET

/sites/MLA/search?category={Category_id}&official_store_id=allSearch for all items listed by Official Stores for a given category. GET

/sites/{Site_id}/hot_items/search?limit=5&category={Category_id}Retrieves an array of hot items from a specified category by parameter. Works only with the first level of categories. GET

/sites/{Site_id}/featured_items/HP-{Category_Id}Retrieves an array of featured items. The featured items are items that have a special exposure at home page or categories page. You can use only HP for products of home or HP-{categId} for featured by category. Only works with first level of categories. GET

/sites/{Site_id}/trends/search?category={Category_id}Retrieve an array of the trends items from the category specified by parameter. GET

/sites/{Site_id}/search?seller_id={Seller_id}&category={Category_id}&access_token=$ACCESS_TOKENSearch items by seller_id for a category. GET

/users/{Cust_id}/items/search?access_token=$ACCESS_TOKENRetrieves user’s listings. GET

/items/{Item_id}/product_identifiers/Retrieves the product identifier codes associated to your item. GET PUT

/items/{Item_id}/variationsManage item’s variations. GET POST

/items/{Item_id}/variations/{Variation_id}Manage variations. GET PUT DELETE

/users/{Cust_id}/items/search?sku={seller_custom_field}&status=active&access_token=$ACCESS_TOKENSearch item by SKU.
Filter item by status.
GET

/users/{Cust_id}/items/search?tags=price_review&access_token={access_token}View items with price_reviewGET

Please rate this