Core

Custom Variations

Contents What are custom variations? When users do not find the attributes they need for a certain variation, they will be able to create a “custom variation” that better fits or describe their products. For example, a cell-phones covers seller need to add the “design” attribute for a variation. Doing so, he will be able […]

Continue Reading

New improvement: Bulk sale to “ceramicas” and “porcelanatos” categories! – Only for Mercadolibre Argentina

Introduction We are working to improve the publications in “ceramicas” and “porcelanatos” categories (only MLA for now). To accomplish that now we allow Bulk sale in those categories. ¿What we change? Those attributes will be NOT REQUIRED! You can publish normally without them but we recommend you to use those attributes to improve the functionality […]

Continue Reading

Variations

Contents What is a variation? A variation is a resource that allow sellers to set images and stock for each variant that a given same product may have. For example, in Fashion there may be pictures of each color or size within the same item publication. In Carparts, the same happens with right side, or […]

Continue Reading

New variations

What is a variation? It is the possibility of choosing different attribute variations from the same product. So far, this could only be done with apparel categories, where the buyer could choose size and color of the product. Starting now, it will be possible to choose: colors in other categories, voltage in home appliances or […]

Continue Reading

Brands API Tutorial for Official Stores

This API allows you to work with brands that are part of MercadoLibre Official Stores. How do I know my brand Ids? This resource retrieves brands associated to an user_id. The official_store_id attribute identifies a store. Example: https://api.mercadolibre.com/users/${user_id}/brands Response: { “cust_id”: 12345678, “tags”: [ “large_seller”, “user_info_verified”, “brand” ], “brands”: [ { “tags”: [ “girls”, “female” […]

Continue Reading

Listing types and item upgrades tutorial

You can list items under a few different listing types, according to the level of exposition to users you want to get. Each listing type has it’s own characteristics and feeds. Listings types by site First of all, to see all available listing types on a site, you should make a GET to listing_types resources […]

Continue Reading

Visits API tutorial

This API retrieves information about visits on MercadoLibre items VIPs (View Product Page). You can query data by time windows and sites. Remember that relistings inherit the item historic visits of it’s parent_item, no matter how many times they are relisted. Parameter description Total visits by user Retrieves the total visits on every item of […]

Continue Reading

Addresses API

The Addresses API resource retrieves the addresses associated to an user. To make a call to this API you’ll need an access token. curl -X GET “Content-Type: application/json” -d https://api.mercadolibre.com/users/{User_id}/addresses?access_token=$ACCESS_TOKEN RESPONSE { “id”: 145834937, “user_id”: “160252486”, “contact”: null, “phone”: null, “address_line”: “Guatemala 5100”, “floor”: null, “apartment”: null, “street_number”: “5100”, “street_name”: “Guatemala”, “zip_code”: “1000”, “city”: -{ “id”: […]

Continue Reading

New Feedback API Tutorial

Overview According to MercadoLibre’s business rules, after the sale (or purchase) is complete, the buyer and the seller must provide feedback about the transaction and rate each other. Buyers and sellers build their reputations based on their trading partners’ ratings. Table of Contents Resource description  Attribute  Description  fulfilled True or False. Indicates whether the order […]

Continue Reading

Listing prices calculator

The Listing Prices API is a read-only resource that offers many ways to know the fees of listing an item in MercadoLibre, so a seller can know exactly how much it’s going to cost to list under a certain listing_type for a given site, category, currency and quantity. Attribute description Attribute Description listing_type_id Listing type […]

Continue Reading

API Improvements: Payment information in Orders

During the day, we’ll be including much more payment data in the order, to help you improve your times and performance by letting you obtain the information you need about the order by making a single GET to Orders API, instead of calling Payments API also. How to obtain order information Make a GET to […]

Continue Reading

Modify items with variations

You already know what variations are and how to list an item with variations. If you haven’t, please check this tutorial. Now we’re gonna go over how to modify some attributes of variations. Get the variation_id Make a get to items/{item_id} to know the variation_id of each variation of the item. EXAMPLE: curl -X GET […]

Continue Reading

Orders notes

A note is an annotation sellers can add to orders. Notes can be up to 300 characters each, and once you post a note, you can modify it or delete it. How to add a note to an order curl -X POST -H “Content-Type: application/json” -d ‘{ “note”: “test”, }’ https://api.mercadolibre.com/orders/{order_Id}/notes?access_token=$ACCESS_TOKEN See order notes curl […]

Continue Reading

Block bids

How do I block bids from an specific user? If a user is making bids on your items to annoy you, you can put them on a blacklist so they won’t be able to bid on your items anymore. Make a POST with the cust_id of the user you want to block on the JSON […]

Continue Reading

Validate item

You can check if your listing will look ok before publishing by sending a real POST to the Items API. The Items API provides a validation service to check your listing details before publishing. It’s very useful to practice and check attribute variations! Validation Example If you make a POST with a Json body like […]

Continue Reading

Shipping Overview

Listings in MercadoLibre can have 4 different shipping modes: IMPORTANT: MercadoEnvios mode 2 is available for sellers from Argentina, Brazil and Mexico who want to opt-in to participate in the program. MercadoEnvios 1 is only available for selected sellers from Argentina and Brazil who’ve reached an agreement with MercadoLibre. Custom mode In this mode, the […]

Continue Reading

Managing Orders

Table of Contents Introduction An Order is a request for a purchase of a certain Item or a group of Items, placed by a certain customer. It is defined mainly by its quantity and price parameters, but could also include some other information in order to complete the description of what the customer is buying, […]

Continue Reading

List with variations

You already know what items and attributes are. If you don’t, we recommend that you read the Listings Introduction tutorial. See if the category specifies “attribute_types”: “variations” making a GET to Categories API with the category_id. https://api.mercadolibre.com/categories/{Category_id} For example, this category allows variations MLB103661 Check this resource to see which attributes are allowed and which […]

Continue Reading

Orders scenarios

Using Orders API you can build your own Sales Management System. There are two general scenarios where you can use Orders API: Scenario 1: When we have several stores and we want to manage these stores using only one channel or app. In this page we will see how the user is notified when he […]

Continue Reading

List items

Overview The first step in selling is to list an item on MercadoLibre. Sellers can list an item through MercadoLibre’s site or through an application using Listing API. They both work exactly the same. There are a number of considerations regarding an item such as the title, category, price, currency or description. You already know […]

Continue Reading

Modify items

Table of Contents Update an Item You can modify an item field after it has been listed using our API. https://api.mercadolibre.com/items/ITEM_ID You can modify the values for: When the item has sales you won’t be allowed to change any of the following item attributes: If your items belong to a classified category, note that for […]

Continue Reading

Pausing an item

Sometimes you need to pause an item for different reasons. When you pause it, an item will not show up in the listings and nobody will be able to purchase it. How to pause an item Make a PUT request to the Items API with the corresponding item Id and the new status to “paused” […]

Continue Reading

Listing with shipping me1

Overview This guide explains how to deal with all the resources of our API to successfully list and manage items with shipping mode me1. It also explains how to post tracking numbers to provide the buyers with the tracking information. To start using me1, first of all you have get in touch with MercadoLibre because […]

Continue Reading

Listing with shipping me2

Verify the shipping mode Use the shipping_modes resource to verify if a seller can list an item with me2 shipping in a given category. The response indicates if me2 mode is available and the shipping methods that can be used. URL https://api.mercadolibre.com/users/:user_id/shipping_modes?category_id=MLB39373 Response [ { “mode”: “custom”, “shipping_attributes”: { “dimensions”: “optional”, “costs”: “required”, “free”: { […]

Continue Reading

Relist your items

All listings have an expiration date on MercadoLibre. This expiration date is usually up to two months from the activation date. Once an item has reached its expiration date, it will be automatically finalized and will no longer be visible to other users. When this occurs, you may choose to relist your item to make […]

Continue Reading

Working with pictures

Overview Pictures are optional when listing, but they make a big difference in terms of the quality and results of your listing (visits and contacts). This tutorial is going to show you how to add and upload pictures. Users can upload pictures up to 10 MB. Picture format can be .jpg, .jpeg, .png or .gif […]

Continue Reading

Category selection

Overview Categories are a hierarchical set of groups in which items of a similar nature are listed, called “Category Tree”. Categories help buyers find the kinds of items they want, as the buyer only needs to look in one category or a few categories to find items they are interested in. Sellers benefit from the […]

Continue Reading

Giving feedback to an order

Overview After completing a sale and a purchase, according to MercadoLibre’s rules, both parties must provide feedback about the transaction (an order). This feedback says whether the order has been fulfilled or not and both the seller and buyer rate each other. Seller’s and buyer’s scores on the MercadoLibre platform are calculated based on these […]

Continue Reading

Choose category for an item

Category levels There are different category levels. Final categories are called leaf. You can identify them because they don’t have any “children categories”. For example, MLB107608 is a leaf category. You can check the “path_from_root” to see which other categories are above. Always remember you can only list an item under one leaf category. How […]

Continue Reading

Capturing shipping and managing shipments

Capture shipping preferences from the order When a buyer chooses shipping preferences and gives his shipping address a shipment is created and associated to the order. A new order feed will be received when the shipment is created and later, if the tracking is informed, each time the package changes its status until it’s delivered. […]

Continue Reading
12