API Directory


REST API Resources.

 

Users and Apps

Under users and apps we will find all the resources relatives to mercadolibre users, applications and scopes.

Resource Description Example
/users/{Cust_id} Returns the user public information such as nickname, country, user type and reputation, specified by the user_id. If the user is logged, more information will be available. GET   PUT

/users/{Cust_id}/addresses?access_token=$ACCESS_TOKEN Retrieves the addresses of the user specified by user_id. This resource requires an access token. GET

/users/{Cust_id}/accepted_payment_methods Returns the payment methods accepted by a merchant to collect their operations. GET

Categories and Listings

Use the correct site for your application, you can pick from MLA, MLB among other and their respective categories and type of publications.
Retrieves the categories availables from the site.

Resource Description Example
/sites Retrieves information about the sites where MercadoLibre runs. GET

/sites/{Site_id} Retrieves information about an specific MercadoLibre site. GET

/site_domains/{Site_domain_url} Retrieves information about the domain. GET

/sites/{Site_id}/listing_types Retrieves information about the listing types. GET

/sites/{Site_id}/listing_exposures Retrieves different exposure levels associated to all listing types in MercadoLibre. GET

/sites/{Site_id}/listing_prices?price={Price} Retrieves the listing price for selling and buying in MercadoLibre. GET

/sites/{Site_id}/categories Retrieves the categories availables from the site. GET

/categories/{Category_id} Retrieves the information about a MercadoLibres category. GET

/categories/{Category_id}/attributes Displays attributes and rules over them in order to describe the items that are stored in each category. Rules are executed while posting the item. So the current attribute settings may be inconsistent with items which have been posted with another configuration. GET

Locations and Currencies

Resources that gives the regional information, countries, cities and currency.

Resource Description Example
/countries Retrieves countries information. GET

/countries/{Country_id} Retrieves country information by country_id. GET

/states/{State_id} Retrieves state information. GET

/cities/{City_id} Retrieves city information. GET

/currencies Retrieves information about currencies used in MercadoLibre. GET

/currencies/{Currency_id} Retrieves information about currencies used in MercadoLibre by currency_id. GET

/currency_conversions/search?from={Currency_id}&to={Currency_id} Retrieves the convertion ratio between currencies that MercadoLibre uses in calculations. GET

/countries/{Country_id}/zip_codes/{Zip_code} Retrieves data for the location of the zip code entered GET

Items and Searches

The heart of MercadoLibre API, the resources for searching and managing items.

Resource Description Example
/items This resource allows to interact with items. POST

/items/{Item_id} Retrieves the information of a listed item. GET PUT

/items/validate This resource allows to test a json to list an item. POST

/items/{Item_id}/available_upgrades Returns the data to change the listing type of an item. GET

/items/{Item_id}/relist This resource allows to relist a item. POST

/items/{Item_id}/pictures Retrieves all item’s pictures. GET POST

/pictures/{Picture_id} Retrieves picture’s information of an item. GET

/items/{Item_id}/description Retrieves an item description. GET PUT

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

/sites/{Site_id}/searchUrl?q=ipod Search for any item in MercadoLibre. It will return an array of items that match the search criteria. 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} Search items by seller_id for a category. GET

/users/{Cust_id}/items/search?access_token=$ACCESS_TOKEN Send your Cust_id and your access_token to get data about your own items. GET

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

Order Management

The core of the business: the transactions. Using the order resources, can easily access to purchases, give feedback and follow any order

Resource Description Examples
/orders/search?seller={Seller_id}&access_token=$ACCESS_TOKEN Search the orders from a seller. GET

/orders/search?buyer={Buyer_id}&access_token=$ACCESS_TOKEN Search the orders from a buyer. GET

/payments/{Payment_id}?access_token=$ACCESS_TOKEN Returns data for a payment, according to the profile of the sender of the payment. GET

/sites/{Site_id}/payment_methods Returns the payment methods provided by MercadoPago. GET

/orders/{Order_id}/feedback?version=3.0?access_token=$ACCESS_TOKEN Get the feedback received from a buyer or seller in an order. GET POST

/order/{Order_id}/feedback/sale?version=3.0 SEND SALE FEEDBACK. PUT

/order/{Order_id}/feedback/purchase?version=3.0 Retrieves data from a feedback made by buyer. GET PUT

/feedback/{Feedback_id}?version=3.0&access_token=$ACCESS_TOKEN Change feedback. PUT

/feedback/{Feedback_Id}/reply?version=3.0 Retrieves data from a feedback made by saller. PUT

/users/{Seller_id}/order_blacklist Retrieves all users blocked to bid on a seller items. GET POST DELETE

For more information about working with online payments check MercadoPago

Shipping

Using this resources, can access deliveries, send tracking number and much more.

Resource Description Example
/shipments/{Shipment_id} Retrieves all data to make a delivery. GET PUT

/items/{Item_id}/shipping_options Retrieves all methods available to send the product. GET

/sites/{Site_id}/shipping_methods Retrieves shipping modes available in a country. GET

/sites/{Site_id}/shipping_services Retrieves shipping services available in a country. GET

/sites/{Site_id}/shipping_options?zip_code_from={Zip_code}&zip_code_to={Zip_code}&dimensions={Dimensions} Retrieves the cost of a shipping. Shipping cost calculator per country. GET

/users/{Cust_id}/shipping_modes?category_id={Category_id} Retrieves methods available to list a item of a user. GET

/users/{Cust_id}/shipping_options?zip_code={Zip_code}&dimensions={Dimensions} Retrieves the cost of a shipping. Shipping cost calculator. GET

/users/{Cust_id}/shipping_preferences Retrieves all shipping modes and services available to user. GET

/orders/{Order_id}/shipments Retrieves data of the shipping methods chosen. GET

/shipment_labels Allows print the ticket for send the order. GET

Questions

Ask question, receive answers.

Resource Description Example
/questions/search?item={Item_id} Search any question made to user products. GET

/questions/{Item_id} Ask questions. POST

/answers Answer questions. POST

/questions/{Question_id} Retrieves information for an specific question id. GET

/users/{Seller_id}/questions_blacklist?access_token=$ACCESS_TOKEN Check an user questions blacklist. GET POST DELETE

/my/received_questions/search Received questions by user. GET