Skip to main content

Use Periscope with Python.

Project description


PyPeri makes getting data out of Periscope easy, with a sane and understandable API. Documentation Status Updates 'Stories in Ready'


  • 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')

Quick start

Install via pip:

$ pip install pyperi

Do stuff:

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

Full documentation is available here:


PyPeri is free software, distributed under the MIT license.


0.2.0 (2016-12-23)

  • URL parsing with parse_periscope_url
  • Get a User’s Broadcast history with get_user_broadcast_history
  • Rename PyPeri class to Peri

0.1.0 (2016-12-12)

  • First release on PyPI.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
pyperi-0.2.0-py2.py3-none-any.whl (6.6 kB) Copy SHA256 hash SHA256 Wheel 3.5
pyperi-0.2.0.tar.gz (112.1 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page