Sign inGet a free API key
Menu

APIs / Apps and media / Genius

1 credit per call26 endpoints

Genius API

Get Genius data as structured JSON with one API key: search, album, album leaderboard and album page. Free credits every month.

Get a free API keyRun it below
Genius
GET/v1/genius/chart
curl "https://api.perceptlayer.com/v1/genius/chart" \
  -H "X-API-Key: $API_KEY"
cURL1 credit per successful call
Run this call below or from your dashboard to see a live response.

Playground

Run this API

cURLshell
curl "https://api.perceptlayer.com/v1/genius/chart" \
  -H "X-API-Key: $API_KEY"

Genius · 26 endpoints

Endpoints

Every endpoint takes the same key. Open one for its parameters and an example request.

EndpointRequired parametersCost
GET/v1/genius/album
id+4 optional
1 credit
GET/v1/genius/album-autocomplete
q
1 credit
GET/v1/genius/album-leaderboard
id+4 optional
1 credit
GET/v1/genius/album-page
path
1 credit
GET/v1/genius/album-tracks
id+4 optional
1 credit
GET/v1/genius/annotation
id+4 optional
1 credit
GET/v1/genius/annotation-edits
id+4 optional
1 credit
GET/v1/genius/annotation-versions
id+4 optional
1 credit
GET/v1/genius/artist
id+4 optional
1 credit
GET/v1/genius/artist-albums
id+4 optional
1 credit
GET/v1/genius/artist-autocomplete
q
1 credit
GET/v1/genius/artist-leaderboard
id+4 optional
1 credit
GET/v1/genius/artist-songs
id+4 optional
1 credit
GET/v1/genius/chart
none+5 optional
1 credit
GET/v1/genius/chart-state
modelid
1 credit
GET/v1/genius/hot
none+2 optional
1 credit
GET/v1/genius/lookup
url
1 credit
GET/v1/genius/referent
id+4 optional
1 credit
GET/v1/genius/referents
song_id+2 optional
1 credit
GET/v1/genius/referents-multi
ids
1 credit
GET/v1/genius/search
q+3 optional
1 credit
GET/v1/genius/song
id+4 optional
1 credit
GET/v1/genius/song-contributors
id+4 optional
1 credit
GET/v1/genius/song-page
path
1 credit
GET/v1/genius/song-recommendations
id+4 optional
1 credit
GET/v1/genius/videos
none+3 optional
1 credit

Overview

What you can get

The Genius API returns search, album, album leaderboard and album page as clean JSON. Each successful call costs one credit, and calls that fail are free.

Apps and mediaJSONRESTMCP

More apps and media APIs

Apple App StoreBandcampGitHubGoogle PlayProduct HuntSpotifySteam

Use cases

Pull song, album and artist data into music apps

Use the Genius API to pull song, album and artist data into music apps

Analyse annotations and how they change over time

Use the Genius API to analyse annotations and how they change over time

Track album leaderboards

Use the Genius API to track album leaderboards

FAQ

Questions

How much does the Genius API cost?

Each successful call costs one credit. New accounts get free credits every month, and credit packs bring the price down as you scale.

What format are responses in?

Every endpoint returns JSON, with no HTML parsing on your side.

Do I need a separate key for Genius?

No. One key works for every API in the catalogue.

Try the Genius API with 1,000 free credits

No credit card. Failed calls are never billed.

Get a free API keyRead the docs