Documentação do Mercado Shops

Confira todas as informações necessárias sobre as APIs Mercado Shops.
circulos azuis em degrade
Última atualização em 20/08/2024

Publications

All sales generated through a Mercado Shops store and the products published with their respective attributes and variations are managed in the same way and through the Mercado Libre API (Guide for products).


To find out if the seller has a store created, do a search with the site and seller ID. If you have the mshops tag it means that you have your store created in Mercado Shops. If you do not have this tag, you can create a store in Mercado Shops.


Request:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/$SITE_ID/search?seller_id=$SELLER_ID

Example:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/MLB/search?seller_id=618515328

Response:

{
   "site_id":"MLB",
   "seller":{
      "id":618515328,
      "nickname":"TETE1835554",
      "permalink":"http://perfil.mercadolivre.com.br/TETE1835555",
      "registration_date":"2020-07-31T09:59:53.000-04:00",
      "seller_reputation":{
         "level_id":"5_green",
         "power_seller_status":null,
         "transactions":{
            "total":1,
            "canceled":0,
            "period":"historic",
            "ratings":{
               "negative":0,
               "positive":0,
               "neutral":1
            },
            "completed":1
         },
         "metrics":{
            "sales":{
               "period":"365 days",
               "completed":1
            }
         }
      },
      "real_estate_agency":false,
      "car_dealer":false,
      "tags":[
         "normal",
         "test_user",
         "mshops",
         "messages_as_seller",
         "messages_as_buyer"
      ],
      "eshop":null
   },
   "paging":{
      "total":0,
      "primary_results":1000,
      "offset":0,
      "limit":50
   },
   "results":[ ],
   "secondary_results":[ ],
   "related_results":[ ],
   "sort":{
      "id":"relevance",
      "name":"Mais relevantes"
   },
   "available_sorts":[
      {
         "id":"price_asc",
         "name":"Menor preço"
      },
      {
         "id":"price_desc",
         "name":"Maior preço"
      }
   ],
   "filters":[ ],
   "available_filters":[ ]
}

Publish in Mercado Libre and/or Mercado Shops

Important:
When listing or editing the channel, you must recognize if the category has the mandatory price attribute.

By using the channels field you can define in which channel you want to publish your item (Mercado Libre and/or Mercado Shops). This same action can be performed at any time you want to change the publication for a particular channel.


Example of an item listed only in Mercado Shops:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d
{
	[...]
	"channels": ["mshops"]
	[...]
}
https://api.mercadolibre.com/items

Example of an item listed only in Mercado Libre:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d
{
	[...]
	"channels": ["marketplace"]
	[...]
}
https://api.mercadolibre.com/items

For more details, check marketplace listings.


Example of an item listed in two channels:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d
{
	[...]
	"channels": ["marketplace",
		"mshops"
	]
	[...]
}
https://api.mercadolibre.com/items

Edit publishing channel

You can also modify the channel in which the publication is found by putting a PUT to the /items resource.


Editing example from marketplace to mshops listing:

curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' -H 
{
	[...]
	"channels": ["mshops"]
	[...]
}
https://api.mercadolibre.com/items

If you want to edit marketplace listings,can request /items resource.
To manage prices and subscribe to Price notifications, visit Product prices.


Delete price

By eliminating the price in Mercado Shops you can maintain a standard price, without differentiating the Mercado Libre and Mercado Shops listings.


Request:

curl -X DELETE -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/$ITEM_ID/prices/types/standard/channels/mshops

Obtain permalinks for a post differentiated by channel

Note:
If a product is published only within Mercado Shops, /items will bring the permalink for that channel. However, if it is also published on Marketplace, it will bring the Marketplace link by default. To get the permalink differentiated by channel, refer to the following documentation.

Currently, you have the /permalinks resource within the items API, which will allow you to obtain the corresponding links for the publications and distinguish them by each channel where they are published.


Parameters:

You can obtain the different permalinks of a specific item from the various sales channels where it is published by making a query with the following parameters.


Name Type Description Example
Item_id String Publication ID MCO944706832

Call:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/$ITEM_ID/permalinks?

Example:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/MCO944706832/permalinks?

Response (Marketplace only):

{
    "Permalinks": [
        {
            "channel": "marketplace",
            "permalink": "https://articulo.mercadolibre.com.co/MCO-944706832-tarjeta-wifi-tv-olimpo-l32d2700ms08gp-_JM"
        }
    ]
}

Response (Mshops only):

{
    "Permalinks": [
        {
            "channel": "mshops",
            "permalink": "https://internal-shop.mercadoshops.com.co/MCO-944706832-tarjeta-wifi-tv-olimpo-l32d2700ms08gp-_JM"
        }
    ]
}

Response (multiple channels):

{
    "Permalinks": [
        {
            "channel": "marketplace",
            "permalink": "https://articulo.mercadolibre.com.co/MCO-944706832-tarjeta-wifi-tv-olimpo-l32d2700ms08gp-_JM"
        },
        {
            "channel": "mshops",
            "permalink": "https://internal-shop.mercadoshops.com.co/MCO-944706832-tarjeta-wifi-tv-olimpo-l32d2700ms08gp-_JM"
        }
    ]
}

Response fields

The response from a GET to the /permalinks resource will provide the following parameters:

  • results:
    • Channel: Indicates the specific distribution channel where the item is available.
    • permalink: This is the permanent link associated with the specific channel. This URL directly leads to the item page within the indicated channel.

Nonexistent or malformed publication code


{
    "message": "Item with id MLM123 not found",
    "error": "not_found",
    "status": 404,
    "cause": [],
}

Publication does not belong to the seller


{
    "message": "The caller is not authorized to access this resource",
    "error": "forbidden",
    "status": 403,
    "cause": [],
}

Error using the access token to obtain permalink information


{
    "message": "Invalid Token",
    "error": "not_found",
    "status": 401,
    "cause": [],
}

Get multiple Mshops post permalinks

You currently have the /permalinks resource available to obtain the links corresponding to the Mercado Shops store posts, allowing you to easily access the item information published on the MShops channel. Through this resource, you can obtain multiple product links in Mshops stores with a single call.


Parameters:

You can obtain the permalinks of specific items corresponding to a seller by making a query with the following parameters.



Name Type Description Example
Item_id String Publication ID MLA594239600

Call:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/seller-promotions/users/$SELLER_ID/permalinks?ids=$ITEM_ID_1,$ITEM_ID_2,$ITEM_ID_3,$ITEM_ID_4,$ITEM_ID_5&channel=mshops

Example:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/seller-promotions/users/123/permalinks?ids=MLA1,MLA2,MLA3,MLA4,MLA5&channel=mshops

Response:

{
    "results": [
        {
            "item_id": "MLA1",
            "code": 200,
            "permalink": "https://internal-shop.mercadoshops.com.ar/MLA_1_PATH"
        },
        {
            "item_id": "MLA2",
            "code": 400,
            "cause": "Item has not a valid format"
        },
        {
            "item_id": "MLA3",
            "code": 403,
            "cause": "Item does not belong to seller"
        },
        {
            "item_id": "MLA4",
            "code": 404,
            "cause": "Error retrieving item"
        },
        {
            "item_id": "MLA5",
            "code": 500,
            "cause": "Error retrieving item"
        }
    ]
}

Response fields

The response to a GET request to the /permalinks resource will provide the following parameters:

  • results:
    • item_id: Unique identifier of the item or publication within Mercado Libre and/or the store under Mercado Shops.
    • code: Response code indicating the status of the request made to the API. Response codes are numeric values that follow the HTTP standard.
    • permalink: Unique permanent link (URL) of the publication, used to directly access the item's page on the platform.

Invalid or malformed publication code


{
    "item_id": "ITEM_ID",
    "code": 400,
    "cause": "Item has not a valid format"
}

Publication does not belong to the seller


{
    "item_id": "ITEM_ID",
    "code": 403,
    "cause": "Item does not belong to seller"
}

Error retrieving the publication permalink


{
    "item_id": "ITEM_ID",
    "code": 404,
    "cause": "Error retrieving item"
}

Error retrieving the publication permalink


{
    "item_id": "ITEM_ID",
    "code": 500,
    "cause": "Error retrieving item"
}

Error using the access token to retrieve permalink information

Request code: 401


{
    "code": "unauthorized",
    "message": "invalid access token"
}


Next: Free shipping.