Skip to main content

Access analytics data via an Application Programming Interface (API)

Updated

Dianomi offers API integration that allows for you to see reporting in your existing dashboards. 

Dianomi Advertiser Analytics API 

Introduction

The Dianomi Analytics API allows you to retrieve your analytics statistics in CSV format.

Before using the API, please contact your Dianomi Account Manager to ensure the following have been provided and enabled for your account:

  • Client ID
  • API credentials
  • Statistics access permissions

Authentication & Authorisation

To authenticate your API requests, you must include the following headers:

Email Address

Header Name: X-Auth-Email

Use the email address associated with your Dianomi account when making API requests.

API Key

Header Name: X-Auth-Key

Your API key is required to authenticate requests. Please contact your Dianomi Account Manager to obtain your API key.

Client ID

Header Name: X-Auth-Client-Id

Your Client ID identifies your account and is required for all API requests.

Retrieving Analytics Statistics

The API enables advertisers to retrieve Dianomi analytics statistics using a GET request.

https://my.dianomi.com/cgi-bin/selfserve/stat.pl?client_id=:CLIENT_ID&stat_id=:STAT_ID&date1=:DATE1&date2=DATE2&download=1

To successfully retrieve statistics, you must provide:

  • Client ID
  • Date range
  • Stat ID

Responses are returned in CSV format.

If you do not have your Client ID or required permissions enabled, please contact your Dianomi Account Manager.

Example cURL request:

curl -X GET \ 
"https://my.dianomi.com/cgi-bin/selfserve/stat.pl?client_id=12345&stat_id=1500&date1=2026-05-01&date2=2026-05-18&download=1" \
  -H "X-Auth-Email: user@example.com" \
  -H "X-Auth-Key: YOUR_API_KEY" \
  -H "X-Auth-Client-Id: 12345" \
  -o report.csv

Stat Navigation Information

Get Stat Navigation Information

This endpoint retrieves navigation and configuration information for available statistics.

https://my.dianomi.com/cgi-bin/genienav.pl?client_id=:CLIENT_ID

The response includes metadata such as:

  • Available Stat IDs
  • Visibility settings
  • Statistic configuration options
  • Additional stat type information

Authentication for this endpoint also requires:

  • Email Address
  • API Key
  • Client ID

Example cURL request:

curl -X GET \
  "https://my.dianomi.com/cgi-bin/genienav.pl?client_id=12345" \
  -H "X-Auth-Email: user@example.com" \
  -H "X-Auth-Key: YOUR_API_KEY" \
  -H "X-Auth-Client-Id: 12345"

Dianomi Publisher Analytics API

Introduction

The Dianomi Publisher Analytics API allows publishers to retrieve analytics statistics in CSV format.

Before using the API, please contact your Dianomi Account Manager to ensure the following have been provided and enabled for your account:

  • Publisher ID
  • API credentials
  • Statistics access permissions

Authentication & Authorisation

To authenticate your API requests, you must include the following headers:

Email Address

Header Name: X-Auth-Email

Use the email address associated with your Dianomi account when making API requests.

API Key

Header Name: X-Auth-Key

Your API key is required to authenticate requests. Please contact your Dianomi Account Manager to obtain your API key.

Retrieving Publisher Statistics

You can retrieve Dianomi publisher analytics statistics by sending a GET request with the required parameters.

https://my.dianomi.com/cgi-bin/selfserve/stat.pl?partner_id=:PARTNER_ID&stat_id=:STAT_ID&date1=:DATE1&date2=:DATE2&download=1

Responses are returned in CSV format.

To successfully retrieve statistics, you must provide:

  • partner_id
  • Date range
  • Stat ID

Example cURL request:

curl -X GET \ 
"https://my.dianomi.com/cgi-bin/selfserve/stat.pl?partner_id=67890&stat_id=1234&date1=2026-05-01&date2=2026-05-18&download=1" \
  -H "X-Auth-Email: publisher@example.com" \
  -H "X-Auth-Key: YOUR_API_KEY"

Default Publisher Statistics

Below are the standard publisher statistics currently available through the API:

Statistic Stat ID
Data by Smartad by Day 1393
Performance by Country 1418
Partner Revenue Over Time 1388
Revenue by Device 1560
Revenue by Product Type 1398
Smartad Performance 1505

Additional Parameters

For the Data by Smartad by Day report (1393), you must also include the following parameter after the Stat ID:

&idnum=idnumber


Additional Reporting

If you require access to additional statistics or custom reporting, please contact your Dianomi Account Manager.

Good to know

  • One API key can work for multiple email addresses, as long as the email addresses are users on your Dianomi account and have the API password associated with them.
  • You can only query one stat ID at a time, independently.

If you prefer you can download reports from Analytics or we can schedule automated reports.

For further details, please contact your account manager.

Related articles

Powered by Zendesk