AerServ Reporting API

*To enable this feature, please contact your account manager to acquire your private hash key.

The following directions below will enable publishers to set up automated reporting scripts to receive a .CSV download of performance data based on your preferred criteria.

Reporting API URL:

Required parameters to include in your query:

Parameter Format     Description 
report_from_date= mm/dd/yyyy
  • Start date of report
report_to_date= mm/dd/yyyy
  • End date of report
username=  Aerserv Username
  • Name assigned to your account. This is the name that you use to log into your AerServ account.


  • Unique security key that will be assigned to your account. This key can be found under the SETTINGS section in your account.
report_type= canned_date
  •  By Date
  •  By Adsource 
  •  By Geo
  •  By Operating System 
  • (Optional...if included, restricts download to the given PLC. Include multiple PLCs by comma separating them – i.e. &placement=500,501,502)


  • (Optional...if included, restricts download to specific keyword. Include multiple keywords by comma separating them – i.e. &keyword=keyword1,keyword2,keyword3). 
  • This report is based on the keyword tag set up with the platform
  • This report is based on the keyword tag set up with the platform
  • This report is based on the publisher key values that has been set up within the platform
  • This will provide metrics based on publisher key value pairings
  [report id]
  • By custom report. If a publisher has created a custom report and wishes to pull this specific report using report API, the report_type will need to refer to the corresponding report ID assigned to the custom report. The report id can be retrieved when you try to edit your custom report - the ID resides at the top of the page
No_export_headers=  1
  •  Raw data
  •  CSV


There are 7 canned reports that you can select from in addition to building custom reports.  For example:

By Date (report_type=canned_date)

By Ad Source (report_type=canned_adsource)

By GEO (report_type=canned_geo)

By Operating System (report_type=canned_OS)

By Placement (report_type=canned_placement)

By All Keyword (report_type=canned_keyword)

By Custom Report (report_type=<CUSTOM REPORT ID>)<CUSTOM REPORT ID>

Custom Report ID can be found when you edit the Custom Report. Within the view, the ID is located at the top of the page called "Reporting ID"


Update Regarding Our Reporting Service

AerServ has recently implemented a throttling mechanism to the reporting service that powers the platform dashboard page, platform reporting console, and reporting APIs. To help with the overall stability of our platform AerServ implemented a threshold for each publisher account on how much data can be extracted in a 10 second duration. If there are too many simultaneous reporting queries coming from the platform or the API that exceeds our threshold during that 10 second interval, the UI will alert the publisher to try again shortly. Within the API, you will receive an error message that would look like the following:

{"error": "Request has been throttled. Publisher 214 has requested to use 30 of maximum 20 RSUs in the time range of 10s"} A status code of "429" will be returned as a response from the reporting API if the publisher has reached their reporting threshold.


Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request