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

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/MCO473861358/visits?date_from=2018-06-13T00:00:00.000-00:00&date_to=2018-08-08T00:00:00.000-00:00’
Resposta:
{
  "item_id": "MCO473861358",
  "date_from": "2018-06-13T00:00:00Z",
  "date_to": "2018-08-08T00:00:00Z",
  "total_visits": 536,
  "visits_detail": [
    {
      "company": "mercadolibre",
      "quantity": 536
    }
  ]
}

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=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
      }
    ]
  },
  {
    "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
      }
    ]
  }
]

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/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": 3033,
  "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": 828,
      "visits_detail": [
        {
          "company": "mercadolibre",
          "quantity": 828
        }
      ]
    }
  ]
}

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/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 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=MCO473861358,MCO472253403,MCO471870973&last=3&unit=day‘
Resposta:
[
  {
    "item_id": "MCO473861358",
    "date_from": "2018-08-07T00:00:00Z",
    "date_to": "2018-08-10T00:00:00Z",
    "total_visits": 23,
    "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": 10,
        "visits_detail": [
          {
            "company": "mercadolibre",
            "quantity": 10
          }
        ]
      }
    ]
  },
  {
    "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
          }
        ]
      }
    ]
  },
  {
    "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
          }
        ]
      }
    ]
  }
]
Se precisar de mais informações sobre como publicar novamente, consulte o tutorial Publicar seus anúncios novamente.

Faça parte da nossa comunidade