Lrclib Synced Lyrics Scraper

LRCLIB Synced Lyrics Scraper - Search Tracks and Collect Time-Synced Lyrics

Collect track metadata, plain lyrics, and time-synced lyrics from LRCLIB. Search by text or look up exact artist and track combinations, then export your results as JSON, CSV, or Excel.

Overview

LRCLIB Synced Lyrics Scraper helps you collect publicly available lyrics and synchronization data for music tracks.

Choose between text-based search and exact track lookup. Each result includes available track metadata, plain lyrics, synchronized lyric timestamps, and additional lyric information.

Features

• Track search: Find matching tracks using free-text queries.
• Exact track lookup: Retrieve a specific track using its artist and title.
• Plain lyrics: Collect available unsynchronized lyrics.
• Synced lyrics: Retrieve timestamped lyrics in LRC-style format when available.
• Track metadata: Collect artist, album, title, and duration information.
• Instrumental detection: Identify tracks marked as instrumental.
• Synchronization details: Check whether word-level synchronization is available.
• Result limits: Control the maximum number of records collected.
• Structured exports: Download results as JSON, CSV, Excel, and other supported formats.

Collection Modes

Search mode

Search for matching tracks using free-text queries. For example, search for yellow coldplay to find relevant tracks.

Exact match mode

Look up a specific track using an artist and track name. Supported query examples include:

• Coldplay - Yellow
• Yellow Coldplay

Use Cases

• Karaoke applications: Collect timestamped lyrics for karaoke and lyric synchronization projects.
• Music catalog enrichment: Add plain and synced lyrics to existing music metadata collections.
• Lyric applications: Build structured lyric datasets for music-related applications.
• Research and prototyping: Explore lyric timing and track metadata for development projects.
• Bulk track lookup: Process multiple artist and track combinations in one run.

Input Parameters

Parameter	Type	Description
mode	String	Collection mode. Use search or get.
queries	Array	Search terms or artist and track combinations.
maxItems	Integer	Maximum number of lyric records to collect. Up to 1,000 items per run.
requestDelaySecs	Number	Delay between requests in seconds.

Example Input

Search mode

{
  "mode": "search",
  "queries": [
    "yellow coldplay"
  ],
  "maxItems": 50,
  "requestDelaySecs": 1
}

Exact match mode

{
  "mode": "get",
  "queries": [
    "Coldplay - Yellow"
  ],
  "maxItems": 10,
  "requestDelaySecs": 1
}

What Data Does This Actor Extract?

Each dataset row represents a track with available lyric information.

Field	Description
lrclibId	Unique LRCLIB track identifier
name	Track name
trackName	Track title
artistName	Artist or performer name
albumName	Album or release name
duration	Track duration in seconds
instrumental	Indicates whether the track is instrumental
hasWordSync	Indicates whether word-level synchronization is available
plainLyrics	Lyrics without timestamps
syncedLyrics	Lyrics containing synchronization timestamps
lyricsfile	Additional lyric file or metadata content, when available
scraped_at	Date and time the record was collected

Some fields may be empty or unavailable depending on the track.

Example Output

{
  "lrclibId": 16232,
  "name": "Yellow",
  "trackName": "Yellow",
  "artistName": "Coldplay",
  "albumName": "Yellow - Single",
  "duration": 267.0,
  "instrumental": false,
  "hasWordSync": false,
  "plainLyrics": "Look at the stars\nLook how they shine for you\n\nAnd everything you do\n\nYeah, they were all yellow",
  "syncedLyrics": "[00:35.66] Look at the stars\n[00:38.46] Look how they shine for you\n[00:44.17] And everything you do",
  "lyricsfile": "version: '1.0'\nmetadata:\n  title: Yellow\n  artist: Coldplay",
  "scraped_at": "2026-10-26T00:00:00+00:00"
}

Working with Your Dataset

After the run finishes, open the dataset in Apify Console to review your collected track records.

You can:

• Export results as JSON, CSV, or Excel.
• Filter tracks by artist or album.
• Search for specific track names.
• Review plain and timestamped lyrics.
• Import records into music-related applications or databases.
• Use the collected metadata for further analysis and prototyping.

FAQ

Who is this actor for?

It is designed for developers, researchers, analysts, and music application teams who need structured track and lyric information.

What is the difference between plain and synced lyrics?

Plain lyrics contain text without timing information. Synced lyrics include timestamps that indicate when each lyric line should appear during playback.

What can I export?

You can export JSON, CSV, Excel, and other supported Apify dataset formats.

Can I run it on a schedule?

Yes. You can configure an Apify schedule to collect updated track information at your preferred intervals.

How many items can one run process?

You can collect up to 1,000 items per run using the maxItems setting.

Are synced lyrics available for every track?

No. Synchronization data depends on availability for each track. Some results may include plain lyrics without timestamped lyrics.

Disclaimer

This actor is an independent tool and is not affiliated with, endorsed by, sponsored by, or officially associated with LRCLIB or its owners. It collects information made publicly available through the service. Users are responsible for ensuring that their data collection and use comply with applicable laws and relevant terms.

Is Web Scraping Legal?

Collecting information that is already public is generally legal. There is no single law that bans all forms of web scraping. The limits are the usual ones: do not break into accounts, do not take private or confidential data, and be careful with personal data and copyrighted works. A site's terms can also restrict how you access it. Facts such as a public name, price, or rating are not the same thing as republishing someone's article or photo.

This actor collects information from public pages. It does not log in and it does not bypass access controls.

For a longer explanation, see Apify's article Is web scraping legal?.