Documentación Mercado Libre
Descubre toda la información que debes conocer sobre las APIs de Mercado Libre.
Documentación
Publish items
Get listing limit
Get the limit quantity of listings available per each marketplace user for a particular global user.
Request:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN'
https://api.mercadolibre.com/marketplace/users/capResponse:
[
{
"user_id": 823718333,
"site_id": "MLM",
"logistic_type": "remote",
"quota": 15000,
"total_items": 6
}
]Response fields
quota: limit quantity of active items that the seller can have for each marketplace.
site_id: identification for each marketplace site or country.
total_items: active listings quantity that the seller has for this site.
Publish item
Before publish item, you have to know that all listings must be created in english and priced in US dollars (USD). Some fields are mandatory when creating a listing, while others can be optional or manually added later. To maximize your chances of making a sale, ensure that this information is as accurate and clear as possible. The listing quota per site is 10.000 request per day.
Mandatory attributes
sites_to_sell: configuration for each marketplace where you want to list the item. Check listings types by site and exposures.
- site_id: specifies the country where the product will be listed.
- logistic_type: defines the shipping logistics, such as remote or fulfillment.
- price: allows you to set a different price for each marketplace. If no price is specified, the global item price will be applied by default. Prices must be provided in US Dollars. If you not specified price for each marketplace, the price of all the marketplace items will be the same as the global item. See more about pricing suggestion tool and how manage prices automations.
- listing_type_id: lets you choose the listing type between Classic “gold_special” and Premium “gold_pro” for each marketplace, depending on what is permitted by the country and the category. Default value: Premium.
title: it should be as clear and specific as possible. Mentioning stock quantities in the title is not allowed, doing so may result in your listing being moderated. Follow these recommendations:
- structure: create the title using the format Product + Brand + Product Key Specifications that help identify the product.
- formatting: separate words with spaces, and avoid using punctuation or symbols. Be sure to check for any spelling errors.
- length: the maximum length of the title is determined by the category of the product ("max_title_length").
- avoid extra information: do not include details about other services like returns, free shipping, or installment payments in the title.
catalog_listing: Available values: true or false. Only for logistic fulfillment, identify an eligible publication for catalogue.
description: providing detailed information in your product descriptions will significantly increase your chances of making a sale and help you avoid answering repetitive questions.
currency_id: always in US dollars. Available value: USD.
condition: when listing an item you need to declare if the condition is new.
available_quantity: this attribute defines the stock, that's the number of products available for selling on this item. The maximum value is defined by the chosen listing type.
attributes: some attributes are defined by the product category, we recommend you to review the attributes documentation to learn about category attributes and supported values. Check attributes with the tag new_required as Product identifiers and another like the package's attributes: length, width, height, weight are mandatory.
variations: if your listing has variations, the available quantity must be specified in each variation. Learn more about Variations.
pictures: nice pictures can make an item more appealing and give buyers a better idea of the item’s appearance. We provide two options. We recommend to follow the instructions on the pictures documentation. See more how validate and upload pictures.
category_id: sellers must define a category in Mercado Libre site. This attribute is mandatory and only accepts pre-established ids. Read to get a category suggestion.
seller_sku: 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.
sale_terms: define the warranty of the listed product:
- 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.
Example:
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' http://api.mercadolibre.com/global/items -d
{
"sites_to_sell": [
{
"site_id": "MLB",
"logistic_type": "remote",
"price": 20
},
{
"site_id": "MCO",
"logistic_type": "remote"
},
{
"site_id": "MLC",
"logistic_type": "remote",
"listing_type_id": "gold_pro"
},
{
"site_id": "MLC",
"logistic_type": "fulfillment"
}
],
"currency_id": "USD",
"catalog_listing": false,
"category_id": "CBT11625",
"sale_terms": [
{
"value_name": "No warranty",
"id": "WARRANTY_TYPE",
"name": "Warranty type",
"value_id": "6150835"
}
],
"available_quantity": 30,
"attributes": [
{
"name": "Brand",
"value_name": "Chip Theory Games",
"id": "BRAND",
"value_id": "43439984"
},
{
"id": "GTIN",
"value_id": null,
"value_name": "00704725644012",
"name": "Universal product code"
},
{
"id": "ITEM_CONDITION",
"value_id": "2230284",
"value_name": "New",
"name": "Item condition"
},
{
"id": "MIN_RECOMMENDED_AGE",
"value_name": "4 years",
"name": "Min recommended age",
"value_id": null
},
{
"id": "MODEL",
"value_name": "Chip Theory Games",
"name": "Model",
"value_id": null
},
{
"name": "Package height",
"value_name": "6 cm",
"id": "PACKAGE_HEIGHT",
"value_id": null
},
{
"id": "PACKAGE_LENGTH",
"name": "Package length",
"value_id": null,
"value_name": "16 cm"
},
{
"value_id": null,
"value_name": "0.908 kg",
"id": "PACKAGE_WEIGHT",
"name": "Package weight"
},
{
"name": "Package width",
"value_id": null,
"value_name": "12 cm",
"id": "PACKAGE_WIDTH"
},
{
"value_id": null,
"value_name": "BUYBOX-CPB0CMJW21C2",
"name": "SKU",
"id": "SELLER_SKU"
}
],
"condition": "new",
"title": "Game Test Play Toy",
"listing_type_id": "gold_pro",
"variations": [],
"catalog_product_id": null,
"pictures": [
{
"id": "655219-CBT82943741035_032025"
},
{
"id": "750827-CBT82943741037_032025"
},
{
"id": "669079-CBT82943741031_032025"
},
{
"id": "694220-CBT82943741033_032025"
}
],
"price": 83
}Response:
{
"item_id": "CBT000001",
"seller_id": 12345,
"site_id": "CBT",
"site_items": [
{
"item_id": "MLB949494",
"seller_id": 93993,
"site_id": "MLB",
"logistic_type": "remote"
},
{
"item_id": "MLC000001",
"seller_id": 83847,
"site_id": "MLC",
"logistic_type": "remote"
},
{
"item_id": "MLC000002",
"seller_id": 83847,
"site_id": "MLC",
"logistic_type": "fulfillment"
},
{
"item_id": "MCO00101010",
"seller_id": 92920,
"site_id": "MCO",
"logistic_type": "remote"
}
]
}Publish item with variations
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H 'parent-item-info: true' -H 'Content-Type: application/json' https://api.mercadolibre.com/global/items
-d
{
"sites_to_sell": [
{
"site_id": "MLC",
"logistic_type": "remote"
}
],
"title": "Test Items Stainless Steel Water Jug with variations",
"category_id": "CBT74531",
"price": 25.95,
"description": {
"plain_text": "Introducing the Test Items Stainless Steel Water Jug, designed to meet the demands of modern hydration while offering a sleek, contemporary aesthetic. Engineered with high-quality stainless steel, this water jug is not only durable but also resistant to rust and corrosion, ensuring long-lasting use for any occasion.\n The NEW FLOW feature ensures a smooth and effortless pouring experience, preventing spills and providing easy access to refreshing water. Its ergonomic handle is designed for comfortable grip, making it ideal for both indoor and outdoor use, from family gatherings to picnics in the park.\nThe stylish, polished finish of the stainless steel exterior complements any kitchen or dining setting, while the inner lining keeps beverages cool for extended periods. With a generous capacity, the Test Items Water Jug is perfect for serving large groups, making it an essential addition to your home, office, or dining establishment.\n"
},
"pictures": [
{
"id": "701198-CBT79185512197_092024"
},
{
"id": "802215-CBT79185512155_092024"
},
{
"id": "703102-CBT79185512191_092024"
},
{
"id": "868333-CBT79185512175_092024"
},
{
"id": "798904-CBT79185512203_092024"
},
{
"id": "978585-CBT79185512171_092024"
},
{
"id": "952093-CBT79185512195_092024"
},
{
"id": "706052-CBT79185512181_092024"
},
{
"id": "994127-CBT79185512159_092024"
},
{
"id": "684314-CBT79185512193_092024"
},
{
"id": "871149-CBT79185512173_092024"
},
{
"id": "896111-CBT79185512177_092024"
},
{
"id": "826514-CBT79185512157_092024"
},
{
"id": "834923-CBT79185512185_092024"
},
{
"id": "822761-CBT79185512163_092024"
},
{
"id": "701460-CBT79185512205_092024"
},
{
"id": "877786-CBT79185512213_092024"
},
{
"id": "677333-CBT79185512169_092024"
},
{
"id": "858260-CBT79185512165_092024"
}
],
"attributes": [
{
"id": "BRAND",
"name": "Brand",
"value_id": "35486409",
"value_name": "Other"
},
{
"id": "HEIGHT",
"value_name": "25 cm",
"name": "Height",
"value_id": null
},
{
"value_id": "242085",
"value_name": "Yes",
"id": "INCLUDES_LID",
"name": "Includes lid"
},
{
"id": "IS_KIT",
"value_name": "No",
"name": "Is kit",
"value_id": "242084"
},
{
"value_id": "2230284",
"id": "ITEM_CONDITION",
"name": "Item condition",
"value_name": "New"
},
{
"id": "JUG_CAPACITY",
"value_id": null,
"value_name": "1 L",
"name": "Jug capacity"
},
{
"name": "Jug material",
"value_id": "30380925",
"id": "JUG_MATERIAL",
"value_name": "Acero inoxidable"
},
{
"name": "Jug type",
"value_id": "22680526",
"value_name": "Water",
"id": "JUG_TYPE"
},
{
"name": "Lid material",
"value_name": "Stainless steel",
"id": "LID_MATERIAL",
"value_id": "2765623"
},
{
"id": "MODEL",
"value_id": null,
"value_name": "cántara",
"name": "Model"
},
{
"name": "With handle",
"value_id": "242084",
"value_name": "No",
"id": "WITH_HANDLE"
},
{
"id": "WITH_POURING_SPOUT",
"name": "With pouring spout",
"value_id": "242084",
"value_name": "No"
}
],
"variations": [
{
"attribute_combinations": [
{
"id": "COLOR",
"name": "Color",
"value_id": "283165",
"value_name": "Gray"
}
],
"available_quantity": 36,
"price": 25.95,
"picture_ids": [
"701198-CBT79185512197_092024",
"802215-CBT79185512155_092024",
"703102-CBT79185512191_092024",
"868333-CBT79185512175_092024",
"798904-CBT79185512203_092024",
"978585-CBT79185512171_092024",
"952093-CBT79185512195_092024"
],
"attributes": [
{
"id": "PACKAGE_HEIGHT",
"name": "Package height",
"value_id": null,
"value_name": "12.29 cm"
},
{
"name": "Package length",
"value_id": null,
"value_name": "28.9 cm",
"id": "PACKAGE_LENGTH"
},
{
"value_name": "381.01 g",
"id": "PACKAGE_WEIGHT",
"name": "Package weight",
"value_id": null
},
{
"id": "PACKAGE_WIDTH",
"name": "Package width",
"value_id": null,
"value_name": "18.48 cm"
},
{
"id": "SELLER_SKU",
"name": "SKU",
"value_id": null,
"value_name": "70079449"
},
{
"id": "GTIN",
"name": "Universal product code",
"value_id": null,
"value_name": "764486313435"
}
]
},
{
"attribute_combinations": [
{
"value_name": "Pink",
"id": "COLOR",
"name": "Color",
"value_id": "51994"
}
],
"available_quantity": 13,
"picture_ids": [
"706052-CBT79185512181_092024",
"994127-CBT79185512159_092024",
"684314-CBT79185512193_092024",
"871149-CBT79185512173_092024",
"896111-CBT79185512177_092024",
"826514-CBT79185512157_092024"
],
"attributes": [
{
"id": "PACKAGE_HEIGHT",
"name": "Package height",
"value_id": null,
"value_name": "11.01 cm"
},
{
"id": "PACKAGE_LENGTH",
"name": "Package length",
"value_id": null,
"value_name": "29.01 cm"
},
{
"id": "PACKAGE_WEIGHT",
"name": "Package weight",
"value_id": null,
"value_name": "377.01 g"
},
{
"id": "PACKAGE_WIDTH",
"name": "Package width",
"value_id": null,
"value_name": "17.01 cm"
},
{
"id": "SELLER_SKU",
"name": "SKU",
"value_id": null,
"value_name": "70079450"
},
{
"id": "GTIN",
"name": "Universal product code",
"value_id": null,
"value_name": "764486313466"
}
],
"price": 25.95
}
],
"condition": "new",
"listing_type_id": "gold_pro",
"sale_terms": [
{
"id": "WARRANTY_TYPE",
"name": "Warranty type",
"value_id": "6150835",
"value_name": "No warranty"
}
]
}Response:
{
"item_id": "CBT120000",
"seller_id": 90000,
"site_id": "CBT",
"site_items": [
{
"item_id": "MLC1523459",
"seller_id": 999999,
"site_id": "MLC",
"logistic_type": "remote"
}
]
}Validations
Our goal is to improve the quality of our sellers' listings. For this reason you have a flow that validates consistencies.
Activate in another marketplace
If you have an existing listing in one (or more) of our marketplaces, you can publish the same product in other marketplaces that you did not consider before, using the information of the existing listing. For example, if you have a listing in Brazil (MLB) and you want to sell the same product in Mexico (MLM), you can make the following request with the existing global listing, specifying the new marketplaces where you want to sell.
Remember that you can set a different price in each marketplace, you can specify this information with the field "price" under the "sites_to_sell " field. If no price is sent, the product will use the price set on the global listing.
Also, you can create the listing with a different listing type (available for MLB, MLC and MCO), specify this information under "sites_to_sell" with the field "listing_type_id".
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H 'parent-item-info: true' -H 'Content-Type: application/json' https://api.mercadolibre.com/global/items/CBT1234567890
-d
{
"sites_to_sell": [
{
"site_id": "MLC",
"logistic_type": "remote",
"listing_type_id": "gold_pro",
"price": 200
}
]
}Response:
{
"site_id": "CBT",
"site_items": [
{
"item_id": "MLC123456",
"seller_id": 959595,
"site_id": "MLC",
"logistic_type": "remote"
}
]
}