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_TOPor usuario:
Ejemplo:
curl -X GET https://api.mercadolibre.com/users/$USER_ID/contacts/questions?date_from=$DATE_FROM&date_to=$DATE_TOEjemplo:
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.999Respuesta:
{
"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=$UNITSi 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_DATEPor usuario
Llamada:
curl -X GET https://api.mercadolibre.com/users/$USER_ID/contacts/questions/time_window?last=$LAST&unit=$UNITEjemplo:
curl -X GET https://api.mercadolibre.com/items/MLA510272257/contacts/questions/time_window?last=2&unit=hourRespuesta:
{
"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_TOPor usuario
curl -X GET https://api.mercadolibre.com/users/$USER_ID/contacts/phone_views?date_from=$DATE_FROM&date_to=$DATE_TOEjemplo:
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.999Respuesta:
{
"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=$UNITSi 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_NOTEPor usuario
Llamada:
curl -X GET https://api.mercadolibre.com/users/$USER_ID/contacts/phone_views/time_window?last=$LAST&unit=$UNITEjemplo:
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:00Respuesta:
[
{
"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.
