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.

❗️

OTODOM

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 'https://api.olxgroup.com/advert/v1/<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": "https://api.olxgroup.com/advert/v1/f41e305b-d4eb-4e98-aabf-599b624df3b4/statistics"
        }
    }
}

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.