So, at the moment of listing, you only have to see the site_id and logistic_type fields to determine the marketplace where the publication will be available.
Create marketplace items
Through the following resource, you may list production Global Selling items on the Marketplace where it is required. Remember that this way the listing will work in a production environment and the listing quota per site will be 10.000 per day.
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/marketplace/items/$ITEM_ID
- When you add the product price, the value is interpreted as a U.S. dollar amount, although the item will be listed with a differentiated price on each site.
- See more about the available listing type by site.
parent user $user_id does not have any child for site $site and logistic $logistic
parent item $item_id does not have any child for site $site and logistic $logistic
- If you get the “parent user $user_id does not have any child for site $site and logistic $logistic” error means that try to operate in a marketplace where you are not enabled. - If you get the “parent item $item_id does not have any child for site $site and logistic $logistic” error means that try to operate in a marketplace with a not created item.
When a user chooses an item from the result, this page displays the following item details:
Some of the fields are mandatory when you create an item, while some others can be skipped or will be automatically added to the item. They will define how the item is displayed, how buyers can purchase it and the position on search results among other variables.
The title is the key for buyers to find your product. Therefore, it should be as explicit as possible.
Generate the title with Product + Brand + product model + some specifications that help identify the product.
Avoid in the title information of other services, such as returns, free shipping or installment payments because your information will be seen by your buyers next to the product, without having to enter the publication.
If your product is new, used or refurbished, do not include it in the title, upload it in the features and we will show it in the detail of the publication.
If you sell the same product but with different colors, do not put the color in the title. Better create variants, so everything will be in a single publication.
If you only have stock of a certain color, load the color when publishing or in the characteristics section so that your buyers read the complete technical sheet, but you can add it in the title since it would be a publication that only sells a variant.
If you make a discount we will also indicate it showing the percentage of the promotion, we also have a special label to call attention. No need to add it in the title.
Separate words with spaces, do not use punctuation or symbols. Check have no spelling errors.
It is not allowed to mention stock if you do it your publication will be moderated. The limit of the publication title is set by the category to which it belongs ("max_title_length").
For example: HP Dual Core 425 LED 14 320 GB 4 GB Wifi HDMI Notebook
You can always make all the changes you need making a PUT on a items resource modifying the tittle field when sold_quantity be 19 inclusive.
Detailed information will improve your chances of selling a product and save you time by not having to answer questions. See more about Item descriptions and considerations to keep in mind.
When listing an item you need to declare the condition is new. This attribute is mandatory to complete a list operation.
This attribute defines the stock, that's the number of products available for selling on this item. The highest value is defined by the chosen listing type. See more details in the listing type section.
Nice pictures can make an item more appealing and give buyers a better idea of the item’s appearance. Basically, you should add an array of up to six URL pictures on the Json.
We highly recommend you don’t use slow servers to host your pictures since this can lead to disadvantages when listing. You can also add or change pictures to your item here later on. Please read more about this topic to know which kind of pictures are allowed and how to work with them here.
Sellers must define a category in Mercado Libre site. This attribute is mandatory and only accepts pre-established ids. For more information read categories guide. To get a category suggestion read this article.
This is a mandatory attribute, when you define a new item it must have a price. We suggest you search similar items on our marketplace to know the best price for your products and increase your competitivity. If you defined a price and then you’re not happy with it, you can change it later on, learn to modify items.
The price you must place is in dollars. This is also a mandatory attribute and you must define it using a pre-established id.
Not a mandatory attribute either and only available for some countries and user types. Know more about it.
This information will help your sellers to identify, locate and internally track a product. We only take into account the information loaded in the SELLER_SKU attribute. Learn more about variations considerations.
With Variations you can count in the same publication all the variants of the item, maintaining even differential stock for each one. In this way, when you receive a purchase, you will see in the purchase order the color and size chosen by the buyer, thus facilitating the after-sales process. Learn more about Variations.
An item condition
To define if a product is new, used or refurbished you will need to send the “item_condition” attribute with the value you intend to give. We recommend you to review the Attribute documentation to learn about category attributes and supported values.
While today it is allowed to send if an item is new or used in the “condition” field, it should be placed as attribute in the case of “reacondicionado”.
curl -H 'Authorization: Bearer $ACCESS_TOKEN' -X GET https://api.mercadolibre.com/categories/$CATEGORY_ID/attributes
curl -H 'Authorization: Bearer $ACCESS_TOKEN' -X GET https://api.mercadolibre.com/categories/CBT5849/attributes
When the listing has “reacondicionado” condition, you need to load the Product Warranty in "sale_terms".
Within an item “sale_terms” section, define the warranty of the listed product. For this, the information should have a combination of attributes:
Warranty Type: represents the forms that warranty can take. For example, seller or factory warranty, etc.
Warranty Time: represents the time that warranty will be in force.
curl -H 'Authorization: Bearer $ACCESS_TOKEN' -X GET https://api.mercadolibre.com/categories/$CATEGORY_ID/sale_terms
curl -H 'Authorization: Bearer $ACCESS_TOKEN' -X GET https://api.mercadolibre.com/categories/CBT5849/sale_terms