Genius Lyrics & Songs Scraper

Scrape Genius.com — the world's biggest song lyrics and music-knowledge platform. Pull trending chart songs, full lyrics, artist profiles, album tracklists, editorial videos/articles, community user profiles, and crowd-sourced lyric annotations. No Genius API key or login required.

What this actor does

• Five modes: trending (homepage/genre charts), search (songs, artists, albums, videos, articles, users, or lyric-content search), artistSongs (an artist's top tracks), byUrl, and byId (fetch specific songs directly)
• Full lyrics for every song, plus album, genre tags, producer/writer credits, streaming links (YouTube, Spotify, SoundCloud, Apple Music), and release date
• Artist profiles with bio, follower count, and social links (Twitter/X, Instagram, Facebook, TikTok, Snapchat, Spotify, SoundCloud, Apple Music, YouTube, website, and more)
• Crowd-sourced lyric annotations — the community explanations shown in Genius's highlighted-lyric popups
• Empty fields are omitted from every record — you'll never see null or empty-string values in the output

Output per record

Every record carries recordType (one of song, artist, album, video, article, user) and scrapedAt (ISO timestamp). Fields not resolvable for a given record are simply omitted.

Song records (trending, search with searchType=song/lyric, artistSongs, byUrl, byId)

• songId, title, artistName, artistId
• releaseDate, imageUrl, songUrl
• lyrics — full lyrics text (when includeLyrics is enabled)
• pageViews, annotationCount, pyongsCount (Genius's own like/upvote count)
• hot, instrumental, lyricsState (complete, incomplete, unreleased, ...)
• featuredArtists[]
• album — { name, url }
• genreTags[], producerArtists[], writerArtists[]
• youtubeUrl, spotifyUrl, soundcloudUrl, appleMusicUrl
• language, explicit, description
• annotations[] — { fragment, annotationText, authorName, votesTotal, annotationUrl } (when includeAnnotations is enabled and the song has community annotations)

Artist records (search with searchType=artist, or the bonus profile record in artistSongs)

• artistId, artistName, slug, artistUrl
• imageUrl, headerImageUrl
• verified, iq (Genius reputation score)
• followersCount, bio, alternateNames[], translationArtist
• twitterUrl, instagramUrl, facebookUrl, tiktokUrl, snapchatUrl
• spotifyUrl, soundcloudUrl, appleMusicUrl, youtubeUrl, amazonMusicUrl, shazamUrl, tidalUrl, websiteUrl

Album records (search with searchType=album)

• albumId, albumName, artistName, artistId
• coverUrl, headerImageUrl, albumUrl, releaseDate
• description, language, albumType
• pyongsCount, commentCount, trackCount
• tracklist[] — { position, title, songUrl }

Video records (search with searchType=video)

• videoId, title, videoUrl, articleUrl
• description, posterUrl, durationSeconds, viewCount
• publishedAt, authorName

Article records (search with searchType=article)

• articleId, title, articleUrl, description
• articleType, previewImageUrl
• pyongsCount, votesTotal, publishedAt, authorName

User records (search with searchType=user)

• userId, username, displayName, userUrl
• aboutMe, role, avatarUrl
• iq, verified

Input

Field	Type	Default	Description
mode	select	trending	trending / search / artistSongs / byUrl / byId
chartGenre	select	all	Genre filter for trending charts: all, pop, rap, electronic, rock, country, rb (mode=trending)
timePeriod	select	day	Time window for trending charts: day, week, month, all_time (mode=trending)
searchQuery	string	–	Search term (mode=search)
searchType	select	song	song / artist / album / video / article / user / lyric (find songs by lyric content) (mode=search)
artistName	string	–	Artist name to fetch top songs for (mode=artistSongs)
artistSongsSort	select	popularity	popularity / title / release_date (mode=artistSongs)
songUrls	array	[]	Genius song page URLs to fetch (mode=byUrl)
songIds	array	[]	Genius numeric song IDs to fetch (mode=byId)
includeLyrics	boolean	true	Fetch full lyrics text for each song
includeArtistDetails	boolean	true	Fetch full artist profile — bio, followers, social links (mode=search with searchType=artist, and mode=artistSongs)
includeAlbumDetails	boolean	true	Fetch full album details and tracklist (mode=search with searchType=album)
includeAnnotations	boolean	false	Fetch crowd-sourced lyric-fragment annotations for song records (any mode)
maxItems	integer	20	Maximum number of records to return (1–500)
proxy	object	Residential	Apify Proxy configuration (residential required — see FAQ)

Example: today's trending pop songs

{
  "mode": "trending",
  "chartGenre": "pop",
  "timePeriod": "day",
  "maxItems": 25
}

Example: search for songs with full lyrics

{
  "mode": "search",
  "searchQuery": "bohemian rhapsody",
  "searchType": "song",
  "includeLyrics": true,
  "maxItems": 10
}

Example: an artist's top tracks with profile

{
  "mode": "artistSongs",
  "artistName": "queen",
  "artistSongsSort": "popularity",
  "includeArtistDetails": true,
  "maxItems": 20
}

Example: fetch specific songs by URL with annotations

{
  "mode": "byUrl",
  "songUrls": ["https://genius.com/Queen-bohemian-rhapsody-lyrics"],
  "includeLyrics": true,
  "includeAnnotations": true
}

Use cases

• Lyrics apps & karaoke tools — bulk-import full lyrics with structured metadata
• Music trend tracking — monitor daily/weekly/monthly genre charts for A&R or playlist curation
• Artist research — pull discographies, follower counts, and social links for outreach or fan analytics
• NLP & text mining — build lyric datasets for sentiment analysis, genre classification, or generative models
• Music journalism — surface editorial videos/articles and crowd annotations for a song or artist
• Recommendation engines — feed genre tags, producer/writer credits, and album data into a music recommender

FAQ

Do I need a Genius API key or account? No. This actor works without any Genius account, login, or API key.

Are lyrics included by default? Yes, includeLyrics defaults to true. Set it to false to skip lyrics and return metadata only, which is faster.

How do I find a Genius song ID? Run mode=search first and read the songId field from the results, or open a song's page on Genius and note the numeric ID shown in its genius.com/songs/{id} link.

Why are some songs missing lyrics? Genius marks certain tracks as instrumental, or the lyrics haven't been transcribed by the community yet — lyricsState on the song record reflects this.

What's the difference between searchType=song and searchType=lyric? song matches by title or artist name; lyric matches songs by the actual words in the lyrics, which is useful when you only remember a line and not the title.

How many results can I get for albums, videos, articles, users, or lyric search? Those search types are capped at 5 results per run by Genius's own search system, regardless of maxItems. Song search and other modes are not capped this way.

Does artistSongs mode include the artist's profile? Yes — when includeArtistDetails is true (default), one extra artist profile record is added alongside the song records; it does not count against maxItems, which governs the song count.

Why is residential proxy required? Genius.com blocks Apify's default/datacenter IP ranges with an HTTP 403 error. A residential proxy is pre-configured as the default input so the actor works reliably out of the box.

Is this actor affiliated with Genius? No, this is an independent third-party actor that reads publicly accessible Genius.com pages and endpoints. It is not affiliated with or endorsed by Genius.