mixpanel-data-export

A wrapper for Mixpanel's data export API. Simply instantiate the class with your API secret and key and then make calls to api methods and get json back.

Mixpanel Data Export (v 1.6.2)

Simply put, this is a JavaScript library that makes Mixpanel's data export API easy to use. Simply instantiate the class with your API secret and key and then make calls to api methods and get correctly formatted data back via a promise or callback.

Do

npm install mixpanel-data-export --save

then

var MixpanelExport = require('mixpanel-data-export');

You'll have to host the library yourself, so:

<script src="your/path/to/mixpanel_data_export.min.js"></script>

Every method detailed on mixpanel's data export api page is available in the library. However, some of the namings have been adjusted to read more semantically, for example, topEventProperties , and eventPropertyValues.

The full list of methods is as follows:

  • export(parameters) (node only, see: https://github.com/michaelcarter/mixpanel-data-export-js/issues/3)
  • engage(parameters) (node only, see: https://github.com/michaelcarter/mixpanel-data-export-js/issues/6)
  • annotations(parameters)
  • createAnnotation(parameters)
  • updateAnnotation(parameters)
  • events(parameters)
  • topEvents(parameters)
  • eventNames(parameters)
  • eventProperties(parameters)
  • topEventProperties(parameters)
  • eventPropertyValues(parameters)
  • funnels(parameters)
  • listFunnels(parameters)
  • segmentation(parameters)
  • numericSegmentation(parameters)
  • sumSegmentation(parameters)
  • averageSegmentation(parameters)
  • retention(parameters)
  • addiction(parameters)

An example usage might be:

panel = new MixpanelExport({
  api_key: "my_api_key",
  api_secret: "my_api_secret"
});
 
panel.retention({
  from_date: "2014-02-28",
  to_date: "2014-03-10",
  born_event: "Rendering items"
}).then(function(data) {
  console.log(data);
});

Callbacks are also supported:

panel = new MixpanelExport({
  api_key: "my_api_key",
  api_secret: "my_api_secret"
});
 
result = panel.retention({
  from_date: "2014-02-28",
  to_date: "2014-03-10",
  born_event: "Rendering items"
}, function(data) {
  console.log(data);
});

A full list of available API methods is detailed on mixpanel's data export api page. If you find any that are missing please let me know, or better yet put in a pull request.

  • CSV Formatted JSONP responses cause errors in Browser.