https://github.com/michalczaplinski/pitchfork
:notes: Unofficial python API for pitchfork.com reviews.
https://github.com/michalczaplinski/pitchfork
beautifulsoup pitchfork python requests scraper
Last synced: 4 months ago
JSON representation
:notes: Unofficial python API for pitchfork.com reviews.
- Host: GitHub
- URL: https://github.com/michalczaplinski/pitchfork
- Owner: michalczaplinski
- License: mit
- Created: 2014-06-23T00:32:58.000Z (about 12 years ago)
- Default Branch: master
- Last Pushed: 2025-05-10T11:42:57.000Z (about 1 year ago)
- Last Synced: 2025-08-20T16:48:17.397Z (11 months ago)
- Topics: beautifulsoup, pitchfork, python, requests, scraper
- Language: Python
- Homepage:
- Size: 40 KB
- Stars: 74
- Watchers: 6
- Forks: 18
- Open Issues: 5
-
Metadata Files:
- Readme: README
- Changelog: CHANGES.txt
- License: LICENSE.txt
Awesome Lists containing this project
README
.. 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.
+------------------+--------------------+-----------------------+
| Build Status | Version | Downloads (30 days) |
+==================+====================+=======================+
| |Build Status| | |Latest Version| | |Downloads| |
+------------------+--------------------+-----------------------+
## Installation
You can get it from `python package
index `\_\_:
.. code:: sh
pip install pitchfork
You can also clone the repository, but note that `pitchfork` depends
on `beautifulsoup4` for HTML parsing so you first have to install
`beautifulsoup4` yourself !!!
.. code:: sh
git clone https://github.com/michalczaplinski/pitchfork.git
## Usage
.. code:: python
>> 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:
.. code:: sh
$ 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!
.. |Build Status| image:: https://travis-ci.org/michalczaplinski/pitchfork.svg?branch=master
:target: https://travis-ci.org/michalczaplinski/pitchfork
.. |Latest Version| image:: https://pypip.in/v/pitchfork/badge.png
:target: https://pypi.python.org/pypi/pitchfork/
.. |Downloads| image:: https://pypip.in/download/pitchfork/badge.png
:target: https://pypi.python.org/pypi/pitchfork/