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

Métricas

Os seguintes exemplos servirão para conhecer nosso recurso de métricas.

Recurso Descrição Exemplo
/users/$USER_ID/items_visits?date_from=$DATE_FROM&date_to=$DATE_TO Obtém o número de visitas que um usuário teve. GET
Voltar X

Obtém visitas por usuário

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/206946886/items_visits?date_from=2016-01-01T00:00:00.000-00:00&date_to=2016-02-10T00:00:00.000-00:00
 

Resposta

{
  "user_id": 206946886,
  "date_from": "2016-01-01T00:00:00.000-00:00",
  "date_to": "2016-02-10T00:00:00.000-00:00",
  "total_visits": 0,
  "visits_detail": [
  ]
}
Ler mais.
/users/$USER_ID/items_visits/time_window?last=$LAST&UNIT=$UNIT&ENDING=$ENDING Devolve as visitas de um usuário em cada item publicado durante um período de tempo. O detalhe da informação é agrupado por intervalos de tempo. GET
Voltar X

Obtém visitas por usuário e tempo.

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/52366166/items_visits/time_window?last=2&unit=day
 

Resposta

{
    "user_id": 52366166,
    "date_from": "2021-06-16T00:00:00Z",
    "date_to": "2021-06-18T00:00:00Z",
    "total_visits": 0,
    "last": 2,
    "unit": "day",
    "results": [
        {
            "date": "2021-06-16T00:00:00Z",
            "total": 0,
            "visits_detail": []
        },
        {
            "date": "2021-06-17T00:00:00Z",
            "total": 0,
            "visits_detail": []
        }
    ]
}
Leia mais.
/users/$USER_ID/contacts/questions?date_from=$DATE_FROM&date_to=$DATE_TO Devolve o total de perguntas de um usuário específico em todos os items publicados num intervalo de datas. GET
Voltar X

Obtém o total de perguntas por usuário.

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/MLV421672596/contacts/questions?date_from=2014-08-01T00:00:00.000-03:00&date_to=2014-08-02T23:59:59.999
 

Resposta

{
    "date_from": "2014-08-01T00:00:00.000-03:00",
    "date_to": "2014-08-02T23:59:59.999",
    "item_id": "MLV421672596",
    "total": 9
}
Leia mais.
/users/$USER_ID/contacts/questions/time_window?last=$LAST&UNIT=$UNIT O recurso permite obter as perguntas realizadas num determinado tempo nos items publicados por um seller. GET
Voltar X

Obtém as perguntas realizadas num período de tempo nos items publicados por um seller.

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/MLA510272257/contacts/questions/time_window?last=2&unit=hour
 

Resposta

{
    "total": 0,
    "last": "2",
    "unit": "hour",
    "date_from": "2021-06-18T18:00:00Z",
    "date_to": "2021-06-18T20:00:00Z",
    "item_id": "MLA510272257",
    "results": [
        {
            "date": "2021-06-18T18:00:00Z",
            "total": 0
        },
        {
            "date": "2021-06-18T19:00:00Z",
            "total": 0
        }
    ]
}
Ler mais.
/users/$USER_ID/contacts/questions/time_window?last=$LAST&UNIT=$UNIT Este recurso permite obter as perguntas feitas num determinado tempo no item publicado por um seller. GET
Voltar X

Obter os contatos recebidos pelo vendedor em seus items classificados dentro de um perídio de tempo.

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/MLA510272257/contacts/questions/time_window?last=2&unit=hour
 

Resposta

{
    "total": 0,
    "last": "2",
    "unit": "hour",
    "date_from": "2021-06-18T18:00:00Z",
    "date_to": "2021-06-18T20:00:00Z",
    "item_id": "MLA510272257",
    "results": [
        {
            "date": "2021-06-18T18:00:00Z",
            "total": 0
        },
        {
            "date": "2021-06-18T19:00:00Z",
            "total": 0
        }
    ]
}
Ler mais.
/users/$USER_ID/contacts/phone_views?date_from=$DATE_FROM&DATE_TO=$DATE_TO Pode obter a quantidade de vezes que fizeram clique em "Ver telefone" dentro de um item durante um período de tempo. GET
Voltar X

Obter "ver telefone" num rango de data.

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/52366166/contacts/phone_views?date_from=2014-05-28T00:00:00.000-03:00&date_to=2014-05-29T23:59:59.999
 

Resposta

{
    "date_from": "2014-05-28T00:00:00.000-03:00",
    "date_to": "2014-05-29T23:59:59.999",
    "total": 71,
    "user_id": "52366166"
}
Leia mais.
/users/$USER_ID/contacts/phone_views/time_window?last=$LAST&UNIT=$UNIT Devolve a quantidade de vezes que foi clicado na opção “ver telefone” para cada item de um usuário num intervalo de datas. GET
Voltar X

Obter "ver telefone".

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/contacts/phone_views/time_window?ids=MLA510272257,MLA489747739&last=2&unit=hour&ending=2014-05-28T00:00:00.000-03:00
 

Resposta

[
    {
        "total": 0,
        "last": "2",
        "unit": "hour",
        "date_from": "2021-06-18T18:00:00Z",
        "date_to": "2021-06-18T20:00:00Z",
        "item_id": "MLA510272257",
        "results": [
            {
                "date": "2021-06-18T18:00:00Z",
                "total": 0
            },
            {
                "date": "2021-06-18T19:00:00Z",
                "total": 0
            }
        ]
    },
    {
        "total": 0,
        "last": "2",
        "unit": "hour",
        "date_from": "2021-06-18T18:00:00Z",
        "date_to": "2021-06-18T20:00:00Z",
        "item_id": "MLA489747739",
        "results": [
            {
                "date": "2021-06-18T18:00:00Z",
                "total": 0
            },
            {
                "date": "2021-06-18T19:00:00Z",
                "total": 0
            }
        ]
    }
]
Leia mais.
/items/visits?ids=$ID1, ID2&date_from=$DATE_FROM&date_to=$DATE_TO Devolve as visitas do item (Multi-Get). GET
Voltar X

>Devolve as visitas do item (Multi-Get).

 curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/visits?ids=MLA506635149,MLA506634973,MLA503004418&date_from=2014-06-01T00:00:00.000-00:00&date_to=2014-06-10T00:00:00.000-00:00
 

Resposta

[
 {
    "item_id": "MLA506635149",
    "date_from": "2014-06-01T00:00:00.000-00:00",
    "date_to": "2014-06-10T00:00:00.000-00:00",
    "total_visits": 134,
    "visits_detail":  [
       {
        "company": "mercadolibre",
        "quantity": 134,
      },
    ],
  },
   {
    "item_id": "MLA506634973",
    "date_from": "2014-06-01T00:00:00.000-00:00",
    "date_to": "2014-06-10T00:00:00.000-00:00",
    "total_visits": 122,
    "visits_detail": [
       {
        "company": "mercadolibre",
        "quantity": 122,
      },
    ],
  },
   {
    "item_id": "MLA503004418",
    "date_from": "2014-06-01T00:00:00.000-00:00",
    "date_to": "2014-06-10T00:00:00.000-00:00",
    "total_visits": 355,
    "visits_detail": [
       {
        "company": "mercadolibre",
        "quantity": 355,
      },
    ],
  },
]
Ler mais.
/items/$ITEM_ID/visits/time_window?last=$LAST&UNIT=$UNIT&ENDING=$ENDING Devolve as visitas de um item num intervalo de tempo, filtrando por unidade e parâmetro de finalização. GET
Voltar X

Obtém as visitas dum item.

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/MLA506635149/visits/time_window?last=2&unit=day&ending=2014-06-11
 

Resposta

{
  "item_id": "MLA506635149",
  "total_visits": 15,
  "date_from": "2014-06-09T04:00:00Z",
  "date_to": "2014-06-11T04:00:00Z",
  "last": 2,
  "unit": "day",
  "results": [
     {
      "date": "2014-06-09T04:00:00Z",
      "total": 10,
      "visits_detail": - [
         {
          "company": "mercadolibre",
          "quantity": 10,
        },
      ],
    },
     {
      "date": "2014-06-10T04:00:00ZZ",
      "total": 5,
      "visits_detail": - [
         {
          "company": "mercadolibre",
          "quantity": 5,
        },
      ],
    },
  ],
}
Ler mais.
/items/visits/time_window?ids=$ID1, ID2last=$LAST&UNIT=UNIT&ENDING=$ENDING Devolve visitas de diversos itens num intervalo de tempo filtrando por unidade e parâmetro de finalização (Multi Get). GET
Voltar X

Obtém as visitas do item. (Multi Get)

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/visits/time_window?ids=MLA506635149,MLA506634973,MLA503004418&last=3&unit=day
 

Resposta

[
    {
        "item_id": "MLA506635149",
        "date_from": "2021-06-15T00:00:00Z",
        "date_to": "2021-06-18T00:00:00Z",
        "total_visits": 0,
        "last": 3,
        "unit": "day",
        "results": [
            {
                "date": "2021-06-15T00:00:00Z",
                "total": 0,
                "visits_detail": []
            },
            {
                "date": "2021-06-16T00:00:00Z",
                "total": 0,
                "visits_detail": []
            },
            {
                "date": "2021-06-17T00:00:00Z",
                "total": 0,
                "visits_detail": []
            }
        ]
    },
    {
        "item_id": "MLA506634973",
        "date_from": "2021-06-15T00:00:00Z",
        "date_to": "2021-06-18T00:00:00Z",
        "total_visits": 0,
        "last": 3,
        "unit": "day",
        "results": [
            {
                "date": "2021-06-15T00:00:00Z",
                "total": 0,
                "visits_detail": []
            },
            {
                "date": "2021-06-16T00:00:00Z",
                "total": 0,
                "visits_detail": []
            },
            {
                "date": "2021-06-17T00:00:00Z",
                "total": 0,
                "visits_detail": []
            }
        ]
    },
    {
        "item_id": "MLA503004418",
        "date_from": "2021-06-15T00:00:00Z",
        "date_to": "2021-06-18T00:00:00Z",
        "total_visits": 0,
        "last": 3,
        "unit": "day",
        "results": [
            {
                "date": "2021-06-15T00:00:00Z",
                "total": 0,
                "visits_detail": []
            },
            {
                "date": "2021-06-16T00:00:00Z",
                "total": 0,
                "visits_detail": []
            },
            {
                "date": "2021-06-17T00:00:00Z",
                "total": 0,
                "visits_detail": []
            }
        ]
    }
]
Ler mais.
/items/contacts/phone_views/time_window?ids=$ID1,ID2&last=$LAST&UNIT=$UNIT&ENDING=ENDING_DATE Devolve o número de usuários que clicaram em “ver telefone” em vários itens durante um intervalo de tempo (Multi Get). GET
Voltar X

Obter "ver telefone".

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/contacts/phone_views/time_window?ids=MLA510272257,MLA489747739&last=2&unit=hour&ending=2014-05-28T00:00:00.000-03:00
 

Resposta

[
    {
        "total": 0,
        "last": "2",
        "unit": "hour",
        "date_from": "2021-06-18T18:00:00Z",
        "date_to": "2021-06-18T20:00:00Z",
        "item_id": "MLA510272257",
        "results": [
            {
                "date": "2021-06-18T18:00:00Z",
                "total": 0
            },
            {
                "date": "2021-06-18T19:00:00Z",
                "total": 0
            }
        ]
    },
    {
        "total": 0,
        "last": "2",
        "unit": "hour",
        "date_from": "2021-06-18T18:00:00Z",
        "date_to": "2021-06-18T20:00:00Z",
        "item_id": "MLA489747739",
        "results": [
            {
                "date": "2021-06-18T18:00:00Z",
                "total": 0
            },
            {
                "date": "2021-06-18T19:00:00Z",
                "total": 0
            }
        ]
    }
]
Ler mais.

Seguinte: Envio .