Buyer side Guide

Structure of Adform's platform

Adform's platform is structured as shown below:


If you want to create a new user, get an API access or download our Postman based API collection, please, read our User Set-up Guide



An application (OAuth client) needs to be registered so that it can get an access token and consume API services.

For a full authentication flow please refer to our Authorization Guide.

For more information, please, contact API support at


Campaign creation

To create a campaign you have to use POST endpoint, while also providing your access token in the "Authorization" header. Request body has to be in JSON format.

Full extensive list of mandatory and optional parameters for campaign creation API request can be found here.

Here is an example of a campaign creation:

Response example:


Other campaign management APIs

Management –                 read more here

Alerts –                                 read more here

Attribute settings –         read more here

Labels –                                read more here

Landing pages –                read more here

RTB settings –                    read more here


What are they?

Orders in Adform’s platform could be called “folders” for line items. They do not play an essential role. However, they are used for convenience. You can place multiple line items in one order and if you deactivate an order all line items that are located under it will be paused.

Default order is created when you create your first campaign

More about orders

Order management –                             read more here

Line Items

Line items are the main tool for launching an ad. Each order can consist up to 500 line items. This is where you set your runtime dates, budgets, targeting, etc.

Line items are divided into two types:


Creating line item

To create an RTB line item, you have to use POST /v1/buyer/rtb/lineitems endpoint, while also providing your access token in the "Authorization" header.

Here is an example of an RTB line item creation:

A successful response should look like this:



Banners are your ads, they are what customers see. Various types of banners can be created and managed using Adform’s API such as:

  • HTML banners
  • Image banners
  • Video banners
  • Flash banners
  • Etc.

Learn more about banner creation here.

Banners can also be put into rotators. Rotator is a set few banners that are shown interchangeably depending on your needs. Rotators can also be optimized for CTR, etc.

Learn more about rotators management here.


Here is an example of Image Banner creation using API. In the request body you have to provide:

  • File name
  • Image file encoded in base64
  • Campaign ID
  • Desired banner title

Response example:

Response contains “Value”, which is banner's UUID that is used to associate Line Item with a banner through Tags.


For direct campaigns tags are acting as serving scripts that are implemented by websites and are usually serving one banner, rotator or schedule. Each tag has a unique identifier that is also visible in banner object after the banner is served.

For RTB campaigns tags are acting as a match point between a designated banner and inventory. The generated serving script doesn't have to be implemented to the publisher's website as the banner is loaded through a master tag.

Learn more about Tag management here.


In order to use these APIs one's account has to have additional rights enabled.

To have Reporting Stats API access enabled, please, contact

Reporting APIs allows to get data that can be used to track performance of your campaing.

Learn more about overall Reporting API here.


Reporting Stats API

Reporting Stats API allows you to build custom reports by choosing certain dimensions and metrics. To get started, you have to decide what kind of data you want to receive.

Then, choose desired metrics, dimensions and, if need be, filters, paging and sorting. To get an extensive list of available parameters, metadata API can be used – read more here for Metrics and here for Dimensions.

To get clicks and impressions of each campaign, API request would look like this:

The response looks like this:



Master Data API

It is also possible to receive raw data that one can use in their own statistical tool to reach conclusions. This is done using Master Data API.

In order to use Master Data API, additional rights has to be enabled. Please, contact to have them enabled.

Info to keep in mind:

  • Information is updated every hour
  • Each file contains only new data
  • Master Data is additionally paid service

Master Data API response with a list of files:

Once this list is received another endpoint to download actual files can be used.

If you want to learn more about Master data API please click here.

Site tracking

This service allows you to manage tracking points. Creating a tracking code and implementing it into your website automatically creates a tracking point. You can get a list of tracking points at advertiser level using GET Tracking Points method.


Still have questions?

If you can't find an answer to your question here, email our Support team