Visitas
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
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.