Basics of the AdUp API

With our AdUp API, you can sit back and automatically transfer all of your account data into your preferred BI system.


In advance

To use the AdUp API, create an account. To do this, go to Profile in your account or read the relevant support article.

Step 1

Go to our API route (

Step 2

Log in with your Client ID and your Client Sectret. You will receive both in your AdUp Ads account (Login) when you create access to the AdUp API.

Step 3

You can then authenticate yourself via OAuth.

Step 4

Then set up your personal API requests. You can find code examples, descriptions of all fields as well as hints and links to all possible reports further down in this article.

Report request

  "report_name": "Test Report",
  "select": [
  "conditions": [
      "field": "Clicks",
      "operator": "GREATER_THAN",
      "values": [
  "download_format": "JSON",
  "date_range_type": "LAST_MONTH"
Field Description Example

Self-selected name of the report.


The report type to be used for the report. See 'API Reports' below


List of fields to be output in the report. The possible fields depend on the type of report used. See 'API Reports' below for the possible fields.


List of filters to limit the rows contained in the report. A filter consists of field, operator and values


Format in which the report is downloaded. Currently only JSON is possible


The date range for which the report is to be created. See 'Date ranges' below


If date_range_type has been set to CUSTOM_DATE, this specifies here the date range for which the report is to be created. See 'Date ranges' below



To get statistics with a higher level of detail, you can use segmentation.

For example, to get statistics for mobile devices only, you need to filter by device type.

In this case, you want to segment your report by DeviceType. For example, if you add the Device field to a Campaign Performance report, you will get a report with one row for each campaign and device type combination and the statistical values (impressions, clicks, conversions, etc.) split between them. Note that the number of rows can increase exponentially for each additional segment field included in your report.

Implicit Segmentation Each report is grouped by a key. For example, the Campaign Performance report is implicitly segmented by CampaignId.

Rows without metrics

The report may contain rows that have no values in the metrics. This may be due to undeliverable items or items paused within the queried time period.

To get rows without metrics you can set includeZeroImpressions to true (default) in the header. This can be used, for example, to create a structure report that includes all available elements of the account.

However, to reduce the number of rows with many elements without, includeZeroImpressions should be set to false. Alternatively, a filter on metrics in conditions can be used.

Date ranges

For each date_range_type except CUSTOM_DATE, only date_range_type is required.

Date range Reports are created for... Example

Today only


only yesterday


the last 7 days without today


the 7-day period starting from the last Monday


the 5-day business week, Monday to Friday, of the last business week


all days of the current month


all days of the last month


The entire available period


A period of your own. See Own time period.

"date_range": {

    "min": "2021-10-29",

    "max": "2021-10-29"


  "date_range_type": "CUSTOM_DATE"

the last 14 days without today


the last 30 days without today


the period between last Sunday and today


the period between last Monday and today


the 7-day period beginning with the last Sunday

Datentyp Micro Amount

Some fields have the data type Micro Amount, these contain e.g. currency values multiplied by a factor of one million (1,000,000).

Example: A value of 123.4567 EUR is displayed in the field as 123456700.

API Reports

We currently offer four different reports that can be accessed individually via the API.

Account Performance Report (Advertiser) Documentation

Ad Performance Report (Advertiser) Documentation

Campaign Performance Report (Advertiser) Documentation

Direct Placement Performance Report (Advertiser) Dokumentation

Placement Layout Performance Report (Publisher) Documentation

Other scopes and routes

You have selected other scopes besides reporting in your API access? To get the appropriate routes and information, contact your AdUp contact person or write to us at support(at)