PyPeri makes getting data out of Periscope easy, with a sane and understandable API.

• Free software: MIT license
• Documentation: https://pyperi.readthedocs.io.

• Python 3
• Easy to understand API
• Fully tested & documented

Functionality so far:

• Get information about Users
• Get information about Broadcasts
• Get a User's Broadcast history

Periscope is pretty neat, but it's difficult to get information out of it in a programatic way. Getting answers to simple questions like: "How many broadcasts did our client do this week" is not trivial, and in-depth analysis is pretty tough. This project is an attempt to make the lives of people who dip into Digital Marketing a little better.

PyPeri attempts to do this by providing a sane interface, and hides some of the tedium of using Periscope's API. For example, Periscope makes doing simple things, like getting a list of a User's past Broadcasts a 2-step process:

1. Request a short-lived API session key from the Periscope Web Interface
2. Use the session key on the Periscope API Interface using the getUserBroadcastsPublic endpoint.

PyPeri simplifies this considerably:

>>> from pyperi import Peri
>>> pp = Peri()
>>> history = pp.get_user_broadcast_history(username='george_clinton')

Install via pip:

$ pip install pyperi

Do stuff:

>>> from pyperi import Peri
>>> pp = Peri()
>>> history = pp.get_user_broadcast_history(username='george_clinton')
>>> if history:
...     print(history[0]['status'])
#George Clinton listening to music in houston

Full documentation is available here: https://pyperi.readthedocs.io

PyPeri is free software, distributed under the MIT license.