Get advert statistics

Using the Advert API you can also get relevant metrics about advert performance as recorded in the portal where it was published to.



Not available yet for OTODOM. If you are interested in using this feature, please contact us.


Metric updates

Metrics are updated every few minutes during the current day.

Here are the metrics that you retrieve:

MetricValue TypeDescription
messages_countintegerTotal count of leads received
page_viewsintegerTotal number of page views
phone_viewsintegerTotal number of clicks (in the "show phone" button)

Here's an example request:

curl --location --request GET '<UUID>/statistics' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: <YOUR API KEY>' \
--header 'Authorization: Bearer <ACCESS TOKEN>' \
--header 'User-Agent: <CRM NAME>'

and here's an example response:

    "transaction_id": "9d94e728-311b-11e9-b0ab-ab3d577aa06b",
    "message": "Advert statistics history",
    "data": [
            "date": "2019-02-15",
            "messages_count": 2,
            "page_views": 4,
            "phone_views": 2
            "date": "2019-02-14",
            "messages_count": 1,
            "page_views": 3,
            "phone_views": 1
    "links": {
        "first": {
            "href": ""

As you can see, in the links node you'll find Hypertext REFerences to navigate through all the pages - data points - that the advert might have.

You might also get an empty data node when there are no data points to show.