radiojavanapi

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)

Features

• 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

Installation

From PyPI

pip install radiojavanapi

From Github

pip install git+https://github.com/xHossein/radiojavanapi@master

Basic Usage

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}
""")

<details> <summary>Show Output</summary>

Name: Baz Mirim Baham (Ft Sami Low)
Artist: Sijal
HQ-Link: https://host2.mediacon-rj.app/media/mp3/aac-256/99926-cf9dd3814907dbb.m4a

</details>

Documentation

You can find the documentation here.

Support

• Create a GitHub issue for bug reports, feature requests, or questions
• Add a ⭐️ star on GitHub to support the project!

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Changelog

You can find this repository's changelog here.

License

This project is licensed under the MIT license.