checkleaked-spotify-api 1.0.0__tar.gz

checkleaked_spotify_api-1.0.0/.gitignore

@@ -0,0 +1,9 @@
+/.pytest_cache/
+/.mypy_cache/
+/.venv/
+/build/
+/dist/
+/*.egg-info/
+**/__pycache__/
+*.py[cod]
+

checkleaked_spotify_api-1.0.0/API_REFERENCE.md

@@ -0,0 +1,190 @@
+# API reference
+
+Generated from the canonical TypeScript SDK and OpenAPI contract.
+Pythonic `snake_case` methods also expose their npm-compatible `camelCase` aliases.
+
+## `ai`
+
+- `health(query=None)` — GET `/ai/health`
+- `types(query=None)` — GET `/ai/types`
+- `analyze(query=None, body=None)` — POST `/ai/analyze`
+- `chart_trends(query=None, body=None)` (alias: `chartTrends`) — POST `/ai/chart-trends`
+- `artist_summary(query=None, body=None)` (alias: `artistSummary`) — POST `/ai/artist-summary`
+- `album_review(query=None, body=None)` (alias: `albumReview`) — POST `/ai/album-review`
+- `track_deep_dive(query=None, body=None)` (alias: `trackDeepDive`) — POST `/ai/track-deep-dive`
+- `playlist_curator(query=None, body=None)` (alias: `playlistCurator`) — POST `/ai/playlist-curator`
+- `market_comparison(query=None, body=None)` (alias: `marketComparison`) — POST `/ai/market-comparison`
+- `genre_landscape(query=None, body=None)` (alias: `genreLandscape`) — POST `/ai/genre-landscape`
+- `mood_profile(query=None, body=None)` (alias: `moodProfile`) — POST `/ai/mood-profile`
+- `viral_potential(query=None, body=None)` (alias: `viralPotential`) — POST `/ai/viral-potential`
+- `custom(query=None, body=None)` — POST `/ai/custom`
+
+## `albums`
+
+- `get(ids, contrast=None)` — GET `/albums`
+- `tracks(id, offset=None, limit=None)` — GET `/album_tracks`
+- `metadata(id, contrast=None)` — GET `/album_metadata`
+
+## `analysis`
+
+- `artist_compare(ids)` (alias: `artistCompare`) — GET `/artist_compare`
+- `audio_features(id)` (alias: `audioFeatures`) — GET `/audio_features`
+- `playlist_analysis(id)` (alias: `playlistAnalysis`) — GET `/playlist_analysis`
+
+## `artists`
+
+- `get(ids, contrast=None)` — GET `/artists`
+- `overview(id, contrast=None)` — GET `/artist_overview`
+- `discography_overview(id)` (alias: `discographyOverview`) — GET `/artist_discography_overview`
+- `albums(id, offset=None, limit=None)` — GET `/artist_albums`
+- `singles(id, offset=None, limit=None)` — GET `/artist_singles`
+- `appears_on(id)` (alias: `appearsOn`) — GET `/artist_appears_on`
+- `discovered_on(id)` (alias: `discoveredOn`) — GET `/artist_discovered_on`
+- `featuring(id)` — GET `/artist_featuring`
+- `related(id)` — GET `/artist_related`
+- `top_tracks(id, market=None)` (alias: `topTracks`) — GET `/artist_top_tracks`
+
+## `audiobooks`
+
+- `get(ids, market=None)` — GET `/audiobooks`
+- `get_by_id(id, market=None)` (alias: `getById`) — GET `/audiobooks/{id}`
+- `chapters(id, offset=None, limit=None)` — GET `/audiobooks/{id}/chapters`
+
+## `batch`
+
+- `album_metadata(ids)` (alias: `albumMetadata`) — GET `/album_metadata_batch`
+- `artist_overview(ids)` (alias: `artistOverview`) — GET `/artist_overview_batch`
+- `track_credits(ids)` (alias: `trackCredits`) — GET `/track_credits_batch`
+- `track_lyrics(ids, format=None)` (alias: `trackLyrics`) — GET `/track_lyrics_batch`
+- `track_popularity(ids)` (alias: `trackPopularity`) — GET `/track_popularity_batch`
+
+## `browse`
+
+- `categories(country=None, locale=None, limit=None, offset=None)` — GET `/browse/categories`
+- `category(id, country=None, locale=None)` — GET `/browse/categories/{id}`
+- `featured_playlists(country=None, locale=None, limit=None, offset=None)` (alias: `featuredPlaylists`) — GET `/browse/featured-playlists`
+- `new_releases(country=None, limit=None, offset=None)` (alias: `newReleases`) — GET `/browse/new-releases`
+- `recommendations(seed_tracks=None, seed_artists=None, seed_genres=None, limit=None)` — GET `/browse/recommendations`
+
+## `cache`
+
+- `stats(query=None)` — GET `/cache/stats`
+- `invalidate(key=None, pattern=None)` — POST `/cache/invalidate`
+
+## `charts`
+
+- `top_by_monthly_listeners(query=None)` (alias: `topByMonthlyListeners`) — GET `/top_20_by_monthly_listeners`
+- `top200_tracks(period=None, country=None, date=None)` (alias: `top200Tracks`) — GET `/top_200_tracks`
+- `top_artists(period=None, country=None)` (alias: `topArtists`) — GET `/top_artists`
+- `top_albums(period=None, country=None)` (alias: `topAlbums`) — GET `/top_albums`
+- `viral_tracks(country=None)` (alias: `viralTracks`) — GET `/viral_tracks`
+- `top_by_followers(query=None)` (alias: `topByFollowers`) — GET `/top_20_by_followers`
+
+## `concerts`
+
+- `locations(query)` — GET `/partner/concert-locations`
+- `feed(geo_hash, geoname_id, from_=None, to=None, radius_in_km=None, concept_uris=None, pagination_key=None, details=None, details_limit=None, parsed=None)` — GET `/partner/concert-feed`
+- `get(id, parsed=None, authenticated=None)` — GET `/partner/concert`
+- `by_artist(id, geo_hash=None, include_nearby=None, details=None, details_limit=None, parsed=None)` (alias: `byArtist`) — GET `/partner/artist-concerts`
+- `search_artists(query, geo_hash=None, include_nearby=None, limit=None, details=None, details_limit=None, parsed=None)` (alias: `searchArtists`) — GET `/partner/search-concert-artists`
+
+## `credentials`
+
+- `status(query=None)` — GET `/credentials/status`
+- `redis_cookies(query=None)` (alias: `redisCookies`) — GET `/cookies/redis`
+
+## `downloads`
+
+- `track(q)` — GET `/download_track`
+- `soundcloud(q)` — GET `/download_track_sc`
+
+## `episodes`
+
+- `get(ids, market=None)` — GET `/episodes`
+- `by_id(id, market=None)` (alias: `byId`) — GET `/episodes/{id}`
+
+## `health`
+
+- `ping(query=None)` — GET `/ping`
+- `get(query=None)` — GET `/health`
+- `instance(query=None)` — GET `/health/instance`
+- `cluster(query=None)` — GET `/health/cluster`
+- `cluster_strict(query=None)` (alias: `clusterStrict`) — GET `/health/cluster/strict`
+- `proxies(query=None)` — GET `/health/proxies`
+- `clear_proxies(query=None, body=None)` (alias: `clearProxies`) — POST `/health/proxies/clear`
+- `clear_errors(query=None, body=None)` (alias: `clearErrors`) — POST `/health/clear-errors`
+
+## `lookups`
+
+- `isrc(isrc)` — GET `/isrc_lookup`
+- `upc(upc)` — GET `/upc_lookup`
+
+## `markets`
+
+- `get(query=None)` — GET `/markets`
+
+## `partner`
+
+- `playlist(id, offset=None, limit=None)` — GET `/partner/playlist`
+- `track(id)` — GET `/partner/track`
+- `track_count(spotify_track_id=None, isrc=None)` (alias: `trackCount`) — GET `/partner/track/count`
+- `album(id, locale=None, offset=None, limit=None)` — GET `/partner/album`
+- `artist_overview(id, locale=None, include_prerelease=None)` (alias: `artistOverview`) — GET `/partner/artist-overview`
+- `artist_discography(id, offset=None, limit=None)` (alias: `artistDiscography`) — GET `/partner/artist-discography`
+
+## `playlists`
+
+- `get(id)` — GET `/playlist`
+- `tracks(id, offset=None, limit=None)` — GET `/playlist_tracks`
+- `from_seed(uri)` (alias: `fromSeed`) — GET `/seed_to_playlist`
+
+## `search`
+
+- `search(q, type=None, offset=None, limit=None, number_of_top_results=None, contrast=None)` — GET `/search`
+- `top_results(q, number_of_top_results=None, contrast=None)` (alias: `topResults`) — GET `/search_top_results`
+- `lyrics(q, format=None)` — GET `/search_lyrics`
+- `suggestions(q, offset=None, limit=None, number_of_top_results=None, include_authors=None, debug=None, timeout=None, contrast=None)` — GET `/search_suggestions`
+- `multi_market(q, type=None, markets=None, limit=None)` (alias: `multiMarket`) — GET `/search_multi_market`
+
+## `shows`
+
+- `get(ids, market=None)` — GET `/shows`
+- `get_by_id(id, market=None)` (alias: `getById`) — GET `/shows/{id}`
+- `episodes(id, offset=None, limit=None)` — GET `/shows/{id}/episodes`
+
+## `snapshots`
+
+- `list(id)` — GET `/playlist_snapshot`
+- `create(id=None, webhook=None)` — POST `/playlist_snapshot`
+
+## `tracking`
+
+- `track(type, id)` — POST `/tracking/track`
+- `untrack(type, id)` — DELETE `/tracking/untrack`
+- `items(offset=None, limit=None)` — GET `/tracking/items`
+- `item(spotify_type, spotify_id)` — GET `/tracking/items/{spotifyType}/{spotifyId}`
+- `logs(offset=None, limit=None)` — GET `/tracking/logs`
+- `stats(query=None)` — GET `/tracking/stats`
+- `health(query=None)` — GET `/tracking/health`
+
+## `tracks`
+
+- `get(ids, contrast=None)` — GET `/tracks`
+- `credits(id)` — GET `/track_credits`
+- `lyrics(id, format=None, vocal_removal=None)` — GET `/track_lyrics`
+- `recommendations(limit=None, seed_tracks=None, seed_artists=None, seed_genres=None)` — GET `/recommendations`
+
+## `users`
+
+- `profile(id, playlist_limit=None, artist_limit=None, episode_limit=None)` — GET `/user_profile`
+- `followers(id)` — GET `/user_followers`
+
+## `webhooks`
+
+- `get(query=None)` — GET `/webhooks`
+- `register(url=None, events=None)` — POST `/webhooks/register`
+- `stats(query=None)` — GET `/webhooks/stats`
+- `delete(id)` — DELETE `/webhooks/{id}`
+- `test(id)` — POST `/webhooks/{id}/test`
+- `deliveries(id)` — GET `/webhooks/{id}/deliveries`
+

checkleaked_spotify_api-1.0.0/CHANGELOG.md

@@ -0,0 +1,11 @@
+# Changelog
+
+## 1.0.0 - 2026-07-26
+
+- Initial Python release matching `@checkleaked/spotify-api`.
+- 110 methods across all 25 Spotify Data API namespaces.
+- RapidAPI `spotify81` and direct CheckLeaked proxy provider presets.
+- Typed parameters, Spotify ID/URI/URL normalization, pagination helpers,
+  retries, timeouts, lifecycle hooks, structured errors, and sync context
+  manager support.
+

checkleaked_spotify_api-1.0.0/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 Eduardo Airaudo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

checkleaked_spotify_api-1.0.0/PKG-INFO

@@ -0,0 +1,201 @@
+Metadata-Version: 2.4
+Name: checkleaked-spotify-api
+Version: 1.0.0
+Summary: Typed Python SDK for the CheckLeaked Spotify Data API and RapidAPI spotify81.
+Project-URL: Homepage, https://spotify-proxy.checkleaked.cc
+Project-URL: Documentation, https://spotify-proxy.checkleaked.cc/docs
+Project-URL: Repository, https://github.com/eduair94/checkleaked-spotify-api-python
+Project-URL: Issues, https://github.com/eduair94/checkleaked-spotify-api-python/issues
+Project-URL: OpenAPI, https://spotify-proxy.checkleaked.cc/openapi.json
+Author-email: Eduardo Airaudo <airaudoeduardo@gmail.com>
+License: MIT
+License-File: LICENSE
+Keywords: charts,checkleaked,concerts,lyrics,music,rapidapi,sdk,spotify,spotify-api,spotify-data,spotify81
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Typing :: Typed
+Requires-Python: >=3.8
+Requires-Dist: requests>=2.25
+Provides-Extra: dev
+Requires-Dist: build; extra == 'dev'
+Requires-Dist: mypy>=1.8; extra == 'dev'
+Requires-Dist: pytest>=7; extra == 'dev'
+Requires-Dist: twine; extra == 'dev'
+Requires-Dist: types-requests; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# checkleaked-spotify-api
+
+[![PyPI version](https://img.shields.io/pypi/v/checkleaked-spotify-api.svg)](https://pypi.org/project/checkleaked-spotify-api/)
+[![Python versions](https://img.shields.io/pypi/pyversions/checkleaked-spotify-api.svg)](https://pypi.org/project/checkleaked-spotify-api/)
+[![CI](https://github.com/eduair94/checkleaked-spotify-api-python/actions/workflows/ci.yml/badge.svg)](https://github.com/eduair94/checkleaked-spotify-api-python/actions/workflows/ci.yml)
+[![license: MIT](https://img.shields.io/pypi/l/checkleaked-spotify-api.svg)](./LICENSE)
+
+Typed Python SDK for the **Spotify Data API**, covering the same 110 methods
+and 25 namespaces as
+[`@checkleaked/spotify-api`](https://www.npmjs.com/package/@checkleaked/spotify-api).
+It works with both the
+[RapidAPI spotify81 API](https://rapidapi.com/airaudoeduardo/api/spotify81)
+and the direct
+[CheckLeaked proxy](https://spotify-proxy.checkleaked.cc/docs).
+
+This is a data API client. It does not require Spotify OAuth credentials.
+
+## Install
+
+```bash
+pip install checkleaked-spotify-api
+```
+
+## Quick start
+
+```python
+from spotify_api_sdk import SpotifyApiClient
+
+spotify = SpotifyApiClient(api_key="your-rapidapi-key")
+
+results = spotify.search.search(
+    "daft punk",
+    type="artists",
+    limit=5,
+)
+
+artist = spotify.artists.overview(
+    "spotify:artist:4tZwfgrHOc3mvqYlEYSvVi"
+)
+
+lyrics = spotify.tracks.lyrics(
+    "https://open.spotify.com/track/0DiWol3AO6WpXZgp0goxAV",
+    format="lrc",
+)
+```
+
+Methods return the API's unwrapped `data` payload. Use
+`client.request_raw(...)` when you need the complete success envelope.
+
+## Providers
+
+RapidAPI is the default and automatically adds
+`x-rapidapi-host: spotify81.p.rapidapi.com`:
+
+```python
+spotify = SpotifyApiClient(
+    api_key="your-rapidapi-key",
+    provider="rapidapi",
+)
+```
+
+The direct proxy exposes the same methods and paths. Use a key issued by the
+direct portal:
+
+```python
+spotify = SpotifyApiClient(
+    api_key="your-direct-proxy-key",
+    provider="proxy",
+)
+```
+
+The API key may be omitted when `SPOTIFY_API_KEY` or `RAPIDAPI_KEY` is set.
+
+## Pythonic and npm-compatible names
+
+Python methods use `snake_case`, while npm-style `camelCase` aliases are also
+available:
+
+```python
+spotify.artists.top_tracks(id, market="US")
+spotify.artists.topTracks(id, market="US")  # exact npm-style alias
+```
+
+Every method supports per-call `request_timeout`, `request_retries`,
+`request_headers`, and an additional `extra_query` mapping. POST methods also
+accept a free-form `body` mapping.
+
+## IDs, URIs, and URLs
+
+Spotify IDs may be supplied as bare IDs, Spotify URIs, or open.spotify.com
+URLs. Multi-ID methods accept comma-separated strings or Python sequences.
+
+```python
+from spotify_api_sdk import normalize_id, normalize_ids
+
+normalize_id("spotify:track:0DiWol3AO6WpXZgp0goxAV")
+normalize_ids([
+    "spotify:artist:4tZwfgrHOc3mvqYlEYSvVi",
+    "https://open.spotify.com/artist/06HL4z0CvFAxyc27GXpf02",
+])
+```
+
+## Pagination
+
+```python
+from spotify_api_sdk import collect
+
+items = collect(
+    lambda **page: spotify.artists.albums(id=artist_id, **page),
+    get_items=lambda response: (
+        response.get("data", {})
+        .get("artist", {})
+        .get("discography", {})
+        .get("albums", {})
+        .get("items", [])
+    ),
+    limit=50,
+    max_items=500,
+)
+```
+
+## Errors
+
+```python
+from spotify_api_sdk import (
+    AuthError,
+    HttpError,
+    RateLimitError,
+    SpotifyApiError,
+    TimeoutError,
+)
+
+try:
+    spotify.search.search("daft punk")
+except RateLimitError as error:
+    print(error.retry_after_ms)
+except AuthError:
+    print("Invalid or unsubscribed API key")
+except SpotifyApiError as error:
+    print(error.status, error.code, error.url)
+```
+
+## Configuration
+
+```python
+spotify = SpotifyApiClient(
+    api_key="...",
+    provider="rapidapi",   # rapidapi (default) | proxy
+    timeout=30,
+    retries=2,
+    retry_delay=0.5,
+    headers={"x-my-header": "value"},
+    debug=True,
+    on_request=lambda info: print("request", info["url"]),
+    on_response=lambda info: print("response", info["status"]),
+    on_retry=lambda info: print("retry", info["attempt"]),
+)
+```
+
+The client is also a context manager:
+
+```python
+with SpotifyApiClient(api_key="...") as spotify:
+    markets = spotify.markets.get()
+```
+
+See [API_REFERENCE.md](./API_REFERENCE.md) for every namespace and method.

checkleaked_spotify_api-1.0.0/README.md

@@ -0,0 +1,167 @@
+# checkleaked-spotify-api
+
+[![PyPI version](https://img.shields.io/pypi/v/checkleaked-spotify-api.svg)](https://pypi.org/project/checkleaked-spotify-api/)
+[![Python versions](https://img.shields.io/pypi/pyversions/checkleaked-spotify-api.svg)](https://pypi.org/project/checkleaked-spotify-api/)
+[![CI](https://github.com/eduair94/checkleaked-spotify-api-python/actions/workflows/ci.yml/badge.svg)](https://github.com/eduair94/checkleaked-spotify-api-python/actions/workflows/ci.yml)
+[![license: MIT](https://img.shields.io/pypi/l/checkleaked-spotify-api.svg)](./LICENSE)
+
+Typed Python SDK for the **Spotify Data API**, covering the same 110 methods
+and 25 namespaces as
+[`@checkleaked/spotify-api`](https://www.npmjs.com/package/@checkleaked/spotify-api).
+It works with both the
+[RapidAPI spotify81 API](https://rapidapi.com/airaudoeduardo/api/spotify81)
+and the direct
+[CheckLeaked proxy](https://spotify-proxy.checkleaked.cc/docs).
+
+This is a data API client. It does not require Spotify OAuth credentials.
+
+## Install
+
+```bash
+pip install checkleaked-spotify-api
+```
+
+## Quick start
+
+```python
+from spotify_api_sdk import SpotifyApiClient
+
+spotify = SpotifyApiClient(api_key="your-rapidapi-key")
+
+results = spotify.search.search(
+    "daft punk",
+    type="artists",
+    limit=5,
+)
+
+artist = spotify.artists.overview(
+    "spotify:artist:4tZwfgrHOc3mvqYlEYSvVi"
+)
+
+lyrics = spotify.tracks.lyrics(
+    "https://open.spotify.com/track/0DiWol3AO6WpXZgp0goxAV",
+    format="lrc",
+)
+```
+
+Methods return the API's unwrapped `data` payload. Use
+`client.request_raw(...)` when you need the complete success envelope.
+
+## Providers
+
+RapidAPI is the default and automatically adds
+`x-rapidapi-host: spotify81.p.rapidapi.com`:
+
+```python
+spotify = SpotifyApiClient(
+    api_key="your-rapidapi-key",
+    provider="rapidapi",
+)
+```
+
+The direct proxy exposes the same methods and paths. Use a key issued by the
+direct portal:
+
+```python
+spotify = SpotifyApiClient(
+    api_key="your-direct-proxy-key",
+    provider="proxy",
+)
+```
+
+The API key may be omitted when `SPOTIFY_API_KEY` or `RAPIDAPI_KEY` is set.
+
+## Pythonic and npm-compatible names
+
+Python methods use `snake_case`, while npm-style `camelCase` aliases are also
+available:
+
+```python
+spotify.artists.top_tracks(id, market="US")
+spotify.artists.topTracks(id, market="US")  # exact npm-style alias
+```
+
+Every method supports per-call `request_timeout`, `request_retries`,
+`request_headers`, and an additional `extra_query` mapping. POST methods also
+accept a free-form `body` mapping.
+
+## IDs, URIs, and URLs
+
+Spotify IDs may be supplied as bare IDs, Spotify URIs, or open.spotify.com
+URLs. Multi-ID methods accept comma-separated strings or Python sequences.
+
+```python
+from spotify_api_sdk import normalize_id, normalize_ids
+
+normalize_id("spotify:track:0DiWol3AO6WpXZgp0goxAV")
+normalize_ids([
+    "spotify:artist:4tZwfgrHOc3mvqYlEYSvVi",
+    "https://open.spotify.com/artist/06HL4z0CvFAxyc27GXpf02",
+])
+```
+
+## Pagination
+
+```python
+from spotify_api_sdk import collect
+
+items = collect(
+    lambda **page: spotify.artists.albums(id=artist_id, **page),
+    get_items=lambda response: (
+        response.get("data", {})
+        .get("artist", {})
+        .get("discography", {})
+        .get("albums", {})
+        .get("items", [])
+    ),
+    limit=50,
+    max_items=500,
+)
+```
+
+## Errors
+
+```python
+from spotify_api_sdk import (
+    AuthError,
+    HttpError,
+    RateLimitError,
+    SpotifyApiError,
+    TimeoutError,
+)
+
+try:
+    spotify.search.search("daft punk")
+except RateLimitError as error:
+    print(error.retry_after_ms)
+except AuthError:
+    print("Invalid or unsubscribed API key")
+except SpotifyApiError as error:
+    print(error.status, error.code, error.url)
+```
+
+## Configuration
+
+```python
+spotify = SpotifyApiClient(
+    api_key="...",
+    provider="rapidapi",   # rapidapi (default) | proxy
+    timeout=30,
+    retries=2,
+    retry_delay=0.5,
+    headers={"x-my-header": "value"},
+    debug=True,
+    on_request=lambda info: print("request", info["url"]),
+    on_response=lambda info: print("response", info["status"]),
+    on_retry=lambda info: print("retry", info["attempt"]),
+)
+```
+
+The client is also a context manager:
+
+```python
+with SpotifyApiClient(api_key="...") as spotify:
+    markets = spotify.markets.get()
+```
+
+See [API_REFERENCE.md](./API_REFERENCE.md) for every namespace and method.

checkleaked_spotify_api-1.0.0/pyproject.toml

@@ -0,0 +1,82 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "checkleaked-spotify-api"
+version = "1.0.0"
+description = "Typed Python SDK for the CheckLeaked Spotify Data API and RapidAPI spotify81."
+readme = "README.md"
+requires-python = ">=3.8"
+license = { text = "MIT" }
+authors = [{ name = "Eduardo Airaudo", email = "airaudoeduardo@gmail.com" }]
+keywords = [
+    "spotify",
+    "spotify-api",
+    "spotify-data",
+    "spotify81",
+    "rapidapi",
+    "checkleaked",
+    "music",
+    "lyrics",
+    "charts",
+    "concerts",
+    "sdk",
+]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Typing :: Typed",
+]
+dependencies = ["requests>=2.25"]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7",
+    "mypy>=1.8",
+    "types-requests",
+    "build",
+    "twine",
+]
+
+[project.urls]
+Homepage = "https://spotify-proxy.checkleaked.cc"
+Documentation = "https://spotify-proxy.checkleaked.cc/docs"
+Repository = "https://github.com/eduair94/checkleaked-spotify-api-python"
+Issues = "https://github.com/eduair94/checkleaked-spotify-api-python/issues"
+OpenAPI = "https://spotify-proxy.checkleaked.cc/openapi.json"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/spotify_api_sdk"]
+
+[tool.hatch.build.targets.sdist]
+include = [
+    "src",
+    "tests",
+    "scripts",
+    "README.md",
+    "API_REFERENCE.md",
+    "LICENSE",
+    "CHANGELOG.md",
+]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "-q"
+markers = [
+    "live: performs a real network request against a configured provider",
+]
+
+[tool.mypy]
+python_version = "3.10"
+strict = true
+warn_return_any = false
+files = ["src"]