| 
  • If you are citizen of an European Union member nation, you may not use this service unless you are at least 16 years old.

  • Work with all your cloud files (Drive, Dropbox, and Slack and Gmail attachments) and documents (Google Docs, Sheets, and Notion) in one place. Try Dokkio (from the makers of PBworks) for free. Now available on the web, Mac, Windows, and as a Chrome extension!

View
 

FrontPage

Page history last edited by Etan Zapinsky 9 years, 2 months ago

About this API


 

This API Documentation is deprecated and will be removed shortly. If you want to see the new Chartbeat Documentation go to http://chartbeat.com/docs/api/

 

chartbeat is a real-time analytics service, which provides an interface for viewing what users on your site are doing right now, as well as providing historical context. The entire service is built on top of API's which you can use to access and repurpose the data we collect. You must be an active subscriber of chartbeat to use the API; sign up here.

 

We expose this data through a series of calls that return JSON.  We currently only return JSON data because it's simple, easily readible, concise, and easy to parse in Javascript.  To find out more about JSON, visit json.org/

All calls require an API key. You can obtain and manage your keys at chartbeat.com/apikeys.

 

Bugs/Feature Requests/Suggestions

http://support.chartbeat.com/

 

Help/Discussion

http://groups.google.com/group/chartbeat/

 

API Calls


 

Real-time API calls

 

  • histogram - Receive numerical data, summarized by ranges. 
  • pathsummary - Return specified data about all paths (urls) on a domain.
  • quickstats - Summarizes the current state of an entire domain or domain + path.  The number of people on a page, reading, writing, idle, etc...
  • recent - Information about the most recent visitors to a page. 
  • referrers - Information about referrer domains to a site. 
  • summary - Returns summary information about specific variables. 
  • toppages - Returns a list of pages, ordered by which ones have most visitors right now.
  • geo - Geographical visitor data. 

 

Historical API calls

 

  • alerts - A list of alerts that have been fired for a given domain.
  • snapshots [deprecated] - Historical data.  Returns a snapshot of what the real-time data was at a given timestamp.
  • stats [deprecated] - Returns the min/max/avgs of historical data for the last month.
  • data_series [deprecated] - Returns the value for a given measure (people, returning, reading, performance, a particular page or referrer, etc.) over a period of time.
  • day_data_series [deprecated] - Returns the behavior of top pages or top referring domains over a given 24-hour period.

 

Use cases


 

You want to display how many people are on a page or your entire site -> quickstats

You want to display information about the last 10 visitors to your site -> recent

You want to show a graph of how long users have been on your site -> histogram

You want a summary of how many people are writing on each page -> pathsummary

You want to show your historical uptime information -> uptime

You want to keep a record of all the alerts sent to you -> alerts

 

Or you can use one of our pre-built site widgets, located here!

 

Examples


 

You can find example usage in our Labs examples and the source for our site widgets

 

 

API Terms and Conditions


 

Please review the API Terms and Conditions before use.

Comments (0)

You don't have permission to comment on this page.