This is a Python API Client for Localytics Raw Data Export. It allows to export all events and sessions captured by Localytics. Data is written in JSON and available on hourly basis as log files.

The client is currently best installed via Pypi:

    $ pip install localytics

Let's have a walk through the functionalities through a couple of examples. Start by loading the library.

    >>> from localytics import Localytics

In order for you to download Localytics events, you need to authenticate with using api_key and api_secret. Once you supply it, it will be used throughout the entire session.

    >>> l = Localytics(api_key = 'XXXXX', api_secret= 'YYYYY')

There is a method download_data that downloads data to local folder. Example shows how to export data for last 2 days:

    >>> l.download_data(
            app_ids = ['AAAAA', 'BBBBB'],
            start_date = datetime.today() - timedelta(2),
            end_date = datetime.today()
        )

You can also specify optional parameters. This is more complex example:

    >>> l.download_data(
        app_ids = ['AAAAA', 'BBBBB'],
        start_date = datetime.today() - timedelta(2),
        end_date = datetime.today(),
        destination_folder = 'data',
        compressed=True
    )

On default data are stored in localytics_data folder and compressed in gz format. Please set compressed = False if you want to store data decompressed.

Contributions and bug reports are only acceptable as GitHub Pull Requests and issues. Thanks!