Skip to main content

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!

Download files

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

Source Distribution

pitchfork_api-0.0.4.tar.gz (6.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

pitchfork_api-0.0.4-py3-none-any.whl (10.2 kB view details)

Uploaded Python 3

File details

Details for the file pitchfork_api-0.0.4.tar.gz.

File metadata

  • Download URL: pitchfork_api-0.0.4.tar.gz
  • Upload date:
  • Size: 6.5 kB
  • Tags: Source
  • Uploaded using 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

File hashes

Hashes for pitchfork_api-0.0.4.tar.gz
Algorithm Hash digest
SHA256 221021dde465e7faf53ea868b155dc3536d8c1b1e5a18b15e3d332f087607af3
MD5 5edd7ddac7960332cefbf45fbb704ff3
BLAKE2b-256 c080266d50439b24c93502dc942f496f6517d82049c39e604cca56aae2ded7b2

See more details on using hashes here.

File details

Details for the file pitchfork_api-0.0.4-py3-none-any.whl.

File metadata

  • Download URL: pitchfork_api-0.0.4-py3-none-any.whl
  • Upload date:
  • Size: 10.2 kB
  • Tags: Python 3
  • Uploaded using 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

File hashes

Hashes for pitchfork_api-0.0.4-py3-none-any.whl
Algorithm Hash digest
SHA256 207dd1b562fbea8b7af3743aa70e4b44b43fc9bcb7e876462b62d87fca3019fc
MD5 90aeda48a57ffe76b6f83aa9961ec2d4
BLAKE2b-256 25d99a2a8f26a3d9994e9e3334d425b3cf40719c6080970e122781b84d208ea3

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

0.0.4 This release

2 files

0.0.3

2 files

0.0.2

2 files

0.0.1

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page