https://github.com/xhossein/radiojavanapi
Fast and effective Radio Javan API wrapper
https://github.com/xhossein/radiojavanapi
api api-wrapper python radio-javan radiojavan rj
Last synced: 6 months ago
JSON representation
Fast and effective Radio Javan API wrapper
- Host: GitHub
- URL: https://github.com/xhossein/radiojavanapi
- Owner: xHossein
- License: mit
- Created: 2021-02-08T07:53:36.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2023-03-19T05:37:20.000Z (over 3 years ago)
- Last Synced: 2025-09-11T06:53:29.166Z (10 months ago)
- Topics: api, api-wrapper, python, radio-javan, radiojavan, rj
- Language: Python
- Homepage: https://xhossein.github.io/radiojavanapi/
- Size: 76.2 KB
- Stars: 23
- Watchers: 1
- Forks: 6
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# 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
```python
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
```
## Documentation
You can find the documentation [here](https://xhossein.github.io/radiojavanapi/).
## Support
- Create a [GitHub issue](https://github.com/xHossein/radiojavanapi/issues) for bug reports, feature requests, or questions
- Add a ⭐️ [star on GitHub](https://github.com/xHossein/radiojavanapi) 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](https://github.com/xHossein/radiojavanapi/blob/master/CHANGELOG.md).
## License
This project is licensed under the [MIT license](https://choosealicense.com/licenses/mit/).