Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Python module for collecting data from rap songs.

Project Description


Want to use data from rap songs in your Python scripts but bummed that there’s no API to do so? Well guess what? NOW U CAN, DAWG.

Welcome to PyGenius.

All functions should be run through the file, or any other script you create.

Functions currently available artists.albumList(artist, arg) Returns a list of albums that the specified artist has recorded. If second argument is set as ‘links’, the links to the albums will be returned.

artists.getDates(artist) Returns a list of albums recorded by a specific artist, as well as the release year.

artists.getAlbumData(artist, album) Returns the metadata about an album: description, track numbers, and track names.

artists.getArtistBio(artist) Returns an artist’s bio.

artists.getPopularSongs(artist, arg) Returns the most popular songs by a specified artist. If the optional second argument is ‘link’, will return links to songs that can be passed in to other functions.

wordsearch.searchWords(keyword, arg) Returns results for a key word search. Default return is artist and song name, but if the optional second argument is set to ‘link’, a link to the song is returned.

songs.searchSong(artist, title, arg) Returns lyrics for a specified song title. If the optional third argument is set to ‘lyrics’, only the lyrics will be returned; if it’s ‘link’, only links to each lyric’s annotations are returned (and can be passed into the searchAnnotations function); otherwise, both are returned by default.

songs.searchAnnotations(query) Will return content of a specified annotation link, including HTML links to pictures, videos and GIFs, as well as links to external sites referenced.

songs.findAllSongs(artist, arg) Will return all songs attributed to the specified artist. If second argument is specified as ‘links’, will return the links to the songs; if ‘titles’, will return the song titles; otherwise, will return both by default.

Release History

Release History

This version
History Node


History Node


History Node


Download Files

Download Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
pygenius-2.0.tar.gz (4.7 kB) Copy SHA256 Checksum SHA256 Source Jul 15, 2014

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting