About this call

Provides the value for a given measure or a given period of time. For example, it can provide total visitors at various points over the past day, or it can provide the number of visitors who arrived from google.com over the past week. If you want to know about the performance of all pages or all referrers in a given day, use day_data_series.

Status: Deprecated

 We are deprecating this API endpoint in favor of a new one. We will have a new endpoint ASAP, and remove support for this endpoint shortly after.

Format

http://api.chartbeat.com/historical/dashapi/data_series/?host=[host]&apikey=[apikey]&timestamp=[timestamp]
&days=[days]&minutes=[minutes]&type=[type]&val=[val]&jsonp=[jsonp] 
   

• host - Required.  The domain name to get the snapshot for.

• apikey - Required.  An api key generated here that gives access to this call.

• timestamp - Optional.  Unix timestamp.  The time to start the series from. Defaults to midnight Eastern Time in the US. Data prior to the last 30 days is not available.

• days - Required. The number of days of data to return.  Behavior is only guaranteed at this point for values of 1, 7, or 30. 

• minutes - Required. The number of minutes to aggregate over when returning values. For example, rather than getting back 2,000 values for every 5 minutes in a week, minutes=20 will return the average (or in some cases an arbitrary sample) from the 500 20-minute periods.

• type -  Required. The type of data to return. Possible values are summary, perf, and traffic.

• val - Optional. Specifies what to return for summary type. For summary, provide a list of comma-delimited keys into the summary field of the pages response, e.g. people or new,people

• jsonp - Optional.  Give the name of a function to wrap the return data in. Learn more here

Example

http://api.chartbeat.com/historical/data_series/?days=1&minutes=20&host=avc.com&apikey=317a25eccba186e0f6b558f45214c0e7&type=summary&val=people

Example return:

All requests return a dictionary of parallel arrays. The dictionary will always contain an array dates of timestamps. The other elements depend on the request, but may be path (for path requests), referrer (for referrer requests), whatever key names are supplied (for summary requests), or domload and srvload (for perf requests).

{"dates": [1275890400.0, 1275897600.0, 1275904800.0, ...],

 "people": [43, 45, 33, ... ]}