iHeartRadio API & Data Access

Unofficial | 👉 Official iHeartRadio Website: http://www.iheart.com | 👩‍💻 Contributors: steve


These are unofficial iHeartRadio API endpoints useful for scraping public data such as radio stations, artists, songs and more. These endpoints are made available for unofficial use and experimentation, such as for security research, use at your own risk!

These endpoints were uncovered from iHeartRadio’s iOS app using MITM proxy interception, meaning that these endpoints are unlikely to change too much as mobile clients tend to stick around in the wild for a while. Hence, it should be safe to assume these won’t change too much over the next few years.

Rate Limiting

Please be considerate when requesting data through these endpoints or iHeartRadio may block your requesting IP address. We don’t recommend exceeding one request per second per proxy.

Read Only

These endpoints are “read only” and only allow you to scrape data.

Official API

There is no known officially supported API for iHeartRadio.

Sample Data

Below is a sample JSON snippet for a song. You can also download aggregate results together in CSV format.

  "artistId": 678625,
  "albumId": 28113712,
  "trackId": 28113721,
  "title": "Love Me Harder",
  "artist": "Ariana Grande Feat. The Weeknd",
  "album": "My Everything",
  "copyright": null,
  "trackDuration": 236,
  "volumeNumber": 1,
  "trackNumber": 9,
  "version": null,
  "streamReady": true,
  "albumCalculatedType": null,
  "albumNrOfVolumes": 0,
  "popularity": 0,
  "searchScore": 1.978895,
  "imagePath": "http://image.iheart.com/ihr-ingestion-pipeline-production-umg/bypass/redelivery/NEW_CONTENT_RADIO/00602537939534_20180623113121417/00602537939534_T1_cvrart.jpg",
  "previewPath": "null/content/music/prod/UMG13/Thumb_Content/Full_PC/UMG/Aug14/082014/00602537939534/UMG_audclp_00602537939534_01_009_61.mp3",
  "lastUpdated": null,
  "sortOrder": 0,
  "artistName": "Ariana Grande Feat. The Weeknd",
  "explicitLyrics": false,
  "hotness": 0,
  "familiarity": 0,
  "lyricsId": 0,
  "score": 1.978895,
  "rank": 1518380,
  "modifyArt": false,
  "playbackRights": null,
  "recordLabel": {...},
  "externalTrackId": null