Note: As of May 2025, this project is not actively maintained. If you've contributed before contact me and I'll happily give you maintainer status.
pitchfork
An unofficial python API for pitchfork.com reviews.
Installation
You can get it from python package index:
You can also clone the repository, but note that pitchfork depends on beautifulsoup4 for HTML parsing so you first have to install beautifulsoup4 yourself:
git clone https://github.com/michalczaplinski/pitchfork.git
cd pitchfork
pip install -r requirements.txtUsage
>> import pitchfork >> p = pitchfork.search('kanye west', 'my beautiful') # the title is autocompleted >> p.album() # the full album title u'My Beautiful Dark Twisted Fantasy' >> p.label() u'Def Jam / Roc-A-Fella' >> p.editorial()[:100] # get the first 100 characters of the review. u"Kanye West's 35-minute super-video,\xa0Runaway, peaks with a parade. Fireworks flash while red hoods ma" # the link to the album cover image >> p.cover() 'http://cdn4.pitchfork.com/albums/15935/homepage_large.831179e9.jpg' >> p.score() 10.0 # pretty overrated IMHO!
Tests
You can run the basic tests located in the tests directory with:
$ cd path/to/tests
$ python -m unittest discoverLicense
MIT
Contributions
If you want to add some new feature, suggest improvement or whatnot you're welcome to message me or send a pull request!