lyrics.com APIlyrics.com ↗
Access song lyrics, artist biographies, album tracklists, and genre browsing from Lyrics.com via a structured JSON API with 9 endpoints.
curl -X GET 'https://api.parse.bot/scraper/559739cb-74c0-4b91-8ad0-6a4620531d3b/search_lyrics?query=hello&search_type=0' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for songs by lyrics content or title. Returns best matches and regular results with song titles, URLs, and artist information.
| Param | Type | Description |
|---|---|---|
| queryrequired | string | Search query (lyrics text or song title) |
| search_type | string | Search type: '0' for lyrics, '1' for song title, '2' for exact match |
{
"type": "object",
"fields": {
"results": "array of song result objects with title, url, artist, artist_url, and is_best_match fields"
},
"sample": {
"data": {
"results": [
{
"url": "https://www.lyrics.com/lyric/32298025/Adele/Hello",
"title": "Hello",
"artist": "Adele",
"artist_url": "https://www.lyrics.com/artist/Adele/861756",
"is_best_match": true
},
{
"url": "https://www.lyrics.com/lyric-lf/793470/The+Beatles/Hello+Goodbye",
"title": "Hello Goodbye",
"artist": "The Beatles",
"artist_url": "https://www.lyrics.com/artist/The-Beatles/3644",
"is_best_match": false
}
]
},
"status": "success"
}
}About the lyrics.com API
The Lyrics.com API exposes 9 endpoints covering full song lyrics, artist biographies, album tracklists, and genre/alphabetical browsing. The get_song_lyrics endpoint returns the complete lyrics text alongside metadata fields like year, views, genre, and credits. search_lyrics accepts both free-text lyric content and song titles, with an optional search_type parameter to control matching behavior.
Lyrics and Song Data
The get_song_lyrics endpoint accepts a song page URL and returns the full lyrics string, the song title, artist name, and a metadata object that may include year, view count, genre, style, and credits. It also returns an album object with the album name, URL, and a tracks array — making it possible to walk an entire album from a single song entry point. If the target page no longer exists, the endpoint returns a stale_input signal rather than an error.
Search and Discovery
search_lyrics supports three modes via the search_type parameter: '0' searches by lyric content, '1' by song title, and '2' for exact matches. Results include per-song title, url, artist, artist_url, and an is_best_match flag that distinguishes the top result from regular matches. search_artists works similarly for artist names, returning name and url fields for each match.
Artist and Album Endpoints
get_artist retrieves an artist's name, full album discography (with album name, URL, and year per entry), a biography string (or null if unavailable), and a similar_artists array. get_album returns the album title, artist name, and a tracks array where each track includes track_no, title, url, and duration.
Browsing Endpoints
browse_artists_by_letter accepts a letter (A–Z or #) and an optional page parameter for pagination, returning artist name/URL pairs. browse_genre accepts a genre name such as Pop, Jazz, Hip Hop, or Classical and returns songs with title, URL, artist, artist URL, and album. Note that large genres like Rock may have slower response times. get_new_lyrics and get_random_lyric require no inputs — the former returns recently submitted songs, the latter returns a random song's full lyrics and metadata.
- Build a lyrics search tool that surfaces songs by matching partial lyric text using
search_lyricswithsearch_type: '0' - Populate an artist page with biography text, similar artist suggestions, and a dated album discography from
get_artist - Generate full album tracklists with duration data using
get_albumfor playlist or music library apps - Power a genre discovery feature by iterating
browse_genreacross Jazz, Blues, Electronic, and other categories - Track recently submitted community lyrics by polling
get_new_lyricsfor fresh content - Serve a 'song of the day' or random lyrics widget using
get_random_lyricwith no required inputs - Index an artist catalog alphabetically using
browse_artists_by_letterwith paginated results
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Lyrics.com have an official developer API?+
What does `get_song_lyrics` return beyond the lyrics text?+
lyrics string, it returns title, artist, an album object (name, URL, and track list), and a metadata object that may include year, views, genre, style, and credits. Not every song has all metadata fields populated — optional fields may be absent or null.Does `search_lyrics` support searching in languages other than English?+
query parameter and returns whatever matches Lyrics.com's index, which includes non-English content. However, coverage varies significantly by language, and relevance for non-Latin scripts is not guaranteed.Does the API expose song audio previews, streaming links, or chart position data?+
Is there a known limitation with the `browse_genre` endpoint?+
browse_genre endpoint's confirmed working genre values include Pop, Jazz, Hip Hop, Blues, Latin, Reggae, Electronic, Classical, and Folk. Genres with very large catalogs, such as Rock, may return significantly slower responses. Unrecognized genre strings may return empty results.