AerServ Reporting API


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


How to Enable

To enable this feature, please generate your API Key access token in the Account Settings section within the AerServ | InMobi platform. 




How to Access

Reporting API URL:


Please note: This service will only allow publisher to run reports up to 31 days.


Required parameters to include in your query:

Parameter Format     Description 
start_date yyyy-mm-dd
  • Start date of report
end_date yyyy-mm-dd
  • End date of report
  • 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 Ad Source 
  •  By Geo
  •  By Operating System 
  • By Placement
  • 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
  • By Private Marketplace (PMP)
  [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
include_header TRUE
  • Include header labels
  •  Remove header labels


Available Reports

There are 8 canned reports that you can select from in addition to building custom reports.  


By Date (report_type=canned_date):


By Ad Source (report_type=canned_adsource):


By App (report_type=canned_app):


By GEO (report_type=canned_geo):


By Operating System (report_type=canned_OS):


By Placement (report_type=canned_placement):


By PubKeys (report_type=canned_pubkeys):


By Private Marketplace (report_type=canned_pmp):


By Custom Report (report_type=<CUSTOM REPORT ID>):<customreportID>&include_header=true


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