Gestiona preguntas y contactos
Guía de contactos clasificados
Esta guía te ayudará a recolectar datos sobre preguntas y visualizaciones del teléfono en tus artículos clasificados. Se trata de una API de solo lectura, muy útil para llevar métricas de tus artículos clasificados. Puedes consultar datos sobre preguntas y llevar un registro de cuántas veces se hizo clic en la opción ‘Ver teléfono’. Puedes consultar por usuario, artículo, fechas y períodos de tiempo.
Descripción de parámetros
Tipo | Parámetro | Descripción |
---|---|---|
Entero | {userId} | ID de usuario. |
Entero | {itemId} | ID de artículo. |
Fecha | {dateFrom} | Fecha, en formato ISO, que define el inicio de la consulta. |
Fecha | {dateTo} | Fecha, en formato ISO, que define el fin de la consulta. |
Entero | {limit} | Opcional. Cantidad máxima de artículos a devolver. |
Entero | {offset} | Opcional. Paginación. |
Entero | {last} | Opcional. Denota cuántas horas/días atrás cubrirá la muestra. |
Cadena | {unit} | Unidad de consulta, valores posibles: [“día”, “hora”]. |
Fecha | {ending} | Opcional. Fecha, en formato ISO, que establece el tiempo de finalización de la muestra; por defecto es la fecha y hora actuales. |
Cadena | {order} | Opcional. Clasifica los resultados por fecha: [“desc”, “asc”] (por defecto es “asc”). |
Contactos totales
Puedes acceder a las preguntas totales que tuvo un artículo o las preguntas totales que tuvo un vendedor en todos sus artículos en un rango de fechas.
Por artículo:
curl -X GET https://api.mercadolibre.com/items/$ITEM_ID/contacts/questions?date_from=$DATE_FROM&date_to=$DATE_TO
Por usuario:
Ejemplo:
curl -X GET https://api.mercadolibre.com/users/$USER_ID/contacts/questions?date_from=$DATE_FROM&date_to=$DATE_TO
Ejemplo:
curl -X GET https://api.mercadolibre.com/items/MLV421672596/contacts/questions?date_from=2014-08-01T00:00:00.000-03:00&date_to=2014-08-02T23:59:59.999
Respuesta:
{
"date_from": "2014-08-01T00:00:00.000-03:00",
"date_to": "2014-08-02T23:59:59.999",
"item_id": "MLV421672596",
"total": 9
}
Contactos con fecha
Este recurso te permite acceder a las preguntas sobre un artículo específico o por vendedor para un período de tiempo específico. Además, accedes a detalles sobre contactos realizados en modo invitado (usuarios que no iniciaron sesión o que no están registrados) entre intervalos de tiempo, por hora o por día.
Por artículo
curl -X GET https://api.mercadolibre.com/items/$ITEM_ID/contacts/questions/time_window?last=$LAST&unit=$UNIT
Si necesitas concatenar artículos, haz lo siguiente:
curl -X GET https://api.mercadolibre.com/items/$ITEM_ID/contacts/questions/time_window?ids=$ID1,ID2&last=$LAST&unit=$UNIT&ending=$ENDING_DATE
Por usuario
Llamada:
curl -X GET https://api.mercadolibre.com/users/$USER_ID/contacts/questions/time_window?last=$LAST&unit=$UNIT
Ejemplo:
curl -X GET https://api.mercadolibre.com/items/MLA510272257/contacts/questions/time_window?last=2&unit=hour
Respuesta:
{
"item_id": "MLA510272257",
"total": 0,
"date_from": "2014-08-06T12:00:00Z",
"date_to": "2014-08-06T14:00:00Z",
"last": 2,
"unit": "hour",
"results": [
{
"date": "2014-08-06T12:00:00Z",
"total": 0
},
{
"date": "2014-08-06T13:00:00Z",
"total": 0
}
]
}
Clicks en teléfonos de contacto
Puedes acceder a la cantidad total de veces que se hizo clic en la opción ‘Ver teléfono’ de un artículo o para cada artículo de un usuario en rangos de fechas.
Por artículo
curl -X GET https://api.mercadolibre.com/items/$ITEM_ID/contacts/phone_views?date_from=$DATE_FROM&date_to=$DATE_TO
Por usuario
curl -X GET https://api.mercadolibre.com/users/$USER_ID/contacts/phone_views?date_from=$DATE_FROM&date_to=$DATE_TO
Ejemplo:
curl -X GET https://api.mercadolibre.com/users/52366166/contacts/phone_views?date_from=2014-05-28T00:00:00.000-03:00&date_to=2014-05-29T23:59:59.999
Respuesta:
{
"date_from": "2014-05-28T00:00:00.000-03:00",
"date_to": "2014-05-29T23:59:59.999",
"total": 71,
"user_id": "52366166"
}
Click en teléfonos de contacto con fecha
Puedes acceder a la cantidad total de veces que se hizo clic en la opción ‘Ver teléfono’ de un artículo o para cada artículo de un usuario durante cierto período de tiempo. Además de entregar las visitas totales, la información se detalla y agrupa por intervalo de tiempo.
Por artículo
curl -X GET https://api.mercadolibre.com/items/$ITEM_ID/contacts/phone_views/time_window?last=$LAST&unit=$UNIT
Si necesitas concatenar artículos:
curl -X GET https://api.mercadolibre.com/items/contacts/phone_views/time_window?ids=$ID1,ID2&last=$LAST&unit=$UNIT&ending=$ENDING_NOTE
Por usuario
Llamada:
curl -X GET https://api.mercadolibre.com/users/$USER_ID/contacts/phone_views/time_window?last=$LAST&unit=$UNIT
Ejemplo:
curl -X GET https://api.mercadolibre.com/items/contacts/phone_views/time_window?ids=MLA510272257,MLA489747739&last=2&unit=hour&ending=2014-05-28T00:00:00.000-03:00
Respuesta:
[
{
"item_id": "MLA510272257",
"total": 0,
"date_from": "2014-05-28T02:00:00Z",
"date_to": "2014-05-28T04:00:00Z",
"last": 2,
"unit": "hour",
"results": [
{
"date": "2014-05-28T02:00:00Z",
"total": 0
},
{
"date": "2014-05-28T03:00:00Z",
"total": 0
}
]
},
{
"item_id": "MLA489747739",
"total": 0,
"date_from": "2014-05-28T02:00:00Z",
"date_to": "2014-05-28T04:00:00Z",
"last": 2,
"unit": "hour",
"results": [
{
"date": "2014-05-28T02:00:00Z",
"total": 0
},
{
"date": "2014-05-28T03:00:00Z",
"total": 0
}
]
}
]
Estructura Errores 400:
Respuesta:
{
"code":"bad_request",
"message":"error decoding 'user_id'. It must be string or number"
}
Visitas por publicación
Para consultar las visitas por anuncio, utilice el artículo Recurso de Visitas.
Siguiente: Recibe notificaciones.
