pylyrical_api - lyrics API scraping from genius.com

To self-host, you need to get an API token from the api client page. You can then add the API token to a ".env" file. Example: GENIUS_API_TOKEN="T0K3N"

• API endpoint: /lyrics
• Acceptable parameters: q
  • Example: /lyrics?q=how+do+i+make+you+love+me+the+weeknd

Responses

• 200

{ "artists": "", "lyrics": "", "source": "", "status": "200", "title": "" }

• 400

{ "exception": "NoParameter", "message": "Missing parameter 'q'.", "status": "400" }

• 404

{ "exception": "NoResults", "message": "'' did not give any results, Please try a different term.", "status": "404" }

• 500

{ "exception": "ScrapeError", "message": "", "status": "500" }

• 502

{ "exception": "RequestConnectionError", "message": "", "status": "502" }

• NoParameter: Occurs when no parameter was given.
  • Returns status code 400.
• NoResults: Occurs when no results were found.
  • Returns status code 404.
• ScrapeError: Occurs when pylyrical cannot scrape lyrics from genius.com
  • Returns status code 500.
• RequestConnectionError: Occurs when pylyrical cannot send a request to genius.com
  • Returns status code 502.