Shipping

This examples will guide you through shipping resources

ResourceDescriptionExample
/shipments/{Shipment_id}Retrieves all data to make a delivery GET

/items/{Item_id}/shipping_optionsRetrieves all methods available to send the product. Valid for custom shipments only. GET

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

/sites/{Site_id}/shipping_servicesRetrieves 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_options?zip_code={Zip_code}&quantity={Quantity}Retrieves the cost of a shipping. Shipping cost calculator GET

/users/{Cust_id}/shipping_preferencesRetrieves all shipping modes and services available to user GET

/orders/{Order_id}/shipmentsRetrieves data of the shipping methods chosen GET

/shipment_labelsAllows print the ticket for send the order GET

/shipment_labels?shipment_ids={shipping_id}&response_type=zpl2&access_token={access_token}Allows print the ticket for send the order in Zebra Format GET

/shipment_labels?shipment_ids={shipping_id}&savePdf=Y&access_token={access_token}Allows print the ticket for send the order in PDF Format GET

Please rate this

Metrics

This examples will teach you how to use our resources to take metrics.

ResourceDescriptionExample
/users/{User_id}/items_visits?date_from={Date_from}&date_to={Date_to}Returns how many visits a users had GET

/users/{User_id}/items_visits/time_window?last={Last}&unit={Unit}&ending={Ending}Retrieves visits on every classified item of an user for a certain time window, by site. The information detail it’s grouped by time intervals. GET

/users/{User_id}/contacts/questions?date_from={Date_from}&date_to={Date_to}Retrieve the total questions an specific user had in all of his classified items between a date range. GET

/users/{User_id}/contacts/questions/time_window?last={Last}&unit={Unit}This resource let you get the questions made on a seller classified items for a certain time window. GET

/users/{User_id}/contacts/questions/time_window?last={Last}&unit={Unit}This resource let you get the questions made on a seller classified item for a certain time window. GET

/users/{User_id}/contacts/phone_views?date_from={Date_from}&date_to={Date_to}You can get the total times the ‘See phone’ option was clicked for every item of an user between date ranges. GET

/users/{User_id}/contacts/phone_views/time_window?last={Last}&unit={Unit}You can get the total times the ‘See phone’ option was clicked on an item or for every item of an user on a time window. GET

/items/visits?ids={Id1, Id2}&date_from={Date_from}&date_to={Date_to}Retrieves item’s visits (Multi-Get). GET

/items/{Item_id}/visits/time_window?last={Last}&unit={Unit}&ending={Ending}Retrieves item’s visits on a time window filtering by unit and ending parameters. GET

/items/visits/time_window?ids={Id1, Id2}last={Last}&unit={Unit}&ending={Ending}Retrieves multiple item’s visits on a time window filtering by unit and ending parameters(Multi Get) GET

/items/contacts/phone_views/time_window?ids={Id1,Id2}&last={Last}&unit={Unit}&ending={Ending_date}Retrieves how many time user’s clicked on “See phone” for multiple items (Multi Get). GET

Please rate this

Questions & Answers

This examples will help you manage questions and answers.

ResourceDescriptionExample
/questions/search?item={Item_id}&access_token=$ACCESS_TOKENSearch any question made to user’s items. GET

/questions/{Item_id}Ask questions on other user’s items. POST

/answersAnswer questions made on your items. POST

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

/users/{Seller_id}/questions_blacklist/$Buyerid?access_token=$ACCESS_TOKENManage questions blacklist. GET GET POST DELETE

/my/received_questions/searchReceived questions by user. GET

Please rate this

Orders & Feedback

This examples will help you manage orders & user’s feedback.

ResourceDescriptionExample
/orders/search?seller={Seller_id}&access_token=$ACCESS_TOKENSearch the orders from a seller GET

/orders/search?seller={Seller_id}&q={Order_id}&access_token=$ACCESS_TOKENSearch one order from a seller GET

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

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

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

/orders/{Order_id}/feedback?access_token=$ACCESS_TOKENGet the feedback received from a buyer or seller in an order GET POST

/feedback/{Feedback_id}&access_token=$ACCESS_TOKENChange feedback PUT

/feedback/{Feedback_Id}/replyRetrieves data from a feedback given by seller. POST

/users/{Seller_id}/order_blacklistRetrieves all blocked users for bid, on a seller’s items GET POST DELETE

Please rate this

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

pictures/{picture_id}Manage item pictures. GET DELETE

/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

Locations & Currencies

This examples will help you work with available locations and currencies of MercadoLibre.

ResourceDescriptionExample
/countriesReturns countries information. GET

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

/states/{State_id}Returns state information. GET

/cities/{City_id}Returns city information. GET

/currenciesReturns information about all available currencies in MercadoLibre. GET

/currencies/{Currency_id}Returns information about available currencies in MercadoLibre by currency_id. GET

/currency_conversions/search?from={Currency_id}&to={Currency_id}Retrieves the conversion 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

/country/{Country_id}/zip_codes/search_between?zip_code_from={zip_code_from}&zip_code_to={zip_code_to}Retrieve all zip codes for a country_id between two given zip codes. GET

Please rate this

Categories & Listings

This examples will help you work with the category tree and listing options of MercadoLibre.

ResourceDescriptionExample
/sitesRetrieves information about the sites where MercadoLibre runs. GET

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

/sites/{Site_id}/listing_typesReturns information about listing types. GET

/sites/{Site_id}/listing_exposuresReturns different exposure levels associated with all listing types in MercadoLibre. GET

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

/sites/{Site_id}/categoriesReturns available categories in the site. GET

/categories/{Category_id}Returns information about a category. GET

/categories/{Category_id}/attributesDisplays attributes and rules over them in order to describe the items that are stored in each category. GET

/sites/{Site_id}/category_predictor/predictCategory predictor. Retrieves the most accurate category to list your item basing on it’s title. GET

/categories/{Category_id}/classifieds_promotion_packsRetrieves classified promotion packs by category. GET

/sites/{site_id}/listing_types/{listing_type_id}Retrieves the configuration for a specific listing type. GET

Please rate this

Users & Apps

This examples will help you work with users and applications registered on MercadoLibre.

ResourceDescriptionExample
/users/{Cust_id}?access_token=$ACCESS_TOKENUser account information. GET PUT

/users/meReturns account information about the authenticated user. GET

/users/{Cust_id}/addresses?access_token=$ACCESS_TOKENReturns addresses registered by the user. GET

/users/{Cust_id}/accepted_payment_methodsReturns payment methods accepted by a seller to collect its operations. GET

/applications/{application_id}?ACCESS_TOKENReturns information about the application. GET

/users/{User_id}/brandsThis resource retrieves brands associated to an user_id. The official_store_id attribute identifies a store. GET

/users/{User_id}/classifieds_promotion_packs?access_token=$ACCESS_TOKENManage user promotion packs. GET POST

/users/{user_id}/classifieds_promotion_packs/{listing_type}&categoryId={category_id}
?acces_token=$ACCESS_TOKEN
Availability for the user to list under a given Listing Type and category according to packages engaged. GET

/projects?access_token=$ACCESS_TOKENManage projects. GET POST PUT DELETE

/projects/{Project_id}/applications?access_token=ACCESS_TOKEN_APP_OWNERManage applications & projects. POST DELETE

/users/{Cust_id}/available_listing_types?category_id={Category_id}&access_token=$ACCESS_TOKENListing types availability by user and category. GET

/users/{Cust_id}/available_listing_type/{listing_type_id}?category_id={Category_id}&access_token=$ACCESS_TOKENRetrieves availability to list under a listing type for a given category. GET

/users/{User_id}/applications/{App_id}?access_token=$ACCESS_TOKENApplication permissions. DELETE

/myfeeds?app_id={App_id}Notifications history. GET

Please rate this