Recurso Visits

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


Conteúdos


Descrição de parâmetros

Tipo Parâmetro Descrição
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.
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 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.
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/1000011398/items_visits?date_from=2018-01-01T00:00:00.000-00:00&date_to=2018-08-01T00:00:00.000-00:00’

Resposta:

{
  "user_id": 1000011398,
  "date_from": "2018-01-01T00:00:00Z",
  "date_to": "2018-08-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.
Recurso:

https://api.mercadolibre.com/visits/items?ids={Items_id}

Exemplo:

curl -X GET 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.
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=MCO473861358,MCO472253403,MCO471870973&date_from=2018-05-26T00:00:00.000-00:00&date_to=2018-08-08T00:00:00.000-00:00’

Resposta:

[
  {
    "item_id": "MCO473861358",
    "date_from": "2018-05-26T00:00:00Z",
    "date_to": "2018-08-08T00:00:00Z",
    "total_visits": 536,
    "visits_detail": [
      {
        "company": "mercadolibre",
        "quantity": 536
      }
    ]
  }

Total de visitas por artículo MULTI-GET

Recuperação do total das visitas segundo um conjunto de artículos 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=MCO473861358,MCO472253403,MCO471870973&date_from=2018-05-26T00:00:00.000-00:00&date_to=2018-08-08T00:00:00.000-00:00’

Reposta:

[
  {
    "item_id": "MCO472253403",
    "date_from": "2018-05-26T00:00:00Z",
    "date_to": "2018-08-08T00:00:00Z",
    "total_visits": 431,
    "visits_detail": [
      {
        "company": "mercadolibre",
        "quantity": 431
      }
    ]
  },
  {
    "item_id": "MCO471870973",
    "date_from": "2018-05-26T00:00:00Z",
    "date_to": "2018-08-08T00:00:00Z",
    "total_visits": 459,
    "visits_detail": [
      {
        "company": "mercadolibre",
        "quantity": 459
      }
    ]
  },
  {
    "item_id": "MCO473861358",
    "date_from": "2018-05-26T00:00:00Z",
    "date_to": "2018-08-08T00: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.
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/1000011398/items_visits/time_window?last=2&unit=day’

Resposta:

{
  "user_id": 1000011398,
  "date_from": "2018-08-08T00:00:00Z",
  "date_to": "2018-08-10T00:00:00Z",
  "total_visits": 2923,
  "last": 2,
  "unit": "day",
  "results": [
    {
      "date": "2018-08-08T00:00:00Z",
      "total": 2205,
      "visits_detail": [
        {
          "company": "mercadolibre",
          "quantity": 2205
        }
      ]
    },
    {
      "date": "2018-08-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.
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/MCO471870973/visits/time_window?last=2&unit=day&ending=2018-08-06’

Resposta:

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


Visitantes por data por anúncio MULTIGET

Recuperação das visitas segundo um conjunto de anúncios (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=MCO473861358,MCO472253403,MCO471870973&last=3&unit=day‘

Resposta:

[
  {
    "item_id": "MCO471870973",
    "date_from": "2018-08-07T00:00:00Z",
    "date_to": "2018-08-10T00:00:00Z",
    "total_visits": 15,
    "last": 3,
    "unit": "day",
    "results": [
      {
        "date": "2018-08-07T00:00:00Z",
        "total": 8,
        "visits_detail": [
          {
            "company": "mercadolibre",
            "quantity": 8
          }
        ]
      },
      {
        "date": "2018-08-08T00:00:00Z",
        "total": 1,
        "visits_detail": [
          {
            "company": "mercadolibre",
            "quantity": 1
          }
        ]
      },
      {
        "date": "2018-08-09T00:00:00Z",
        "total": 6,
        "visits_detail": [
          {
            "company": "mercadolibre",
            "quantity": 6
          }
        ]
      }
    ]
  },
  {
    "item_id": "MCO473861358",
    "date_from": "2018-08-07T00:00:00Z",
    "date_to": "2018-08-10T00:00:00Z",
    "total_visits": 21,
    "last": 3,
    "unit": "day",
    "results": [
      {
        "date": "2018-08-07T00:00:00Z",
        "total": 12,
        "visits_detail": [
          {
            "company": "mercadolibre",
            "quantity": 12
          }
        ]
      },
      {
        "date": "2018-08-08T00:00:00Z",
        "total": 1,
        "visits_detail": [
          {
            "company": "mercadolibre",
            "quantity": 1
          }
        ]
      },
      {
        "date": "2018-08-09T00:00:00Z",
        "total": 8,
        "visits_detail": [
          {
            "company": "mercadolibre",
            "quantity": 8
          }
        ]
      }
    ]
  },
  {
    "item_id": "MCO472253403",
    "date_from": "2018-08-07T00:00:00Z",
    "date_to": "2018-08-10T00:00:00Z",
    "total_visits": 12,
    "last": 3,
    "unit": "day",
    "results": [
      {
        "date": "2018-08-07T00:00:00Z",
        "total": 9,
        "visits_detail": [
          {
            "company": "mercadolibre",
            "quantity": 9
          }
        ]
      },
      {
        "date": "2018-08-08T00:00:00Z",
        "total": 1,
        "visits_detail": [
          {
            "company": "mercadolibre",
            "quantity": 1
          }
        ]
      },
      {
        "date": "2018-08-09T00:00:00Z",
        "total": 2,
        "visits_detail": [
          {
            "company": "mercadolibre",
            "quantity": 2
          }
        ]
      }
    ]
  }
]

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

Faça parte da nossa comunidade