Metadata-Version: 2.3
Name: soundchartspy
Version: 0.1.1
Summary: A python wrapper package for the paid api from soundcharts. This package is not affiliated with soundcharts and is not endorsed by them. However, it is built upon their api and can be used assuming you have a paid subscription to their service.
Project-URL: Homepage, https://github.com/AidanAlr/soundchartspy
Project-URL: Issues, https://github.com/AidanAlr/soundchartspy/issues
Author-email: AidanAlr <aidanalrawi@icloud.com>
License-File: LICENSE
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.8
Description-Content-Type: text/markdown

# Sounchartspy

A python wrapper for the [Soundcharts API](https://doc.api.soundcharts.com/api/v2/doc).

## Installation

```bash
pip install soundchartspy
```

## Example Usage

```python
from soundchartspy.client import SoundCharts
from soundchartspy.data import Song, Album

# Initialize the SoundCharts client
sc = SoundCharts(api_key='your_api_key', app_id='your_app_id')

# Get the song by uuid
song: Song = sc.song(song_uuid='7d534228-5165-11e9-9375-549f35161576')
print("Song Name: {}, Artists: {}".format(song.name, song.artists))

# Get the song audience on spotify.
audience_data: dict = sc.song_audience(song.uuid, 'spotify')
print("Spotify Audience: {}".format(audience_data))

# Get the song albums
albums: list[Album] = sc.song_albums(song.uuid)
print("Albums: {}".format(albums))
```