Genius Search
/api/genius/search
Search Genius songs, lyrics matches, artists and albums
Scrappa's Genius API returns structured JSON from Genius, the music knowledge site. Search songs, artists and albums, read song metadata with page views and annotation counts, list artist songs and album tracks, read annotations and follow the charts. Lyrics text is not returned: song responses carry the lyrics URL and lyric flags. Scrappa is an independent service and is not affiliated with or endorsed by Genius.
Try it now
Use the first endpoint in this API family with a Scrappa API key. Every account includes 500 free monthly credits, so you can validate the response shape before buying credits.
curl -X GET "https://scrappa.co/api/genius/search?q=humble&type=song&per_page=3" \
-H "Accept: application/json" \
-H "X-API-KEY: YOUR_API_KEY"
{
"success": true,
"data": {
"sections": [
{ "type": "song", "hits": [ { "type": "song", "result": { "id": 3039923, "title": "HUMBLE.", "artist_names": "Kendrick Lamar", "stats": { "pageviews": 12358095 } } } ] }
],
"next_page": 2
},
"meta": { "endpoint_family": "search_song", "technology": "http", "billable": true }
}
Structured data for real applications. Here are some ideas.
Look up songs with artists, album, release date, page views and annotation counts.
List the songs and albums of an artist and read the artist profile with followers and IQ.
Follow the Genius song, album and artist charts by genre and time period, with page views per item.
Read annotations as plain text with votes, authors and version history.
Genius scraper API
The Genius API is built for music research, chart tracking and catalog enrichment. Song responses carry page views, annotation counts, release dates, artwork, credits and the lyrics URL. The lyrics text is not part of any response.
Search songs, lyric matches, artists and albums.
Read song, artist and album detail with page views and credits.
Follow the song, album, artist and annotation charts.
Search by song, artist or album name to get the ids for the detail endpoints.
Open Genius Search API docsPage through the song, album and artist charts by genre and time period.
Open Genius Chart API docsEverything you need in one API.
/api/genius/search
Search Genius songs, lyrics matches, artists and albums
/api/genius/song
Get a Genius song with metadata, page views and relations
/api/genius/song/page
Get a Genius song page by its path, with album tracks
/api/genius/lookup
Resolve a genius.com URL to its song, artist or album
/api/genius/song/recommendations
Get songs that Genius recommends for a song
/api/genius/song/contributors
Get the transcribers and top contributors of a song
/api/genius/artist
Get a Genius artist profile
/api/genius/artist/songs
List the songs of a Genius artist
/api/genius/artist/albums
List the albums of a Genius artist
/api/genius/artist/leaderboard
Get the top contributors of a Genius artist
/api/genius/album
Get a Genius album
/api/genius/album/page
Get a Genius album page by its path, with tracklist
/api/genius/album/tracks
Get the tracklist of a Genius album
/api/genius/album/leaderboard
Get the top contributors of a Genius album
/api/genius/artist/autocomplete
Autocomplete Genius artist names
/api/genius/album/autocomplete
Autocomplete Genius album names
/api/genius/chart
Get the Genius song, album, artist or annotation chart
/api/genius/hot
Get the trending songs on Genius
/api/genius/chart/state
Check if a Genius item is excluded from the charts
/api/genius/referents
List the annotated passages of a Genius song
/api/genius/referent
Get one annotated passage of a Genius song
/api/genius/referents/multi
Get several referents in one call
/api/genius/annotation
Get one Genius annotation
/api/genius/annotation/versions
Get the version history of a Genius annotation
/api/genius/annotation/edits
Get the edit history of a Genius annotation
/api/genius/videos
List Genius videos of an artist or album
See how Scrappa compares to the official API.
| Feature | Scrappa | SerpApi / ScraperAPI |
|---|---|---|
| Genius song metadata as JSON | Build your own parser | |
| Page views on every song and chart item | Included | Parse it yourself |
| Annotations with version history | Included | Parse it yourself |
| Price per 1k requests | From $0.20 | Varies by credits per request |
| Unified API key | Yes (80+ APIs) | Scraping only |
| Free tier | 500 credits/month | Trial credits |
No. Scrappa is an independent service and is not affiliated with or endorsed by Genius. The Genius API returns structured JSON from public Genius data through a Scrappa API key.
No. Genius lyrics are licensed content. Song responses carry the lyrics URL, lyrics_state and other flags. Annotated lyric lines are also not returned.
Every Scrappa account includes 500 free credits each month. After that, each request costs one credit, which works out to $0.20 to $0.30 per 1,000 requests depending on the credit pack or plan. Failed requests are never charged.
Request the next page number until a page has no items. Charts have no total.