api
Native Ad Server API
Build native ads into your web page or app
dvr
Sponsored Listings API
Let sellers promote their product at the top of the list
grid_view
Promoted Content API
Add promoted content based on search queries or keywords
desktop_windows
Digital-Out-Of-Home (DOOH) API
Reach out of home audiences on screens or billboards
campaign
Internal Promotions API
Offer users vouchers or promo codes at the right time
api
Decision API
Returns a JSON response with ads
api
Management API
Manage campaigns and inventory
api
Reports API
Custom reports and data shipping
monitor_heart
API Status
Live network infrastructure status
AdFlight.io Logo
AdFlight.io
Ad Server APIs for Developers
topic Getting Started
Authentication
Error Handling
api Decision API
Ad Request
Ad Response
Logging Events
api Management API
Channels
Zones
Advertisers
Campaigns
Creatives
api Reporting API
Reports

Reports

Endpoint

get
/v2/reports

Parameters

group_by
array
The dimension you want to group the report by.
filter
object
The IDs of the campaigns, creatives or zones you want to filter for.
events
object
An array of event names. These events will be included in the reports for all dimensions.

Response

creative_id
int
The ID of the creative.
data
int, required
The content of the creative (used for building the ad).
event_counts
object
Real-time data about event counts for this creative.
is_active
boolean
Whether the creative is active or not.
name
string
The name of the creative.
timestamp
string
The timestamp when the creative was created.
cURL
curl "https://{yourname}.api.adflight.io/v2/reports"
  -H "X-ApiKey: TCm2Hd_rT4pRNvSZ2cGYCJ6... (example)"
Example Response
{
     "creative_id": 770775699,
     "data": [],
     "event_counts": {
         "clicks": 2190,
         "impressions": 170129
    },
     "is_active": true,
     "name": "My creative",
     "timestamp": "2022-08-19 14:19:43"
}
format_quoteThese plug & play ad serving APIs have cut down developement cost tremendously. Absolutely a huge time saver for anyone who wants to build a custom ad server in a short time.
Hayden Elson
starstarstarstarstar
Developer at Galactic Media