Visitas

Esta API recupera información sobre visitas a las publicaciones de Mercado Libre. Puedes consultar datos por ventanas de tiempo y sites. Recuerda que al volver a publicar se heredan las visitas históricas del parent_item, sin importar cuántas veces se vuelva a publicar.

Contenidos

→Descripción de parámetros
→Visitas totales por usuario
→Visitas totales por artículo
→Visitas por artículo entre rangos de fechas
→Total de visitas por artículos MULTIGET
→Visitas con fecha por usuario
→Visitas con fecha por artículos
→Visitas con fecha por artículos por MULTIGET

Descripción de parámetros

Importante:

A partir del 15 de julio solo podrás consultar los recursos /items/visits e /items/visits/time_window con un máximo de 10 (diez) items_ids por llamada.

Tipo	Parámetro	Descripción
Integer	user_id	ID de usuario.
String	item_id	ID de artículo.
Date	date_from	Fecha, en formato ISO, que define el inicio de la consulta. El máximo es un año.
Date	date_to	Fecha, en formato ISO, que define el fin de la consulta. El máximo es un año.
Date	ending	Opcional. Fecha, en formato ISO, que establece el tiempo de finalización de la muestra; por defecto es la fecha y hora actuales.
String	unit	Unidad de consulta, valores posibles: [“día”].
Integer	last	Opcional. Denota cuántos días atrás cubrirá la muestra.
Integer	total_visits	Visitas totales a un artículo.
Array	visits_detail	Visitas detalladas por país y site.
Array	result	Detalle de visitas agrupadas por intervalos de tiempo. La Unidad del parámetro define la longitud.

Visitas totales por usuario

Recupera las visitas totales que recibe un usuario entre rangos de fechas.
Llamada:

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

Ejemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' 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

Respuesta:

{
  "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 totales por artículo

Recupera las visitas totales a un artículo.
Llamada:

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

Ejemplo:

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

Respuesta:

{
  "MLB9992242141": 552
}

Visitas por artículo entre rangos de fecha

Recupera las visitas totales de acuerdo con un conjunto de artículos concatenados dentro de un rango de fechas, por site.
Llamada:

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

Ejemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' ‘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

Respuesta:

[
  {
    "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 MULTIGET

Recupera las visitas totales de acuerdo con un conjunto de artículos concatenados dentro de un rango de fechas, por site.

Llamada:

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

Ejemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' 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

Respuesta:

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

Visitas con fecha por usuario

Recupera las visitas de un usuario a cada artículo para cierta ventana de tiempo, por site. El detalle de la información está agrupado por intervalos de tiempo.
Llamada:

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

Ejemplo:

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

Respuesta:

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

Visitas con fecha por artículo

Recupera las visitas a un artículo para cierta ventana de tiempo, por site. El detalle de la información está agrupado por intervalos de tiempo.
Llamada:

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

Ejemplo:

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

Respuesta:

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

Visitas con fecha por artículo MULTIGET

Recupera las visitas de acuerdo con un conjunto de artículos (máximo 10), por site. El detalle de la información está agrupado por intervalos de tiempo.
Llamada:

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

Ejemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/visits/time_window?ids=MCO473861358,MCO472253403,MCO471870973&last=3&unit=day

Respuesta:

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

Si necesitas más información sobre republicaciones, por favor consulta el tutorial re-publica tus items.