Use Periscope with Python.
Project description
PyPeri
PyPeri makes getting data out of Periscope easy, with a sane and understandable API.
Free software: MIT license
Documentation: https://pyperi.readthedocs.io.
Features
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
About
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:
Request a short-lived API session key from the Periscope Web Interface
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: https://pyperi.readthedocs.io
License
PyPeri is free software, distributed under the MIT license.
History
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
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for pyperi-0.2.0-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | e99148390fd2196e079bd755c3c459a6b0dbaae1c17d204d2d11cc8466f16032 |
|
MD5 | b96cf04465df5f84c7cc46718048bb7f |
|
BLAKE2b-256 | 6974f8d8a0b49f6760b0a2d5e566ddcff37acc44abea9f7875fe42d3e09e6a1a |