akashrchandran

spotify-lyrics-api: Fetch Spotify Track Lyrics Through an API

A PHP API and Composer package that retrieves Spotify track lyrics powered by Musixmatch, including line-synced lyrics and plain text formats. It is aimed at developers who want to self-host lyric retrieval and can provide a Spotify SP_DC cookie.

View on GitHub Compare
Stars
638
Forks
54
Stars, last 30 days
+5
Last commit
10 months ago
Contributors
2

Our take

Quietno commits in the last 90 days

Health score

21/100

How it is scored
Activity
33
Community
11
Issues
21
Pull requests
20

+5 stars in the last 30 days

  • Fewer contributors than 86% of the projects we track

This is a focused way to retrieve Spotify lyrics in PHP, but its quiet recent development and reliance on one primary contributor make it important to verify that it meets your operational and licensing needs.

Good fit if

  • You need Spotify lyric retrieval in a PHP application or a self-hosted API.
  • You can supply an SP_DC cookie and accept the project's stated Spotify terms-of-service risk.
  • You want the available line-synced data or its LRC, SRT, and plain-text formats.

Look elsewhere if

  • You need a supported public service rather than deploying and maintaining your own instance.
  • You require active recent maintenance: the project has had no commits in the last 90 days, and no issues or pull requests were closed or merged during that period.
  • You need a contributor base broader than this project has, or cannot accept the licensing terms after resolving the README and repository license discrepancy.
All health signals
Last commit2025-12-30 (10 months ago)
Commits, last 90 days0
Releases, last 12 months2 (latest v2.2.0, 2025-12-30)
Contributors2 (top contributor: 99% of commits)
Issues closed, last 90 days0
Pull requests merged, last 90 days0
Project age4 years

Checked on 2026-10-13 with the GitHub API.

Project history

Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.

Selected snapshot

Stars

641

Forks

55

Change since Nov 15, 2026: 0 stars·0 forks

Overview

spotify-lyrics-api retrieves lyrics for a Spotify track using its track ID or URL, with Musixmatch providing the lyric data. It returns synced or unsynced lyrics and can format results as ID3-style data, LRC, SRT, or plain text.

The project can run as a small HTTP service or be included in a PHP application through Composer. It is a self-hosted option rather than a hosted public API, and requires an SP_DC cookie.

Key Features

  • Accepts a Spotify track ID or track URL through GET query parameters.
  • Returns line-synced or unsynced lyric data with timing information where available.
  • Offers id3, lrc, srt, and raw response formats.
  • Provides a PHP package interface for retrieving and formatting lyrics.
  • Supports deployment with Docker and local PHP development.
  • Reports errors for missing input and unavailable lyrics.

Use Cases

  • A PHP application can retrieve lyrics for a Spotify track and display them alongside playback.
  • A self-hosting developer can run the Docker image to provide a private lyrics endpoint for their own tools.
  • A developer building a lyric player can use timed lines to synchronize text with a track.
  • A command-line or media workflow can consume LRC, SRT, or plain-text output instead of parsing the API response itself.

What you need

Detected in the repository

  • PHP (from composer.json)
  • A Dockerfile, so it can run in a container
  • Automated checks on GitHub Actions

License in plain words

GPL-3.0strong copyleft

  • Commercial use: yes
  • Modify and redistribute: yes
  • You must keep: the license notice
  • Share your changes: yes, the full source of anything you distribute that includes it, under the GPL
  • Includes an explicit patent grant from the contributors:

A summary, not legal advice: the LICENSE file is what applies.

Getting Started

Run the Docker image with your SP_DC cookie:

docker run -d -p 8080:8080 -e SP_DC=your_sp_dc_cookie akashrchandran/spotify-lyrics-api

Then request http://localhost:8080/?trackid=YOUR_TRACK_ID. See the README for response formats, Composer usage, and deployment details.

Considerations

The API requires an SP_DC cookie, and the README warns that the project may conflict with Spotify's terms of service. The README describes support for track IDs or links only, and notes that Spotify currently provides line-synced lyrics rather than word-synced lyrics.

Development is quiet, with no commits in the last 90 days. Although there have been releases within the past year, nearly all contribution activity comes from one person, and no issues or pull requests were closed or merged in that period. Also check the license before adopting: repository metadata lists GPL-3.0, while the README's license header refers to the GNU Affero General Public License version 3 or later.

Found this useful?

Share it with someone who would like spotify-lyrics-api.