Visits

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
        }
      ]
    }
  ]
}