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 06/11/2024

Visits

Importante:
A partir de 14/11/2024, os anúncios criados antes de 2 de agosto de 2021 apresentarão apenas as visitas registradas nos últimos dois anos, de acordo com as diretrizes estabelecidas nessa documentação.

Com este recurso você pode obter informações sobre as visitas às publicações do Mercado Livre. Você pode consultar dados por janelas de tempo e sites. Lembre-se de que, ao publicar novamente, o histórico de visitantes é herdado do parent_item, não importando quantas vezes o anúncio seja publicado novamente.


Descrição de parâmetros

Tipo Parámetro Descripción
Integer user_id ID do usuário.
String item_id ID do anúncio.
Date date_from Data, em formato ISO, que define o início da consulta. O maximo é 150 dias.
Date date_to Data, em formato ISO, que define o final da consulta. O maximo é 150 dias.
Date ending Opcional. Data, em formato ISO, que estabelece o tempo de finalização da amostra; por padrão devem ser colocadas data e hora atuais.
String unit Unidade de consulta, valores possíveis: ["day"].
Integer last Opcional. Denota quantos dias antes a amostra abrangerá.
Integer total_visits Total de visitantes de um anúncio.
Array visits_detail Detalhamento dos visitantes por país e site.
Array results Detalhamento dos visitantes por intervalos de tempo. A unidade do parâmetro define a duração.


Total de visitas por usuário

Recuperação do total das visitas realizadas por um usuário para cada anúncio, por site e entre faixas de datas.
Chamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/$USER_ID/items_visits?date_from=$DATE_FROM&date_to=$DATE_TO

Exemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/1000011398/items_visits?date_from=2021-01-01&date_to=2021-02-01

Resposta:

{
  "user_id": 1000011398,
  "date_from": "2021-01-01T00:00:00Z",
  "date_to": "2021-02-01T00:00:00Z",
  "total_visits": 323690,
  "visits_detail": [
    {
      "company": "mercadolibre",
      "quantity": 323690
    }
  ]
}


Visitas totais por anúncio

Recupere as visitas totais a um anúncio dos últimos dois anos.
Chamada:

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

Exemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/visits/items?ids=MLB9992242141

Resposta:

{
  "MLB9992242141": 552
}


Visitas por anúncios entre intervalos de datas

Recuperação do total das visitas segundo um conjunto de anúncios ligados em uma faixa de datas, por site.
Chamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/visits?ids=$ITEM_ID&date_from=$DATE_FROM&date_to=$DATE_TO

Exemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://api.mercadolibre.com/items/visits?ids=MCO473861358&date_from=2021-01-01&date_to=2021-02-01

Resposta:


  {
    "item_id": "MCO473861358",
    "date_from": "2021-01-01T00:00:00Z",
    "date_to": "2021-02-01T00:00:00Z",
    "total_visits": 536,
    "visits_detail": [
      {
        "company": "mercadolibre",
        "quantity": 536
      }
    ]
  }


Visitantes por data por usuário

Recuperação dos visitantes de cada anúncio de um usuário em uma determinada janela de tempo, por site. Detalhamento das informações por intervalos de tempo.
Chamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/$USER_ID/items_visits/time_window?last=$LAST&unit=$UNIT&ending=$ENDING

Exemplo:

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

Resposta:

{
  "user_id": 1000011398,
  "date_from": "2021-01-08T00:00:00Z",
  "date_to": "2021-01-10T00:00:00Z",
  "total_visits": 2923,
  "last": 2,
  "unit": "day",
  "results": [
    {
      "date": "2021-01-08T00:00:00Z",
      "total": 2205,
      "visits_detail": [
        {
          "company": "mercadolibre",
          "quantity": 2205
        }
      ]
    },
    {
      "date": "2021-01-09T00:00:00Z",
      "total": 718,
      "visits_detail": [
        {
          "company": "mercadolibre",
          "quantity": 718
        }
      ]
    }
  ]
}


Visitantes por data por anúncio

Recuperação dos visitantes de cada anúncio em uma determinada janela de tempo, por site. Detalhamento das informações por intervalos de tempo.
Chamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/$ITEM_ID/visits/time_window?last=$LAST&unit=$UNIT&ending=$ENDING

Exemplo:

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

Resposta:

{
  "item_id": "MCO471870973",
  "date_from": "2021-08-04T00:00:00Z",
  "date_to": "2021-08-06T00:00:00Z",
  "total_visits": 26,
  "last": 2,
  "unit": "day",
  "results": [
    {
      "date": "2021-08-04T00:00:00Z",
      "total": 16,
      "visits_detail": [
        {
          "company": "mercadolibre",
          "quantity": 16
        }
      ]
    },
    {
      "date": "2021-08-05T00:00:00Z",
      "total": 10,
      "visits_detail": [
        {
          "company": "mercadolibre",
          "quantity": 10
        }
      ]
    }
  ]
}