Skip to main content
API requirements

API requirements for Ad networks

Sevak avatar
Written by Sevak
Updated over 5 years ago

Required API functions:

List of zones:

Request:
GET http://adnetwork.com/api/zones_list/?api_key={API_KEY}

Response (200 OK):
[
 {
  "zone_id": "zone_id",      // required, for zone info request
  "zone_name": "popunder_zone_1", // required, human readable name of zone
  "zone_adtype": "popunder", // popunder/banner/im/vast/slider/push
 },
 // ...
]

Zone info:

Request:
GET http://adnetwork.com/api/zones_list/?api_key={API_KEY}&zone_id={ZONE_ID}

Response (200 OK):
{
  "zone_id": "zone_id",                          
  "zone_code": "<iframe>...</iframe>", // html, js or php code for embedding the ad on the publishers website
  "link": "https://adnetwork.com/ad/redirect"  // direct ad link or xml link
}

// At least one of code or link fields is required.

Statistics group by date for zone:

Request:
GET http://adnetwork.com/api/stat/?api_key={API_KEY}&zone_id={ZONE_ID}&group_by=date&date_from=2019-09-01&date_to=2019-09-07

Response (200 OK):
[
 {
  "date": "2019-09-01", // required
  "impressions": 12345, // required, number of impression for zone/date
  "revenue": 12.36,     // required, money earned by zone in USD, for the date
  "bounces": 32,        // returned impressions (optional)
 },
 // ...
]

Statistic grouped by country for zone:

Request:
GET http://adnetwork.com/api/stat/?api_key={API_KEY}&zone_id={ZONE_ID}&group_by=country&date_from=2019-09-01&date_to=2019-09-07

Response (200 OK):
[
 {
  "country": "US",     // required
  "impressions": 12345,// required, number of impressions for zone/date/country
  "revenue": 12.36,    // required, money earned by zone, for the date
  "bounces": 32,       // returned impressions (optional)
 },
 // ...
]

We can detect country by Name or ISO Alpha 2, ISO Alp ha 3 codes.

Statistics group by date for sub1_id:

Request:
GET http://adnetwork.com/api/stat/?api_key={API_KEY}&zone_id={ZONE_ID}&sub1_id={CREATIVE_ID}group_by=date&date_from=2019-09-01&date_to=2019-09-07

Response (200 OK):
[
 {
  "date": "2019-09-01",   // required
  "impressions": 12345,    // required, number of impression for zone/date
  "revenue": 12.36,     // required, money earned by zone, for date
  "bounces": 32,        // optional
 },
 // ...
]

Statistic grouped by country for sub1_id:

Request:
GET http://adnetwork.com/api/stat/?api_key={API_KEY}&zone_id={ZONE_ID}&sub1_id={CREATIVE_ID}&group_by=country&date_from=2019-09-01&date_to=2019-09-07

Response (200 OK):
[
 {
  "country": "US",     // required
  "impressions": 12345,// required, number of impressions for zone/date/country
  "revenue": 12.36,    // required, money earned by zone, for the date
  "bounces": 32,       // returned impressions (optional)
 },
 // ...
]

Statistics group by date for sub2_id:

Request:
GET http://adnetwork.com/api/stat/?api_key={API_KEY}&zone_id={ZONE_ID}&sub2_id={TRAFFIC_SOURCE}group_by=date&date_from=2019-09-01&date_to=2019-09-07

Response (200 OK):
[
 {
  "date": "2019-09-01",   // required
  "impressions": 12345,    // required, number of impression for zone/date
  "revenue": 12.36,     // required, money earned by zone, for date
  "bounces": 32,        // optional
 },
 // ...
]

Statistic grouped by country for sub2_id:

Request:
GET http://adnetwork.com/api/stat/?api_key={API_KEY}&zone_id={ZONE_ID}&sub2_id={TRAFFIC_SOURCE}&group_by=country&date_from=2019-09-01&date_to=2019-09-07

Response (200 OK):
[
 {
  "country": "US",     // required
  "impressions": 12345,// required, number of impressions for zone/date/country
  "revenue": 12.36,    // required, money earned by zone, for the date
  "bounces": 32,       // returned impressions (optional)
 },
 // ...
]

We can detect country by Name or ISO Alpha 2, ISO Alp ha 3 codes.

Did this answer your question?