Have questions? Contact Us

For sale inquiries, please call
Toll Free 866.4AD.SPEED
International +1.408.454.6363

Testimonials

I'm just writing to say your service is really remarkable. I never cease to be astonished by the level of detail provided in your elegant reports. Although I realize the primary function of your service is ad management, I find myself becoming equally dependent on the excellent web usage info.
Mark Felton
Harvard Magazine
You are the best. Every website developer I know I am going to tell about your service.
John Lansing
Trending123

Help Center Manage Your Account AdSpeed API

Publisher

Documentation for API methods to manage a publisher account.

API Version

1.2.5 (build 280809). Documentation was last modified on Sun, 07 Mar 2010 16:13:11 EST. Since the API methods and response format can change from one version to another, you should check this page frequently for updates.

API Methods - Publisher

AS.Publisher.getStats

Returns stats for the whole publisher account. Limit 50 calls/day

Parameters

metric (Required)
The type of metric can be "impressions", "clicks" or "revenue"
period (Required)
The breakdown period can be "hourly", "daily", or "monthly"

Sample Request

Sample Response

<StatRows generated="Sun, 07 Mar 2010 16:13:11 EST" title="Report: Monthly  for [Publisher] demo">
  <StatRow>
    <Monthly_Impressions>March 2010</Monthly_Impressions>
    <Unique>4,111</Unique>
    <Gross>8,101</Gross>
    <Unique_over_Gross>50.75%</Unique_over_Gross>
  </StatRow>
  <StatRow>
    <Monthly_Impressions>February 2010</Monthly_Impressions>
    <Unique>17,019</Unique>
    <Gross>33,913</Gross>
    <Unique_over_Gross>50.18%</Unique_over_Gross>
  </StatRow>
  <StatRow>
    <Monthly_Impressions>January 2010</Monthly_Impressions>
    <Unique>19,287</Unique>
    <Gross>38,729</Gross>
    <Unique_over_Gross>49.80%</Unique_over_Gross>
  </StatRow>
  <StatRow>
    <Monthly_Impressions>December 2009</Monthly_Impressions>
    <Unique>20,059</Unique>
    <Gross>40,193</Gross>
    <Unique_over_Gross>49.91%</Unique_over_Gross>
  </StatRow>
  <StatRow>
    <Monthly_Impressions>November 2009</Monthly_Impressions>
    <Unique>259,588</Unique>
    <Gross>279,547</Gross>
    <Unique_over_Gross>92.86%</Unique_over_Gross>
  </StatRow>
  <StatRow>
    <Monthly_Impressions>October 2009</Monthly_Impressions>
    <Unique>19,566</Unique>
    <Gross>39,665</Gross>
    <Unique_over_Gross>49.33%</Unique_over_Gross>
  </StatRow>
  <StatRow>
    <Monthly_Impressions>September 2009</Monthly_Impressions>
    <Unique>19,554</Unique>
    <Gross>39,343</Gross>
    <Unique_over_Gross>49.70%</Unique_over_Gross>
  </StatRow>
  <StatRow>
    <Monthly_Impressions>August 2009</Monthly_Impressions>
    <Unique>20,405</Unique>
    <Gross>41,111</Gross>
    <Unique_over_Gross>49.63%</Unique_over_Gross>
  </StatRow>
  <StatRow>
    <Monthly_Impressions>July 2009</Monthly_Impressions>
    <Unique>19,809</Unique>
    <Gross>39,811</Gross>
    <Unique_over_Gross>49.76%</Unique_over_Gross>
  </StatRow>
  <StatRow>
    <Monthly_Impressions>June 2009</Monthly_Impressions>
    <Unique>18,921</Unique>
    <Gross>37,911</Gross>
    <Unique_over_Gross>49.91%</Unique_over_Gross>
  </StatRow>
  <StatRow>
    <Monthly_Impressions>May 2009</Monthly_Impressions>
    <Unique>19,150</Unique>
    <Gross>38,682</Gross>
    <Unique_over_Gross>49.51%</Unique_over_Gross>
  </StatRow>
  <StatRow>
    <Monthly_Impressions>April 2009</Monthly_Impressions>
    <Unique>18,020</Unique>
    <Gross>36,159</Gross>
    <Unique_over_Gross>49.84%</Unique_over_Gross>
  </StatRow>
  <StatRow>
    <Monthly_Impressions>Total</Monthly_Impressions>
    <Unique>455,489</Unique>
    <Gross>673,165</Gross>
    <Unique_over_Gross>67.66%</Unique_over_Gross>
  </StatRow>
  <StatRow>
    <Monthly_Impressions>Average</Monthly_Impressions>
    <Unique>37,957</Unique>
    <Gross>56,097</Gross>
    <Unique_over_Gross>67.66%</Unique_over_Gross>
  </StatRow>
</StatRows>

AS.Publisher.getVisitorStats

Returns visitor profile stats for the whole publisher account. Limit 50 calls/day

Parameters

metric (Required)
The type of metric can be "countries", "continents", "areas", "regions", "languages", "timezones"
range (Required)
The range can be "alltime"

Sample Request

Sample Response

<StatRows generated="Sun, 07 Mar 2010 16:13:14 EST" title="Geographical report for [Publisher] demo" range="Alltime" metric="countries">
  <StatRow>
    <Rank>1</Rank>
    <Country>United States</Country>
    <Flag/>
    <Visitors>881</Visitors>
    <Percentage>61.95%</Percentage>
  </StatRow>
  <StatRow>
    <Rank>2</Rank>
    <Country>Puerto Rico</Country>
    <Flag/>
    <Visitors>392</Visitors>
    <Percentage>27.57%</Percentage>
  </StatRow>
  <StatRow>
    <Rank>3</Rank>
    <Country>Canada</Country>
    <Flag/>
    <Visitors>40</Visitors>
    <Percentage> 2.81%</Percentage>
  </StatRow>
  <StatRow>
    <Rank>4</Rank>
    <Country>Venezuela</Country>
    <Flag/>
    <Visitors>8</Visitors>
    <Percentage> 0.56%</Percentage>
  </StatRow>
  <StatRow>
    <Rank>4</Rank>
    <Country>Germany</Country>
    <Flag/>
    <Visitors>8</Visitors>
    <Percentage> 0.56%</Percentage>
  </StatRow>
  <StatRow>
    <Rank>6</Rank>
    <Country>United Kingdom</Country>
    <Flag/>
    <Visitors>7</Visitors>
    <Percentage> 0.49%</Percentage>
  </StatRow>
  <StatRow>
    <Rank>7</Rank>
    <Country>Brazil</Country>
    <Flag/>
    <Visitors>6</Visitors>
    <Percentage> 0.42%</Percentage>
  </StatRow>
  <StatRow>
    <Rank>7</Rank>
    <Country>Mexico</Country>
    <Flag/>
    <Visitors>6</Visitors>
    <Percentage> 0.42%</Percentage>
  </StatRow>
  <StatRow>
    <Rank>9</Rank>
    <Country>India</Country>
    <Flag/>
    <Visitors>4</Visitors>
    <Percentage> 0.28%</Percentage>
  </StatRow>
  <StatRow>
    <Rank>9</Rank>
    <Country>Spain</Country>
    <Flag/>
    <Visitors>4</Visitors>
    <Percentage> 0.28%</Percentage>
  </StatRow>
  <StatRow>
    <Rank>9</Rank>
    <Country>Russian Federation</Country>
    <Flag/>
    <Visitors>4</Visitors>
    <Percentage> 0.28%</Percentage>
  </StatRow>
  <StatRow>
    <Rank>9</Rank>
    <Country>China</Country>
    <Flag/>
    <Visitors>4</Visitors>
    <Percentage> 0.28%</Percentage>
  </StatRow>
  <StatRow>
    <Rank>9</Rank>
    <Country>Peru</Country>
    <Flag/>
    <Visitors>4</Visitors>
    <Percentage> 0.28%</Percentage>
  </StatRow>
  <StatRow>
    <Rank>9</Rank>
    <Country>France</Country>
    <Flag/>
    <Visitors>4</Visitors>
    <Percentage> 0.28%</Percentage>
  </StatRow>
  <StatRow>
    <Rank>15</Rank>
    <Country>Dominican Republic</Country>
    <Flag/>
    <Visitors>3</Visitors>
    <Percentage> 0.21%</Percentage>
  </StatRow>
  <StatRow>
    <Rank>15</Rank>
    <Country>Japan</Country>
    <Flag/>
    <Visitors>3</Visitors>
    <Percentage> 0.21%</Percentage>
  </StatRow>
  <StatRow>
    <Rank>15</Rank>
    <Country>Belgium</Country>
    <Flag/>
    <Visitors>3</Visitors>
    <Percentage> 0.21%</Percentage>
  </StatRow>
  <StatRow>
    <Rank>15</Rank>
    <Country>Switzerland</Country>
    <Flag/>
    <Visitors>3</Visitors>
    <Percentage> 0.21%</Percentage>
  </StatRow>
  <StatRow>
    <Rank>19</Rank>
    <Country>Netherlands</Country>
    <Flag/>
    <Visitors>2</Visitors>
    <Percentage> 0.14%</Percentage>
  </StatRow>
  <StatRow>
    <Rank>19</Rank>
    <Country>Tunisia</Country>
    <Flag/>
    <Visitors>2</Visitors>
    <Percentage> 0.14%</Percentage>
  </StatRow>
  <StatRow>
    <Rank>19</Rank>
    <Country>Poland</Country>
    <Flag/>
    <Visitors>2</Visitors>
    <Percentage> 0.14%</Percentage>
  </StatRow>
  <StatRow>
    <Rank>19</Rank>
    <Country>Argentina</Country>
    <Flag/>
    <Visitors>2</Visitors>
    <Percentage> 0.14%</Percentage>
  </StatRow>
  <StatRow>
    <Rank>19</Rank>
    <Country>Turkey</Country>
    <Flag/>
    <Visitors>2</Visitors>
    <Percentage> 0.14%</Percentage>
  </StatRow>
  <StatRow>
    <Rank>19</Rank>
    <Country>Sweden</Country>
    <Flag/>
    <Visitors>2</Visitors>
    <Percentage> 0.14%</Percentage>
  </StatRow>
  <StatRow>
    <Rank>19</Rank>
    <Country>Australia</Country>
    <Flag/>
    <Visitors>2</Visitors>
    <Percentage> 0.14%</Percentage>
  </StatRow>
  <StatRow>
    <Rank>19</Rank>
    <Country>Colombia</Country>
    <Flag/>
    <Visitors>2</Visitors>
    <Percentage> 0.14%</Percentage>
  </StatRow>
  <StatRow>
    <Rank>27</Rank>
    <Country>Iran</Country>
    <Flag/>
    <Visitors>1</Visitors>
    <Percentage> 0.07%</Percentage>
  </StatRow>
  <StatRow>
    <Rank>27</Rank>
    <Country>Romania</Country>
    <Flag/>
    <Visitors>1</Visitors>
    <Percentage> 0.07%</Percentage>
  </StatRow>
  <StatRow>
    <Rank>27</Rank>
    <Country>United Arab Emirates</Country>
    <Flag/>
    <Visitors>1</Visitors>
    <Percentage> 0.07%</Percentage>
  </StatRow>
  <StatRow>
    <Rank>27</Rank>
    <Country>Chile</Country>
    <Flag/>
    <Visitors>1</Visitors>
    <Percentage> 0.07%</Percentage>
  </StatRow>
  <StatRow>
    <Rank>27</Rank>
    <Country>Panama</Country>
    <Flag/>
    <Visitors>1</Visitors>
    <Percentage> 0.07%</Percentage>
  </StatRow>
  <StatRow>
    <Rank>27</Rank>
    <Country>Costa Rica</Country>
    <Flag/>
    <Visitors>1</Visitors>
    <Percentage> 0.07%</Percentage>
  </StatRow>
  <StatRow>
    <Rank>27</Rank>
    <Country>Luxembourg</Country>
    <Flag/>
    <Visitors>1</Visitors>
    <Percentage> 0.07%</Percentage>
  </StatRow>
  <StatRow>
    <Rank>27</Rank>
    <Country>Ukraine</Country>
    <Flag/>
    <Visitors>1</Visitors>
    <Percentage> 0.07%</Percentage>
  </StatRow>
  <StatRow>
    <Rank>27</Rank>
    <Country>Italy</Country>
    <Flag/>
    <Visitors>1</Visitors>
    <Percentage> 0.07%</Percentage>
  </StatRow>
  <StatRow>
    <Rank>27</Rank>
    <Country>Nepal</Country>
    <Flag/>
    <Visitors>1</Visitors>
    <Percentage> 0.07%</Percentage>
  </StatRow>
  <StatRow>
    <Rank>27</Rank>
    <Country>Virgin Islands, U.S.</Country>
    <Flag/>
    <Visitors>1</Visitors>
    <Percentage> 0.07%</Percentage>
  </StatRow>
  <StatRow>
    <Rank>27</Rank>
    <Country>Greece</Country>
    <Flag/>
    <Visitors>1</Visitors>
    <Percentage> 0.07%</Percentage>
  </StatRow>
  <StatRow>
    <Rank>27</Rank>
    <Country>Kenya</Country>
    <Flag/>
    <Visitors>1</Visitors>
    <Percentage> 0.07%</Percentage>
  </StatRow>
  <StatRow>
    <Rank>27</Rank>
    <Country>Bermuda</Country>
    <Flag/>
    <Visitors>1</Visitors>
    <Percentage> 0.07%</Percentage>
  </StatRow>
  <StatRow>
    <Rank>27</Rank>
    <Country>Iraq</Country>
    <Flag/>
    <Visitors>1</Visitors>
    <Percentage> 0.07%</Percentage>
  </StatRow>
  <StatRow>
    <Rank>27</Rank>
    <Country>Jamaica</Country>
    <Flag/>
    <Visitors>1</Visitors>
    <Percentage> 0.07%</Percentage>
  </StatRow>
  <StatRow>
    <Rank>27</Rank>
    <Country>New Zealand</Country>
    <Flag/>
    <Visitors>1</Visitors>
    <Percentage> 0.07%</Percentage>
  </StatRow>
  <StatRow>
    <Rank>27</Rank>
    <Country>South Africa</Country>
    <Flag/>
    <Visitors>1</Visitors>
    <Percentage> 0.07%</Percentage>
  </StatRow>
  <StatRow>
    <Rank>27</Rank>
    <Country>Indonesia</Country>
    <Flag/>
    <Visitors>1</Visitors>
    <Percentage> 0.07%</Percentage>
  </StatRow>
  <StatRow>
    <Rank>27</Rank>
    <Country>Lithuania</Country>
    <Flag/>
    <Visitors>1</Visitors>
    <Percentage> 0.07%</Percentage>
  </StatRow>
  <StatRow>
    <Rank>27</Rank>
    <Country>Philippines</Country>
    <Flag/>
    <Visitors>1</Visitors>
    <Percentage> 0.07%</Percentage>
  </StatRow>
  <StatRow>
    <Rank>27</Rank>
    <Country>Taiwan</Country>
    <Flag/>
    <Visitors>1</Visitors>
    <Percentage> 0.07%</Percentage>
  </StatRow>
</StatRows>

AdSpeed Ad Server

Home

Testimonials

Help Center Manage Your Account AdSpeed API

Publisher

API Version

API Methods - Publisher

AS.Publisher.getStats

Parameters

Sample Request

Sample Response

AS.Publisher.getVisitorStats

Parameters

Sample Request

Sample Response

Other Articles in AdSpeed API

Related Articles

Help Center

News

Blog