Get available marketplace sites to publish

To list the items in the marketplaces, we need to know which assets we have for our user. So, make the following GET request with the user id:

curl -H 'Authorization: Bearer $ACCESS_TOKEN' -X GET http://api.mercadolibre.com/marketplace/users/$USER_ID

This resource presents the user and all the marketplaces that our user has configured:

curl -H 'Authorization: Bearer $ACCESS_TOKEN' -X GET http://api.mercadolibre.com/marketplace/users/471826944

Response:

{
    "user_id": 471826944,
    "site_id": "CBT",
    "marketplaces": [
        {
            "user_id": 471828584,
            "site_id": "MLM",
            "logistic_type": "remote"
        },
        {
            "user_id": 471830260,
            "site_id": "MLB",
            "logistic_type": "remote"
        },
        {
            "user_id": 538932857,
            "site_id": "MLC",
            "logistic_type": "remote"
        }
    ]
}

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.

Request:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/marketplace/items/$ITEM_ID

Example:

curl -X POST  -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/marketplace/items/CBT1234 -H 'Content-Type: application/json' -d 
{
  "config": [
    {
      "site_id": "MLM",
      "logistic_type": "remote"
    },
    {
      "site_id": "MLB",
      "logistic_type": "remote",
      "price":11.23,
      "listing_type_id": "gold_pro",
    }
  ]
}

Response:

[
    {
        "action": "POST",
        "item_id": "MLM111111",
        "parent_id": "CBT1234",
        "logistic_type": "remote",
        "site_id": "MLM",
        "errors": null
    },
    {
        "action": "POST",
        "item_id": "MLB111111",
        "parent_id": "CBT1234",
        "logistic_type": "remote",
        "site_id": "MLB",
        "errors": null
    }
]

Parameters

item_id: It is the Global Selling item identifier.

Errors creating marketplace items

Get the Marketplace item details

To obtain the details of Marketplace items that are listed, you may use the following resource:

Request:

curl -H 'Authorization: Bearer $ACCESS_TOKEN' -X GET http://api.mercadolibre.com/marketplace/items/MLM1487703748

Response:

{
    "id": "MLM1487703748",
    "site_id": "MLM",
    "date_created": "2022-08-25T15:47:03Z",
    "title": "Luces Pfbvr87",
    "descriptions": [],
    "attributes": [
        {
            "id": "GTIN",
            "name": "Código universal de producto",
            "value_id": "",
            "value_name": "xxx",
            "value_struct": null,
            "values": [
                {
                    "id": "",
                    "name": "xxx",
                    "struct": null
                }
            ]
        },
        {
            "id": "INCLUDES_BATTERIES",
            "name": "Incluye pilas",
            "value_id": "242085",
            "value_name": "Sí",
            "value_struct": null,
            "values": [
                {
                    "id": "242085",
                    "name": "Sí",
                    "struct": null
                }
            ]
        },
        {
            "id": "ITEM_CONDITION",
            "name": "Condición del ítem",
            "value_id": "2230284",
            "value_name": "Nuevo",
            "value_struct": null,
            "values": [
                {
                    "id": "2230284",
                    "name": "Nuevo",
                    "struct": null
                }
            ]
        },
        {
            "id": "LENGTH",
            "name": "Largo",
            "value_id": "",
            "value_name": "6.5 m",
            "value_struct": {
                "number": 6.5,
                "unit": "m"
            },
            "values": [
                {
                    "id": "",
                    "name": "6.5 m",
                    "struct": {
                        "number": 6.5,
                        "unit": "m"
                    }
                }
            ]
        },
        {
            "id": "MODEL",
            "name": "Modelo",
            "value_id": "",
            "value_name": "luces solares navideñas,luces halloween,guirnaldas decorativas,luces vintage,",
            "value_struct": null,
            "values": [
                {
                    "id": "",
                    "name": "luces solares navideñas,luces halloween,guirnaldas decorativas,luces vintage,",
                    "struct": null
                }
            ]
        },
        {
            "id": "POWER_SUPPLY",
            "name": "Alimentación",
            "value_id": "3955575",
            "value_name": "Enchufe",
            "value_struct": null,
            "values": [
                {
                    "id": "3955575",
                    "name": "Enchufe",
                    "struct": null
                }
            ]
        },
        {
            "id": "SELLER_SKU",
            "name": "SKU",
            "value_id": "",
            "value_name": "xxx",
            "value_struct": null,
            "values": [
                {
                    "id": "",
                    "name": "xxx",
                    "struct": null
                }
            ]
        },
    ],
    "listing_type_id": "gold_pro",
    "permalink": "https://articulo.mercadolibre.com.mx/MLM-1487703748-luces-pfbvr87-_JM",
    "shipping": {
        "mode": "me2",
        "free_shipping": true,
        "logistic_type": "drop_off",
        "dimensions": "",
        "tags": [
            "cbt_fulfillment"
        ]
    },
    "status": "xxx",
    "sub_status": [
        "xxx"
    ],
    "tags": [
        "cbt_item",
        "test_item",
        "immediate_payment",
        "cart_eligible"
    ],
    "warranty": "Sin garantía",
    "catalog_product_id": null,
    "domain_id": "MLM-CHRISTMAS_AND_DECORATIVE_STRINGS_LIGHTS",
    "international_delivery_mode": "none",
    "inventory_id": "",
    "category_id": "xxx",
    "official_store_id": null,
    "sold_quantity": 0,
    "available_quantity": 0,
    "last_updated": "2023-05-08T20:29:30Z",
    "seller_id": 123,
    "price": 10,
    "original_price": 0,
    "currency_id": "USD",
    "base_exchange_rate": 0,
    "user_logistic_type": "fulfillment",
    "owner_id": xxx,
    "cbt_item_id": "xxx",
    "variations": [],
    "item_relations": []
}

The response from this call has less data than the global item call, but you can see some data such as SKU of variations.

Parameters

id: It is the Global Selling item identifier, which is created through a call to the local API.

Delete marketplace items

In order to delete marketplace items, the item to delete must be in a paused or closed state and then make the same PUT:

Example:

curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/global/items/CBT946690995 -d 
{
   "site_id": "MLM",
   "logistic_type": "remote",
   "deleted": true
}

Response: Http 200

Guide to modify items

Errors modifying marketplace items

Errors

Items specifications

Item detail page

When a user chooses an item from the result, this page displays the following item details:

• Item_id
• Title
• Category
• Pictures
• Price
• City
• Sold quantity
• Questions
• Seller’s reputation
• Detailed description

Defining attributes

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.

Title

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

Description

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.

Condition

When listing an item you need to declare the condition is new. This attribute is mandatory to complete a list operation.

Available quantity

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.

Pictures

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.

{
 ....
 "pictures":[
  {"source":"http://yourServer/path/to/your/picture.jpg"},
  {"source":"http://yourServer/path/to/your/otherPicture.gif"},
  {"source":"http://yourServer/path/to/your/anotherPicture.png"}
 ]
 ...
}

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.

Category

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.

{
 ....
  "category_id":"CBT12683",
 ...
}

Price

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.

Currency

The price you must place is in dollars. This is also a mandatory attribute and you must define it using a pre-established id.

Product Identifiers

Not a mandatory attribute either and only available for some countries and user types. Know more about it.

SKU

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.

Variations

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.

Request:

curl -H 'Authorization: Bearer $ACCESS_TOKEN' -X GET  https://api.mercadolibre.com/categories/$CATEGORY_ID/attributes

Example:

curl -H 'Authorization: Bearer $ACCESS_TOKEN' -X GET https://api.mercadolibre.com/categories/CBT5849/attributes

Response:

[{
		"id": "BRAND",
		"name": "Brand",
		"tags": {
			"catalog_required": true
		},
		"hierarchy": "PARENT_PK",
		"relevance": 1,
		"value_type": "string",
		"value_max_length": 255,
		"attribute_group_id": "OTHERS",
		"attribute_group_name": "Others"
	},
	{
		"id": "GTIN14",
		"name": "GTIN-14",
		"tags": {
			"hidden": true,
			"multivalued": true,
			"variation_attribute": true,
			"used_hidden": true,
			"validate": true
		},
		"hierarchy": "PRODUCT_IDENTIFIER",
		"relevance": 2,
		"type": "product_identifier",
		"value_type": "string",
		"value_max_length": 255,
		"attribute_group_id": "OTHERS",
		"attribute_group_name": "Others"
	}
]

Product warranty

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.

Request:

curl -H 'Authorization: Bearer $ACCESS_TOKEN' -X GET  https://api.mercadolibre.com/categories/$CATEGORY_ID/sale_terms

Example:

curl -H 'Authorization: Bearer $ACCESS_TOKEN' -X GET https://api.mercadolibre.com/categories/CBT5849/sale_terms

Response:

[{
		"id": "WARRANTY_TYPE",
		"name": "Type of warranty",
		"tags": {},
		"hierarchy": "SALE_TERMS",
		"relevance": 2,
		"value_type": "list",
		"values": [{
				"id": "2230280",
				"name": "Seller warranty"
			},
			{
				"id": "2230279",
				"name": "Factory warranty"
			},
			{
				"id": "6150835",
				"name": "No warranty"
			}
		],
		"attribute_group_id": "OTHERS",
		"attribute_group_name": "Others"
	},
	{
		"id": "WARRANTY_TIME",
		"name": "Warranty time",
		"tags": {},
		"hierarchy": "SALE_TERMS",
		"relevance": 2,
		"value_type": "number_unit",
		"value_max_length": 255,
		"allowed_units": [{
				"id": "days",
				"name": "days"
			},
			{
				"id": "months",
				"name": "months"
			},
			{
				"id": "years",
				"name": "years"
			}
		],
		"default_unit": "months",
		"attribute_group_id": "OTHERS",
		"attribute_group_name": "Others"
	}
]

Next: Sync and modify listings.