Manage contacts & visits

Introduction

When users browse classified items, they are able to contact the item’s owner through a form displayed on the listing or they can see the owner’s phone.
There’s a difference between how it works with logged users and guest users. When guest users make a question on your item, the contact goes directly to your email inbox and it’s gonna be displayed on our contacts resource since it doesn’t follow the regular questions flow. When a user that has an account on our site and it’s logged in make a question, it follows the regular questions flow and you can use the Questions API.

To learn how to work with logged users questions, please follow our Manage questions and answers guide. Otherwise, keep reading.

Classified contacts guide

This guide will help you to collect data about questions and phone views on your classified items. Is a read only API, very useful to take metrics of your classified items. You can query data about questions, and keep a record of how many times the ‘See phone’ option was clicked on. You can query by user, item, dates and time windows.

Contents:

Parameters description

TypeParameterDescription
Integer{userId}User id.
Integer{itemId}Item id.
Date{dateFrom}Date, ISO format, that defines the start of the query.
Date{dateTo}Date, ISO format, that defines the end of the query.
Integer{limit}Optional. Max amount of items to return.
Integer{offset}Optional. Pagination.
Integer{last}Optional. Denotes how many hours/days back the sample will cover.
String{unit}Query unit, possible values: [ “day” , “hour”].
Date{ending}Optional. Date, ISO format, which states the time of completion of the sample, by default it’s the current date and time.
String{order}Optional. It’s sorts the results by date: [“desc”, “asc”] (by default it’s “asc”).

Total questions

You can get the total questions an specific item had, or the total questions a seller had in all of his items between a date range.

By item

curl -X GET https://api.mercadolibre.com/items/{Item_id}/contacts/questions?date_from={Date_from}&date_to={Date_to}

By user

curl -X GET https://api.mercadolibre.com/users/{User_id}/contacts/questions?date_from={Date_from}&date_to={Date_to}

Example:

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

Response:

{
    "date_from": "2014-08-01T00:00:00.000-03:00",
    "date_to": "2014-08-02T23:59:59.999",
    "item_id": "MLV421672596",
    "total": 9
}

Questions dated

This resource let you get the questions on an specific item or by seller for a certain time window. Besides, you get details about contacts made on guest mode (unlogged or unregistered users) in between time intervals, by hour or by day.

By item

curl -X GET https://api.mercadolibre.com/items/{Item_id}/contacts/questions/time_window?last={Last}&unit={Unit}

If you need to concatenate items, do the following:

curl -X GET https://api.mercadolibre.com/items/{Item_id}/contacts/questions/time_window?ids={id1,id2}&last={Last}&unit={Unit}&ending={Ending_date}

By user

curl -X GET https://api.mercadolibre.com/users/{User_id}/contacts/questions/time_window?last={Last}&unit={Unit}

Example:

curl -X GET https://api.mercadolibre.com/items/MLA510272257/contacts/questions/time_window?last=2&unit=hour

Response:

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

Contact phone totals

You can get the total times the ‘See phone’ option was clicked on an item or for every item of an user between date ranges.

By item

curl -X GET https://api.mercadolibre.com/items/{Item_id}/contacts/phone_views?date_from={Date_from}&date_to={Date_to}

By user

curl -X GET https://api.mercadolibre.com/users/{User_id}/contacts/phone_views?date_from={Date_from}&date_to={Date_to}

Example:

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

Response:

{
    "date_from": "2014-05-28T00:00:00.000-03:00",
    "date_to": "2014-05-29T23:59:59.999",
    "total": 71,
    "user_id": "52366166"
}

Contact phone dated

You can get the total times the ‘See phone’ option was clicked on an item or for every item of an user for a certain time window. Besides providing the total visits, the information is detailed and grouped by time intervals.

By item

curl -X GET https://api.mercadolibre.com/items/{Item_id}/contacts/phone_views/time_window?last={Last}&unit={Unit}

If you need to concatenate items:

curl -X GET https://api.mercadolibre.com/items/contacts/phone_views/time_window?ids={Id1,Id2}&last={Last}&unit={Unit}&ending={Ending_date}

By user

curl -X GET https://api.mercadolibre.com/users/{User_id}/contacts/phone_views/time_window?last={Last}&unit={Unit}

Example:

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

Response:

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



Next topic: Subscribe to our feeds.

Please rate this