Skip to main content

search lyrics on

Project description



A library to search for music lyrics.


LyricsPy can be installed using pip from PyPI or from GitHub.

via PyPI

pip install -U lyricspy

via GitHub using pip+git

pip install -U git+


Using LyricsPy is easy, but let's see some examples:

Musixmatch example

from lyricspy import Musixmatch
import json

def search_lyrics_and_translation_musixmatch(query, lang="pt", limit=1):
  # Initializes the Musixmatch class
  musixmatch = Musixmatch()
  # Note: after the 2.2.0 update the token is optional

  # Performs an automatic search to obtain the lyrics and their translations
  search_results =, lang, limit)

  # Saves the results in a JSON file for viewing
  with open("musixmatch_results.json", "w") as f:
    json.dump(search_results, f)

# Example of use

Lyrics example

from lyricspy import Lyrics

def search_lyrics_and_translation(query):
  # Initializes the Lyrics class
  lyrics = Lyrics()

  # Performs the initial search to obtain the links to the lyrics
  search_results =

  # Iterates through the search results
  for result in search_results:
    # Extracts the link to the lyrics
    lyrics_link = result["link"]

    # Performs the search for the lyrics on the page of the obtained link
    lyrics_details = lyrics.lyric(result)

    # Prints the title of the song, the lyrics, and the translation (if available)
    print(f"Title: {lyrics_details['music']}")
    print(f"Lyrics: \n{lyrics_details['lyric']}\n")
    if lyrics_details['translation']:
      print(f"Translation: \n{lyrics_details['translation']}\n")

# Example of use

Project details

Download files

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

Source Distribution

lyricspy-2.2.1.tar.gz (4.1 kB view hashes)

Uploaded Source

Built Distribution

LyricsPy-2.2.1-py3-none-any.whl (5.8 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page