Documentation

Documentation

  • General
  • Advertisers
  • Publishers
  • RTB
  • API
  • News

›Adnation Public API

Adnation Public API

  • API Overview
  • Developer API
  • Versions
  • API Interface
  • HTTP Headers
  • HTTP Verbs
  • Returned Data Standard Types
  • Errors
  • Macros
  • Pagination
  • Rate Limiting
  • Global Statistics API
  • Changelog
  • PHP Examples

Ad Placement API

  • Ad Placement API Overview
  • Request
  • Response
  • Errors
  • Error Examples

Conversion Tracking API

  • Conversion Tracking API

Changelog

Version 2.0.0

2020 January

  • Renamed endpoints to more AdBlock-friendly (old names are still working for now for backwards compatibility):
    • /statistics/advertiser/... -> /statistics/a/...
    • /statistics/publisher/... -> /statistics/p/...
    • /collections/native-ad-formats -> /collections/native-formats

2019 January

  • New endpoints:
    • statistic
      • POST - /statistics/advertiser/global
      • POST - /statistics/publisher/global
  • Bug fixes:
    • Fix issue with update of Google Compliance rules through API.
    • Fix bug with adding images to variations (native Ad) through API.
    • Fix issue with VAT number not being updated through API.

 

2018 December

  • New endpoints:
    • collections
      • GET - /collections/all-payment-types
      • GET - /collections/payment-transaction-types
      • GET - /collections/global-daily-budget
  • Bug fixes:
    • Bug fix for exclude_deleted flag emptying statistics response.
    • Fix issue with update of Google Compliance rules through API.

 

2018 November

  • Bug fixes:
    • Fix API issue on copy of campaigns.
    • Fix API bug with in-stream-skip-after not being saved.
    • Improvements and fixes on zones API routes.
    • Return correct URL protocol.

 

2018 October

  • Bug fixes:
    • Add support for Push Notifications
    • Fix issue with zones border color definition on API.
    • Bug fixes for sites verification API route.

 

2018 September

  • New endpoints:
    • collections
      • GET - /collections/balance-alert
      • GET - /collections/campaign-types

 

2018 August

  • New endpoints:
    • sites
      • GET - /sites/unverified-sites
      • GET - /sites/unverified-sites/{unverifiedSiteId}
    • collections
      • GET - /collections/crop-anchor-points
      • GET - /collections/operating-system-types
      • GET - /collections/bidder-rule-settings
    • library
      • POST - /library/html
    • bidders
      • GET - /bidders
      • POST - /bidders
      • DELETE - /bidders/{bidderid}
      • GET - /bidders/{bidderid}
      • PUT - /bidders/{bidderid}
      • GET - /bidders/{bidderid}/rules
      • GET - /bidders/{bidderid}/history
      • DELETE - /bidders/{bidderid}/campaign_associations
      • POST - /bidders/rules
      • PUT - /bidders/{bidderid}/rules
      • GET - /bidders/rules
      • GET - /bidders/rules/{ruleid}
      • DELETE - /bidders/rules/{ruleid}

 

2018 July

  • New endpoints:
    • statistics
      • GET - /statistics/advertiser/landingPage
    • campaigns
      • DELETE - /campaigns/{campaignid}/variation/{variationid}
    • library
      • PUT - /library/file/{idvariation}/user-tags
      • GET - /library/html
      • PUT - /library/html/{idvariation}/user-tags
      • GET - /library/user-tags
      • POST - /library/user-tags

 

2018 June

  • New endpoints:
    • collections
      • GET - /collections/ratescard-formats
      • GET - /collections/traffic-types

 

2018 May

  • New endpoints:
    • collections
      • GET - /collections/languages/system
      • GET - /collections/ad-placement-types
      • GET - /collections/device-types
      • GET - /collections/network-types
    • news
      • GET - /news/feed
    • marketplace
      • GET - /marketplace

 

2018 January

  • New endpoints:
    • library
      • GET - /library/file
      • POST - /library/file
      • GET - /library/url
      • POST - /library/url

 

2017 August

  • API V2 released
  • New endpoints:
    • campaign groups
      • GET - /campaigns/group/{idgroup}
      • POST - /campaigns/groups
      • PUT - /campaigns/groups/{idgroup}
      • DELETE - /campaigns/groups/{idgroup}
      • PUT - /campaigns/groups/{idgroup}/campaigns
      • DELETE - /campaigns/groups/{idgroup}/campaigns
    • campaign variations
      • GET - /campaigns/{idcampaign}/variation
      • POST - /campaigns/{idcampaign}/variation
      • PUT - /campaigns/{idcampaign}/variation/{idvariation}
      • PUT - /campaigns/{idcampaign}/variation/{idvariation}/pause
      • PUT - /campaigns/{idcampaign}/variation/{idvariation}/play
    • collections
      • GET - /collections/advertiser-ad-types
      • GET - /collections/daily-budget
      • GET - /collections/marketing-tags
      • GET - /collections/minimum-prices
      • GET - /collections/offer-algorithms
      • GET - /collections/payment-types
      • GET - /collections/pricing-models
      • GET - /collections/product-categories
      • GET - /collections/publisher-ad-types
      • GET - /collections/site-types
      • GET - /collections/timezones
    • goals
      • POST - /goals
      • PUT - /goals/{idgoal}
      • DELETE - /goals/{idgoal}
    • offers
      • GET - /offers
      • POST - /offers
      • GET - /offers/{idoffer}
      • PUT - /offers/{idoffer}
      • DELETE - /offers/{idoffer}
      • PUT - /offers/{idoffer}/landing-pages
    • referrals
      • GET - /referrals/clients
      • GET - /referrals/statistics
    • sites
      • GET - /sites
      • POST - /sites
      • PUT - /sites/{idsite}
      • DELETE - /sites/{idsite}
    • statistics
      • GET - /statistics/publisher/adblock
    • zones
      • GET - /zones
      • POST - /zones
      • PUT - /zones/{idzone}
      • DELETE - /zones/{idzone}
      • GET - /zones/{idzone}/snippet
  • Endpoints changed:
    • campaigns
      • PUT - /campaigns/delete
      • PUT - /campaigns/pause
      • PUT - /campaigns/play
      • PUT - /campaigns/restore

 

Version 1.2.2

2016 October

  • New collection endpoint available in API V1
    • collections
      • GET - /collections/adformats
  • New adformat parameter available for campaigns copy
    • campaigns
      • PUT - /collections/{campaignid}/copy

 

Version 1.2.1

2016 January

  • New endpoints available in API V1
    • goals
      • GET - /goals

 

Version 1.2.0

2016 January

  • New api token authentication in API V1
    • POST - /login api_token parameter (optional) added in request to /login
  • New endpoints available in API V1
    • campaigns
      • POST - /campaigns/{campaignid}/{type}/keywords
      • PUT - /campaigns/{campaignid}/{type}/keywords
      • DELETE - /campaigns/{campaignid}/{type}/keywords
      • DELETE - /campaigns/{campaignid}/{type}/keywords/all
      • POST - /campaigns/{campaignid}/{type}/ip_ranges
      • PUT - /campaigns/{campaignid}/{type}/ip_ranges
      • DELETE - /campaigns/{campaignid}/{type}/ip_ranges
      • DELETE - /campaigns/{campaignid}/{type}/ip_ranges/all

 

Version 1.1.1

2015 October

  • New endpoints available in API V1
    • campaigns
      • GET - /campaigns/groups
  • deleted flag in request to /campaigns
  • include field in requests to /statistics/advertiser/*
  • country field in requests to /statistics/publisher/*

 

Version 1.1.0

2015 September

  • New endpoints available in API V1
    • campaigns
      • PUT - /campaigns/{campaignid}
      • POST - /campaigns/{campaignid}/{type}/browsers
      • PUT - /campaigns/{campaignid}/{type}/browsers
      • DELETE - /campaigns/{campaignid}/{type}/browsers
      • DELETE - /campaigns/{campaignid}/{type}/browsers/all
      • POST - /campaigns/{campaignid}/{type}/carriers
      • PUT - /campaigns/{campaignid}/{type}/carriers
      • DELETE - /campaigns/{campaignid}/{type}/carriers
      • DELETE - /campaigns/{campaignid}/{type}/carriers/all
      • POST - /campaigns/{campaignid}/{type}/categories
      • PUT - /campaigns/{campaignid}/{type}/categories
      • DELETE - /campaigns/{campaignid}/{type}/categories
      • DELETE - /campaigns/{campaignid}/{type}/categories/all
      • POST - /campaigns/{campaignid}/{type}/countries
      • PUT - /campaigns/{campaignid}/{type}/countries
      • DELETE - /campaigns/{campaignid}/{type}/countries
      • POST - /campaigns/{campaignid}/{type}/devices
      • PUT - /campaigns/{campaignid}/{type}/devices
      • DELETE - /campaigns/{campaignid}/{type}/devices
      • DELETE - /campaigns/{campaignid}/{type}/devices/all
      • POST - /campaigns/{campaignid}/{type}/languages
      • PUT - /campaigns/{campaignid}/{type}/languages
      • DELETE - /campaigns/{campaignid}/{type}/languages
      • DELETE - /campaigns/{campaignid}/{type}/languages/all
      • POST - /campaigns/{campaignid}/{type}/operating_systems
      • PUT - /campaigns/{campaignid}/{type}/operating_systems
      • DELETE - /campaigns/{campaignid}/{type}/operating_systems
      • DELETE - /campaigns/{campaignid}/{type}/operating_systems/all
      • POST - /campaigns/{campaignid}/{type}/sites
      • PUT - /campaigns/{campaignid}/{type}/sites
      • DELETE - /campaigns/{campaignid}/{type}/sites
      • DELETE - /campaigns/{campaignid}/{type}/sites/all

 

Version 1.0.1

 

2015 June

  • Bug fix to campaigns:
    • active field removed
    • status field now
      • -1 = deleted
      • 0 = paused
      • 1 = running

 

Version 1.0.0

 

2015 March

  • Endpoints available in API V1
    • campaigns
      • GET - /campaigns
      • GET - /campaigns/{campaignid}
      • PUT - /campaigns/{campaignid}/copy
      • PUT - /campaigns/{campaignid}/delete
      • PUT - /campaigns/{campaignid}/pause
      • PUT - /campaigns/{campaignid}/play
      • PUT - /campaigns/{campaignid}/restore
    • collections
      • GET - /collections
      • GET - /collections/browsers
      • GET - /collections/carriers
      • GET - /collections/categories
      • GET - /collections/countries
      • GET - /collections/devices
      • GET - /collections/languages
      • GET - /collections/operating-systems
    • login
      • POST - /login
    • payments
      • GET - /payments/advertiser
      • GET - /payments/publisher
    • sites
      • GET - /sites
    • statistics
      • GET - /statistics/advertiser/browser
      • GET - /statistics/advertiser/carrier
      • GET - /statistics/advertiser/category
      • GET - /statistics/advertiser/country
      • GET - /statistics/advertiser/date
      • GET - /statistics/advertiser/device
      • GET - /statistics/advertiser/hour
      • GET - /statistics/advertiser/language
      • GET - /statistics/advertiser/os
      • GET - /statistics/advertiser/site
      • GET - /statistics/advertiser/variation
      • GET - /statistics/publisher/browser
      • GET - /statistics/publisher/carrier
      • GET - /statistics/publisher/category
      • GET - /statistics/publisher/country
      • GET - /statistics/publisher/date
      • GET - /statistics/publisher/device
      • GET - /statistics/publisher/hour
      • GET - /statistics/publisher/os
      • GET - /statistics/publisher/site
      • GET - /statistics/publisher/sub
      • GET - /statistics/publisher/zone
    • user
      • GET - /user
      • PUT - /user
      • POST - /user/changepassword
      • POST - /user/resetpassword
    • zones
      • GET - /zones
← Global Statistics APIPHP Examples →
  • Version 2.0.0
    • 2020 January
    • 2019 January
    • 2018 December
    • 2018 November
    • 2018 October
    • 2018 September
    • 2018 August
    • 2018 July
    • 2018 June
    • 2018 May
    • 2018 January
    • 2017 August
  • Version 1.2.2
    • 2016 October
  • Version 1.2.1
    • 2016 January
  • Version 1.2.0
    • 2016 January
  • Version 1.1.1
    • 2015 October
  • Version 1.1.0
    • 2015 September
  • Version 1.0.1
    • 2015 June
  • Version 1.0.0
    • 2015 March
Copyright © 2023 adnation