radiojavanapi is a Python library and wrapper for RadioJavan's API, enabling developers to create bots, streaming applications, download tools, and automation scripts with minimal effort.
Support Python >= 3.7
RadioJavan API valid for 13 September 2025 (last reverse-engineering check)
- Get full info of a Song, Video, Podcast, Story, Playlist, Artist, Album, User and your Account
- Login by email and password
- Sign up to RadioJavan
- Like and Unlike a Song, Video, Podcast and Story
- Follow and Unfollow a Artist, User or MusicPlaylist
- Get followers and following of a user
- Create, Rename and Delete a playlist
- Add song or video to playlist or Remove from it
- Edit and Deactive account
- Upload and Remove profile photo
- Search and get trending, popular and ... medias
and much more else
From PyPI
pip install radiojavanapi
From Github
pip install git+https://github.com/xHossein/radiojavanapi@master
from radiojavanapi import Client
# Create a Client instance and get a song info.
client = Client()
song = client.get_song_by_url(
'https://play.radiojavan.com/song/sijal-baz-mirim-baham-(ft-sami-low)')
print(f"""
Name: {song.name}
Artist: {song.artist}
HQ-Link: {song.hq_link}
""")Show Output
Name: Baz Mirim Baham (Ft Sami Low)
Artist: Sijal
HQ-Link: https://host2.mediacon-rj.app/media/mp3/aac-256/99926-cf9dd3814907dbb.m4a
You can find the documentation here.
- Create a GitHub issue for bug reports, feature requests, or questions
- Add a ⭐️ star on GitHub to support the project!
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.
You can find this repository's changelog here.
This project is licensed under the MIT license.