Publisher Report API Documentation

Please note that this feature requires a unique API key and password. Please contact your account representative for more information.

Introduction

Content.ad offers this REST API to make the data in the Widget Summary Report in a publisher’s account login available in either XML or JSON format.

Implementation FAQ

How often is performance data updated?
Performance reports are updated by Content.ad once per hour.

How long can I run the report for?
This report can be run for any period 31 days or less. You can use the “startDate” and “endDate” parameters to specify a date range.

How is reporting data grouped?
This report can group data by hour or day and groups performance by domain and widget. See the “Optional Query String Parameters” section below for more information.

Setting Up the API Call

Place the desired parameters into the API call below.

https://rest.content.ad/reports/publisher

Optional Query String Parameters

Example XML Result Set

<Report xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
 <Domains>
  <Domain>
   <ID>00001</ID>
   <Name>http://example.com</Name>
   <Widgets>
    <Widget>
     <Guid>00000x00-1yyy-222z-33a3-bbb444bb4444</Guid>
     <Description>Widget 1</Description>
     <Dates>
      <Date>
       <Time>2014-05-01T07:00:00-07:00</Time>
       <Impressions>14400</Impressions>
       <CTR>2.3000</CTR>
       <ECPM>1.2000</ECPM>
       <ECPA>0.5000</ECPA>
       <ClicksPaid>180</ClicksPaid>
       <ClicksInternal>151</ClicksInternal>
       <Revenue>17.28</Revenue>
      </Date>
      <Date>
       <Time>2014-05-01T08:00:00-07:00</Time>
       <Impressions>14400</Impressions>
       <CTR>2.3000</CTR>
       <ECPM>1.2000</ECPM>
       <ECPA>0.5000</ECPA>
       <ClicksPaid>180</ClicksPaid>
       <ClicksInternal>151</ClicksInternal>
       <Revenue>17.28</Revenue>
      </Date>
     </Dates>
    </Widget>
   </Widgets>
  </Domain>
 </Domains>
</Report>