Recurso Visits

Esta API recupera informações sobre visitantes nas VIPs (Página Visualização de Produtos) dos produtos 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.

Assuntos

Descrição de parâmetros

Tipo Parâmetro Descrição
Integer User_id ID do usuário.
String Item_id ID do produto.
Date Date_from Data, em formato ISO, que define o início da consulta.
Date Date_to Data, em formato ISO, que define o final da consulta.
Data 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 produto.
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 produto, por site e entre faixas de datas. Isso também é aplicado para visitas a outros sites do Mercado Livre, como TuCarro, TuInmueble, Autoplaza, etc.
Recurso:

https://api.mercadolibre.com/users/{User_id}/items_visits?date_from={Date_from}&date_to={Date_to}

Exemplo:

curl -X GET ‘https://api.mercadolibre.com/users/52366166/items_visits?date_from=2014-06-01T00:00:00.000-00:00&date_to=2014-06-10T00:00:00.000-00:00’

Resposta:

{
  "user_id": 52366166,
  "date_from": "2014-06-01T00:00:00.000-00:00",
  "date_to": "2014-06-10T00:00:00.000-00:00",
  "total_visits": 120,
  "visits_detail": [
     {
      "company": "mercadolibre",
      "quantity": 59,
    },
   {
      "company": "tuinmueble",
      "quantity": 61,
    },
  ],
}

Total de visitas por produto

Recuperação do total das visitas de um produto entre faixas de data e por site.

Recurso:

https://api.mercadolibre.com/items/{Items_id}/visits?date_from={Date_from}&date_to={Date_to}

Exemplo:

curl -X GET ‘https://api.mercadolibre.com/items/MCO496961166/visits?date_from=2014-04-14T00:00:00.000-03:00&date_to=2014-05-30T23:59:59.999-03:00’

Resposta:

{
  "item_id": "MCO496961166",
  "date_from": "2014-04-14T00:00:00.000-03:00",
  "date_to": "2014-05-30T23:59:59.999-03:00",
  "total_visits": 152,
  "visits_detail":  [
     {
      "company": "mercadolibre",
      "quantity": 70,
    },
 {
      "company": "tucarro",
      "quantity": 82,
    },
  ],
}

Total de visitas por produto MULTIGET

Recuperação do total das visitas segundo um conjunto de produtos ligados em uma faixa de datas, por site.
Recurso:

https://api.mercadolibre.com/items/visits?ids={Id1, Id2}date_from={Date_from}&date_to={Date_to}

Exemplo:

curl -X GET ‘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,
      },
    ],
  },
]

Visitantes por data por usuário

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

https://api.mercadolibre.com/users/{User_id}/items_visits/time_window?last={Last}&unit={Unit}&ending={Ending}

Exemplo:

curl -X GET ‘https://api.mercadolibre.com/users/52366166/items_visits/time_window?last=2&unit=day’

Resposta:

{
  "user_id": 52366166,
  "total_visits": 2083,
  "date_from": "2014-06-10T04:00:00Z",
  "date_to": "2014-06-12T04:00:00Z",
  "last": 2,
  "unit": "day",
  "results": [
     {
      "date": "2014-06-10T04:00:00Z",
      "total": 1637,
      "visits_detail": [
         {
          "company": "mercadolibre",
          "quantity": 1637,
        },
      ],
    },
     {
      "date": "2014-06-11T04:00:00Z",
      "total": 446,
      "visits_detail": [
        {
          "company": "mercadolibre",
          "quantity": 446,
        },
      ],
    },
  ],
}

Visitantes por data por produto

Recuperação dos visitantes de cada produto em uma determinada janela de tempo, por site. Detalhamento das informações por intervalos de tempo.

Recurso:

https://api.mercadolibre.com/users/{Item_id}/visits/time_window?last={Last}&unit={Unit}&ending={Ending}

Exemplo:

curl -X GET ‘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,
        },
      ],
    },
  ],
}

Visitantes por data por produto MULTIGET

Recuperação das visitas segundo um conjunto de produtos (máximo de 50), por site. Detalhamento das informações por intervalos de tempo.
Recurso:

https://api.mercadolibre.com/items/visits/time_window?ids={Id1, Id2}last={Last}&unit={Unit}&ending={Ending}

Exemplo:

curl -X GET ‘https://api.mercadolibre.com/items/visits/time_window?ids=MLA506635149,MLA506634973,MLA503004418&last=3&unit=day‘

Resposta:

[
 {
 "item_id": "MLA506635149",
 "total_visits": 0,
 "date_from": "2015-08-30T04:00:00Z",
 "date_to": "2015-09-02T04:00:00Z",
 "last": 3,
 "unit": "day",
 "results": [
 {
 "date": "2015-08-30T04:00:00Z",
 "total": 0,
 "visits_detail": []
 },
 {
 "date": "2015-08-31T04:00:00Z",
 "total": 0,
 "visits_detail": []
 },
 {
 "date": "2015-09-01T04:00:00Z",
 "total": 0,
 "visits_detail": []
 }
 ]
 },
 {
 "item_id": "MLA506634973",
 "total_visits": 0,
 "date_from": "2015-08-30T04:00:00Z",
 "date_to": "2015-09-02T04:00:00Z",
 "last": 3,
 "unit": "day",
 "results": [
 {
 "date": "2015-08-30T04:00:00Z",
 "total": 0,
 "visits_detail": []
 },
 {
 "date": "2015-08-31T04:00:00Z",
 "total": 0,
 "visits_detail": []
 },
 {
 "date": "2015-09-01T04:00:00Z",
 "total": 0,
 "visits_detail": []
 }
 ]
 },
 {
 "item_id": "MLA503004418",
 "total_visits": 169,
 "date_from": "2015-08-30T04:00:00Z",
 "date_to": "2015-09-02T04:00:00Z",
 "last": 3,
 "unit": "day",
 "results": [
 {
 "date": "2015-08-30T04:00:00Z",
 "total": 42,
 "visits_detail": [
 {
 "company": "mercadolibre",
 "quantity": 42
 }
 ]
 },
 {
 "date": "2015-08-31T04:00:00Z",
 "total": 38,
 "visits_detail": [
 {
 "company": "mercadolibre",
 "quantity": 38
 }
 ]
 },
 {
 "date": "2015-09-01T04:00:00Z",
 "total": 89,
 "visits_detail": [
 {
 "company": "mercadolibre",
 "quantity": 89
 }
 ]
 }
 ]
 }
]

Se precisar de mais informações sobre como publicar novamente, consulte o tutorial Publicar seus anúncios novamente.

Qualifique entre 1 e 5