Sign inGet a free API key
Menu

APIs / Apps and media / Genius

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 keySee all 26 endpoints
26endpoints
1credit per successful call
JSONevery response
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 from your dashboard to see a live response.

Genius · 26 endpoints

Endpoints

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

EndpointWhat it returnsCost
GET/v1/genius/albumAlbum 1 credit
GET/v1/genius/album-autocompleteAlbum Autocomplete 1 credit
GET/v1/genius/album-leaderboardAlbum Leaderboard 1 credit
GET/v1/genius/album-pageAlbum Page 1 credit
GET/v1/genius/album-tracksAlbum Tracks 1 credit
GET/v1/genius/annotationAnnotation 1 credit
GET/v1/genius/annotation-editsAnnotation Edits 1 credit
GET/v1/genius/annotation-versionsAnnotation Versions 1 credit
GET/v1/genius/artistArtist 1 credit
GET/v1/genius/artist-albumsArtist Albums 1 credit
GET/v1/genius/artist-autocompleteArtist Autocomplete 1 credit
GET/v1/genius/artist-leaderboardArtist Leaderboard 1 credit
GET/v1/genius/artist-songsArtist Songs 1 credit
GET/v1/genius/chartChart 1 credit
GET/v1/genius/chart-stateChart State 1 credit
GET/v1/genius/hotHot 1 credit
GET/v1/genius/lookupLookup 1 credit
GET/v1/genius/referentReferent 1 credit
GET/v1/genius/referentsReferents 1 credit
GET/v1/genius/referents-multiReferents Multi 1 credit
GET/v1/genius/searchSearch 1 credit
GET/v1/genius/songSong 1 credit
GET/v1/genius/song-contributorsSong Contributors 1 credit
GET/v1/genius/song-pageSong Page 1 credit
GET/v1/genius/song-recommendationsSong Recommendations 1 credit
GET/v1/genius/videosVideos 1 credit

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.

Use cases

  • Follow rankings, ratings and releases
  • Analyse reviews for product feedback
  • Research competitors in your category

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.

Related

Apple App StoreBandcampGitHubGoogle PlayProduct HuntSpotifySteam

Try the Genius API with 1,000 free credits

No card and no password. We email you a sign-in link, and your key works on every API.

Get a free API keyRead the docs

No credit card. 1,000 free credits a month.