Shipping

This examples will guide you through shipping resources

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

/items/{Item_id}/shipping_options Retrieves all methods available to send the product. Valid for custom shipments only. 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_options?zip_code={Zip_code}&quantity={Quantity} 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

/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.

Resource Description Example
/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.

Resource Description Example
/questions/search?item={Item_id}&access_token=$ACCESS_TOKEN Search any question made to user’s items. GET

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

/answers Answer 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_TOKEN Manage questions blacklist. GET GET POST DELETE

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

Please rate this

Orders & Feedback

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

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

/orders/search?seller={Seller_id}&q={Order_id}&access_token=$ACCESS_TOKEN Search one order 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?access_token=$ACCESS_TOKEN Get the feedback received from a buyer or seller in an order GET POST

/feedback/{Feedback_id}&access_token=$ACCESS_TOKEN Change feedback PUT

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

/users/{Seller_id}/order_blacklist Retrieves 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.

Resource Description Example
/items Allows listing items. POST

/items/{Item_id} Allows managing listings GET PUT

/items/validate Validate the JSON before posting an item. POST

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

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

pictures/{picture_id} Manage item pictures. GET DELETE

/items/{Item_id}/description Manage description for an item. 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 url that match the search criteria. GET

/sites/MLA/search?category={Category_id}&official_store_id=all Search 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_TOKEN Search items by seller_id for a category. GET

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

/items/{Item_id}/variations Manage 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_TOKEN Search item by SKU.
Filter item by status.
GET

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

Please rate this

Locations & Currencies

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

Resource Description Example
/classified_locations/countries Returns countries information. GET

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

/classified_locations/states/{State_id} Returns state information. GET

/classified_locations/cities/{City_id} Returns city information. GET

/currencies Returns 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.

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

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

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

/sites/{Site_id}/listing_exposures Returns 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}/categories Returns available categories in the site. GET

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

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

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

/categories/{Category_id}/classifieds_promotion_packs Retrieves 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.

Resource Description Example
/users/{Cust_id}?access_token=$ACCESS_TOKEN User account information. GET PUT

/users/me Returns account information about the authenticated user. GET

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

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

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

/users/{User_id}/brands This 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_TOKEN Manage 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_TOKEN Manage projects. GET POST PUT DELETE

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

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

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

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

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

Please rate this