Documentação do Mercado Livre

Confira todas as informações necessárias sobre as APIs Mercado Livre.
circulos azuis em degrade

Documentação do

Última atualização em 14/03/2023

Novidades de vendedores

Com o recurso /communications/notices você acessa todas as notícias atuais enviadas pelo Mercado Libre aos vendedores em Vendas > Novidades. Conheça mais os benefícios dessa funcionalidade para os vendedores.





Consultar novedades

Parâmetros opcionais

limit: limite máximo de comunicações a serem recebidas
offset: se o total for maior que o limite, o offset é usado para paginação

Chamada:

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

Exemplo:

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

Resposta:

{
   "paging": {
       "total": 2,
       "offset": 0,
       "limit": 10
   },
   "results": [
       {
           "actions": [
               {
                   "text": "Mas información",
                   "link": "https://developers.mercadolibre.com.ar/es_ar/conoce-las-novedades-que-reciben-los-vendedores"
               },
               {
                   "text": "Dar feedback",
                   "link": "https://www.mercadolibre.com.ar"
               }
           ],
           "id": "3691",
           "label": "Bienvenidos integradores a la central de novedades! prueba 2",
           "description": "

Estamos disponibilizando la información de la CDN a todos los integradores desde el mes de junio. Preparate para estar mas informado que nunca de las ultimas novedades de MeLi.

\n", "highlighted": true, "from_date": "2021-07-12T15:00:00.000Z", "tags": [ { "tag": "BLACK_FRIDAY", "type": "EVENTS" }, { "tag": "BILLING", "type": "BILLING" }, { "tag": "SHIPPING_GENERIC", "type": "SHIPPING" } ] }, { "actions": [ { "text": "Mas información", "link": "https://developers.mercadolibre.com.ar/es_ar/conoce-las-novedades-que-reciben-los-vendedores" }, { "text": "Dar feedback", "link": "https://www.mercadolibre.com.ar" } ], "id": "3446", "label": "Bienvenidos integradores a la central de novedades!", "description": "

Estamos disponibilizando la información de la CDN a todos los integradores desde el mes de junio. Preparate para estar mas informado que nunca de las ultimas novedades de MeLi.

\n", "highlighted": true, "from_date": "2021-07-12T15:00:00.000Z", "tags": [ { "tag": "COVID", "type": "EVENTS" }, { "tag": "SHIPPING_GENERIC", "type": "SHIPPING" } ] } ] }
Nota:
As novidades estão ordenadas por data de criação, em ordem decrescente e você só verá as vigentes no momento da consulta.

Campos da resposta

paging: formato de paginação dos resultados.

  • total: total de resultados encontrados.
  • offset: índice do resultado a partir do qual deseja obter. Por exemplo: com 100 novidades en total, utilizando um limit = 20. Se você quiser ver uma segunda página, deve enviar offset = 21 e se mostrará de 21 a 40.
  • limit: número máximo de resultados a serem exibidos em uma página

results: listagem das novidades.

  • actions(opcional): listagem com as ações.
  • text: texto da ação.   

  • link: link da ação.

id: identificação da comunicação.
label: título da comunicação.
description: descrição da comunicação.
highlighted: indica se a novidade está em destaque no Mercado Libre ou não.
from_date: data no formato ISO, indica a criação da novidade.
tags: com as siguientes tag identifica os tipos de novidades. Você também pode agrupá-los de acordo com Atenção, Envios, Eventos, Faturamento, Países e Publicações.

Atenção Envios Eventos Faturamento Países Publicações
Tag Referência
METRICS Métricas
CANCELLATIONS Cancelamentos
RETURNS Devoluções
CLAIMS Reclamações
REPUTATION Reputação
Tag Referência
SHIPPING_GENERIC Envios
SHIPPING Mercado Envios
SHIPPING_XD Mercado Envios coleta
FLEX Flex
FULL Full
SHIPPING_CARRIER Mercado Envios Partnered Carrier
Tag Referência
CHRISTMAS Natal
BLACK_FRIDAY Black Friday
HOT_SALE Hot Sale
CYBER_MONDAY Cyber Monday
COVID COVID-19
Tag Referência
COST Custos
BILLING Faturamento
TRANSMITTER Emisor de NF-e
Tag Referência
MCO Colômbia
MLC_FULFILLMENT Chile - Full
MLC_REMOTE Chile
MLB Brasil
MLM_REMOTE México
MLM_FULFILLMENT México - Full
Tag Referência
PUBLICATIONS Publicações
PROMOTIONS_CENTRAL Central de promoções
CATALOG Catálogo