Nummorum stats API

In this documentation we will provide you with the information and examples that you need to use our API

PLEASE NOTE: The stats API is currently in beta, and is actively being worked on. If something is not working properly please contact us on Skype. Thank you!

Authentication

When querying the stats API there are two methods to authenticate. If you do not authenticate a 401 Unauthorized response will be returned.

Method 1: You can pass the given credentials in the URL

You can pass the partner_id and partner_secret that were given to you by your account manager in the url for every request, this will authenticate you to retrieve your stats info
Example:
https://stats.nummorum.money/api/stats?partner_id=nummorum&partner_secret=secret

Method 2: You can set HTTP headers with the given credentials

> GET /api/stats HTTP/1.1

> Host: http://stats.nummorum.money

> Connection: keep-alive

> partner-id: nummorum

> partner-secret: secret

> Accept: */*

 

Filtering

You can use one or more of the following filters when querying our API. 

• country
• feed
• site_id
• media_type (mainstream/adult)
• device_type (mobile/tablet/desktop)
• source_type (popunder/push/banner)
• date_from (yyyy-mm-dd)
• date_to (yyyy-mm-dd)

Filters are applied by adding them to the request url

Example:

To filter for only visits from Netherlands on 15th of january you would use the following query:

https://stats.nummorum.money/api/stats?partner_id=nummorum&partner_secret=secret&date_from=2019-01-15&date_to=2019-01-16&country=NL

Ordering (sorting)

By default the API returns results ordered by visits. To sort the results in a differed order you add the order_by parameter to the url followed by the desired sort value. You can order on the following fields:

• country
• date
• visits
• cost

Example:

https://stats.nummorum.money/api/stats?partner_id=nummorum&partner_secret=secret&order_by=cost

Grouping data (show)

By default the data is grouped and showed by date. To change this default grouping you can add the group_by parameter to the url. You can group on the following data:

• date (default)
• country
• feed
• site_id
• media_type
• device_type
• source_type

A special feature off the group_by parameter is that it accepts multiple comma separated values. This comes in handy when you want to group data per country AND per feed or media_type AND device_type for example.

Example:
https://stats.nummorum.money/api/stats?partner_id=nummorum&partner_secret=secret&group_by=country,date