Skip to main content

pitchfork-api

An unofficial python API for pitchfork.com reviews.

Build Status

Version

Python Versions

Build Status

Latest Version

Py Versions

Apologies for the confusing naming - pypi doesn’t allow the use of underscores in package names, while python doesn’t allow dashes in module names. As a result, the package name is pitchfork-api, but it is pitchfork_api everywhere else.

Installation

You can get it from python package index:

pip install pitchfork-api

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/tejassharma96/pitchfork_api

Usage

>> 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

# to check what methods are available, you can use 'methods()'
>> p.methods()
score()
abstract()
editorial()
full_text()
cover()
artist()
album()
label()
year()

Tests

You can run the basic tests located in the tests directory with:

$ cd pitchfork
$ python3 -m unittest discover

License

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!

Metadata

Release files for pitchfork-api 0.0.4

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pitchfork-api 0.0.4
File Size Uploaded
pitchfork_api-0.0.4.tar.gz 6.5 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for pitchfork-api 0.0.4
File Interpreter ABI Platform
pitchfork_api-0.0.4-py3-none-any.whl Python 3 none any Details

Total release size: 16.7 kB

Release files / pitchfork_api-0.0.4.tar.gz

Download URL pitchfork_api-0.0.4.tar.gz
Size 6.5 kB
Tags Source
SHA-256 checksum
How to use checksums
221021dde465e7faf53ea868b155dc3536d8c1b1e5a18b15e3d332f087607af3
BLAKE2b-256 checksum
How to use checksums
c080266d50439b24c93502dc942f496f6517d82049c39e604cca56aae2ded7b2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/1.11.0 pkginfo/1.4.2 requests/2.18.4 setuptools/40.0.0 requests-toolbelt/0.8.0 tqdm/4.24.0 CPython/3.6.2

Release files / pitchfork_api-0.0.4-py3-none-any.whl

Download URL pitchfork_api-0.0.4-py3-none-any.whl
Size 10.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
207dd1b562fbea8b7af3743aa70e4b44b43fc9bcb7e876462b62d87fca3019fc
BLAKE2b-256 checksum
How to use checksums
25d99a2a8f26a3d9994e9e3334d425b3cf40719c6080970e122781b84d208ea3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/1.11.0 pkginfo/1.4.2 requests/2.18.4 setuptools/40.0.0 requests-toolbelt/0.8.0 tqdm/4.24.0 CPython/3.6.2

Release history Release notifications | RSS feed

This release

0.0.4 This release

2 release files

0.0.3

2 release files

0.0.2

2 release files

0.0.1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page