Seller news

Get news

Optional parameters

limit: maximum limit of communications to be received
offset: If the total is greater than the limit, the offset is used for paging

Request:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/communications/notices?limit=$LIMIT&offset=$OFFSET

Example:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/communications/notices?limit=20&offset=0

Response:

{
   "paging": {
       "total": 1,
       "offset": 0,
       "limit": 20
   },
   "results": [
       {
           "actions": [
               {
                   "text": "More information",
                   "link": "https://global-selling.mercadolibre.com/devsite/seller-news-gs"
               },
               {
                   "text": "Give feedback",
                   "link": "https://www.mercadolivre.com.br/novidades"
               }
           ],
           "id": "3446",
           "label": "Welcome partners to the news center!",
           "description": "
We are making CDN information available to all integrators since June. Get ready to be more informed than ever of the latest MeLi news.
\n",
           "highlighted": true,
           "from_date": "2021-07-15T15:00:00.000Z",
           "tags": [
               {
                   "tag": "COVID",
                   "type": "EVENTS"
               },
               {
                   "tag": "SHIPPING_GENERIC",
                   "type": "SHIPPING"
               }
           ]
       }
   ]
}

Response fields

paging: results paging format.

• total: The total results found.
• offset: Index of the result from which you want to obtain. Ex: With 100 news in total, using a limit of 20. If you want I want to see a second page I have to send offset = 21 and it will show me from 21 to 40.
• limit: The maximum number of results I want to see on a single page.

results: list of news.

• actions(optional): list with actions.

• text: text of the action.   

• link: link of the action.

id: communication identification.
label: title of the communication.
description: communication description.
highlighted: indicates if the news is highlighted in Mercado Libre or not.
from_date: date in ISO format, indicates the creation of the novelty.
tags: with the following tag you identify the types news. You can also group them according to Attention, Shipping, Events, Billing, Sites and Publications.