crawlora-spotify 0.1.0 → 0.1.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/CHANGELOG.md +1 -1
- data/README.md +47 -2
- data/lib/crawlora/spotify/client.rb +1 -1
- data/lib/crawlora/spotify/version.rb +1 -1
- metadata +6 -4
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA256:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: 6af6768e21b75bd77ae52c805e6ae37a0e5c8004f8fef38db383a6636a25fc25
|
|
4
|
+
data.tar.gz: 59f6774742ca1fcf7dc93350af3a87deb1c70f2c01e1a24ec4d45249151acebb
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: c0807b557b0f5508d485b93a2d427fe0b605a94821c6454555b41081732a70e92c56d06e18c6b3ad394438f211e297c36e5c1b108fc995085940ba3e32eaa81d
|
|
7
|
+
data.tar.gz: e4f1a9a1f988577ec6f555c53b6d50bd36258049162da1af4d74a67a7f14c5a13e8ed7de4e62f912318f3e8ab7993c112611b0fdff8cc87a6c5f15d8ad064199
|
data/CHANGELOG.md
CHANGED
data/README.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
|
-
# Crawlora Spotify Ruby
|
|
1
|
+
# Crawlora Spotify API client for Ruby (`crawlora-spotify`)
|
|
2
2
|
|
|
3
|
-
This gem calls
|
|
3
|
+
This Ruby gem calls Crawlora's hosted Spotify API at `https://api.crawlora.net/api/v1`. It exposes 38 endpoints covering search, tracks, albums, artists, playlists, profiles, audiobooks, charts, and podcast shows and episodes; it does not call or scrape Spotify directly. Requests require your Crawlora API key and use your account's service plan.
|
|
4
4
|
|
|
5
5
|
## Install
|
|
6
6
|
|
|
@@ -30,4 +30,49 @@ client.close
|
|
|
30
30
|
|
|
31
31
|
Client options include `api_key`, `base_url`, and `timeout`. Ruby stdlib provides the HTTP and JSON support.
|
|
32
32
|
|
|
33
|
+
## Supported Spotify API endpoints
|
|
34
|
+
|
|
35
|
+
Browse every route included in this gem. The [endpoint reference](https://github.com/Crawlora-org/crawlora-spotify/blob/main/docs/usage.md) includes parameter and response details.
|
|
36
|
+
|
|
37
|
+
| Method | Endpoint | API operation | Description |
|
|
38
|
+
| --- | --- | --- | --- |
|
|
39
|
+
| `GET` | `/spotify-podcasts/categories` | `spotify-podcasts-categories` | Retrieve Spotify Podcasts categories |
|
|
40
|
+
| `GET` | `/spotify-podcasts/charts` | `spotify-podcasts-charts` | Retrieve Spotify podcast charts |
|
|
41
|
+
| `GET` | `/spotify-podcasts/episode` | `spotify-podcasts-episode` | Retrieve Spotify podcast episode details |
|
|
42
|
+
| `GET` | `/spotify-podcasts/home` | `spotify-podcasts-home` | Retrieve Spotify Podcasts home |
|
|
43
|
+
| `GET` | `/spotify-podcasts/search` | `spotify-podcasts-search` | Search Spotify Podcasts |
|
|
44
|
+
| `GET` | `/spotify-podcasts/show` | `spotify-podcasts-show` | Retrieve Spotify podcast show metadata |
|
|
45
|
+
| `GET` | `/spotify-podcasts/show/episodes` | `spotify-podcasts-show-episodes` | Retrieve Spotify podcast show episodes |
|
|
46
|
+
| `GET` | `/spotify-podcasts/show/recommendations` | `spotify-podcasts-show-recommendations` | Retrieve Spotify podcast recommendations |
|
|
47
|
+
| `GET` | `/spotify/album` | `spotify-album` | Retrieve Spotify album details |
|
|
48
|
+
| `GET` | `/spotify/album/tracks` | `spotify-album-tracks` | Retrieve Spotify album tracks |
|
|
49
|
+
| `GET` | `/spotify/albums/search` | `spotify-albums-search` | Search Spotify albums |
|
|
50
|
+
| `GET` | `/spotify/artist` | `spotify-artist` | Retrieve Spotify artist details |
|
|
51
|
+
| `GET` | `/spotify/artist/albums` | `spotify-artist-albums` | Retrieve Spotify artist albums |
|
|
52
|
+
| `GET` | `/spotify/artist/playlists` | `spotify-artist-playlists` | Retrieve Spotify artist playlists |
|
|
53
|
+
| `GET` | `/spotify/artist/related` | `spotify-artist-related` | Retrieve Spotify related artists |
|
|
54
|
+
| `GET` | `/spotify/artists/search` | `spotify-artists-search` | Search Spotify artists |
|
|
55
|
+
| `GET` | `/spotify/audiobook` | `spotify-audiobook` | Retrieve Spotify audiobook details |
|
|
56
|
+
| `GET` | `/spotify/audiobook/chapters` | `spotify-audiobook-chapters` | Retrieve Spotify audiobook chapters |
|
|
57
|
+
| `GET` | `/spotify/audiobooks/search` | `spotify-audiobooks-search` | Search Spotify audiobooks |
|
|
58
|
+
| `GET` | `/spotify/chapter` | `spotify-chapter` | Retrieve Spotify audiobook chapter details |
|
|
59
|
+
| `GET` | `/spotify/episodes/search` | `spotify-episodes-search` | Search Spotify episodes |
|
|
60
|
+
| `GET` | `/spotify/featured-charts-by-country` | `spotify-featured-charts-by-country` | Retrieve Spotify featured charts by country |
|
|
61
|
+
| `GET` | `/spotify/genre` | `spotify-genre` | Retrieve Spotify genre page |
|
|
62
|
+
| `GET` | `/spotify/home` | `spotify-home` | Retrieve Spotify home sections |
|
|
63
|
+
| `GET` | `/spotify/playlist` | `spotify-playlist` | Retrieve Spotify playlist details |
|
|
64
|
+
| `GET` | `/spotify/playlists/search` | `spotify-playlists-search` | Search Spotify playlists |
|
|
65
|
+
| `GET` | `/spotify/popular-by-country` | `spotify-popular-by-country` | Retrieve Spotify popular by country |
|
|
66
|
+
| `GET` | `/spotify/profile` | `spotify-profile` | Retrieve Spotify public profile |
|
|
67
|
+
| `GET` | `/spotify/profile/followers` | `spotify-profile-followers` | Retrieve Spotify public profile followers |
|
|
68
|
+
| `GET` | `/spotify/profile/playlists` | `spotify-profile-playlists` | Retrieve Spotify public profile playlists |
|
|
69
|
+
| `GET` | `/spotify/profiles/search` | `spotify-profiles-search` | Search Spotify profiles |
|
|
70
|
+
| `GET` | `/spotify/search` | `spotify-search` | Search Spotify catalog |
|
|
71
|
+
| `GET` | `/spotify/section` | `spotify-section` | Retrieve Spotify browse section |
|
|
72
|
+
| `GET` | `/spotify/shows/search` | `spotify-shows-search` | Search Spotify shows |
|
|
73
|
+
| `GET` | `/spotify/track` | `spotify-track` | Retrieve Spotify track details |
|
|
74
|
+
| `GET` | `/spotify/track/recommended` | `spotify-track-recommended` | Retrieve Spotify recommended tracks |
|
|
75
|
+
| `GET` | `/spotify/track/similar-albums` | `spotify-track-similar-albums` | Retrieve Spotify track similar albums |
|
|
76
|
+
| `GET` | `/spotify/tracks/search` | `spotify-tracks-search` | Search Spotify tracks |
|
|
77
|
+
|
|
33
78
|
See [Crawlora](https://crawlora.net/?utm_source=rubygems&utm_medium=referral&utm_campaign=platform-clients&utm_content=spotify-ruby-homepage), the [API documentation](https://crawlora.net/docs?utm_source=rubygems&utm_medium=referral&utm_campaign=platform-clients&utm_content=spotify-ruby-api-docs), and [the package repository](https://github.com/Crawlora-org/crawlora-spotify) for account setup, the API operation reference, and release history.
|
|
@@ -29,7 +29,7 @@ module Crawlora
|
|
|
29
29
|
class Client
|
|
30
30
|
attr_reader :base_url
|
|
31
31
|
|
|
32
|
-
def initialize(api_key: ENV["CRAWLORA_API_KEY"], base_url: "https://api.crawlora.net/api/v1", timeout: 30, user_agent: "crawlora-spotify-ruby/0.1.
|
|
32
|
+
def initialize(api_key: ENV["CRAWLORA_API_KEY"], base_url: "https://api.crawlora.net/api/v1", timeout: 30, user_agent: "crawlora-spotify-ruby/0.1.1", transport: nil)
|
|
33
33
|
@api_key = api_key
|
|
34
34
|
@base_url = base_url.to_s.sub(%r{/+$}, "")
|
|
35
35
|
@timeout = Float(timeout)
|
metadata
CHANGED
|
@@ -1,16 +1,18 @@
|
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
|
2
2
|
name: crawlora-spotify
|
|
3
3
|
version: !ruby/object:Gem::Version
|
|
4
|
-
version: 0.1.
|
|
4
|
+
version: 0.1.1
|
|
5
5
|
platform: ruby
|
|
6
6
|
authors:
|
|
7
7
|
- Crawlora
|
|
8
8
|
autorequire:
|
|
9
9
|
bindir: bin
|
|
10
10
|
cert_chain: []
|
|
11
|
-
date: 2026-10-
|
|
11
|
+
date: 2026-10-12 00:00:00.000000000 Z
|
|
12
12
|
dependencies: []
|
|
13
|
-
description:
|
|
13
|
+
description: Ruby client for Crawlora's hosted Spotify API. Covers search, tracks,
|
|
14
|
+
albums, artists, playlists, profiles, audiobooks, charts, and podcast shows and
|
|
15
|
+
episodes across 38 endpoints.
|
|
14
16
|
email:
|
|
15
17
|
executables: []
|
|
16
18
|
extensions: []
|
|
@@ -47,5 +49,5 @@ requirements: []
|
|
|
47
49
|
rubygems_version: 3.4.19
|
|
48
50
|
signing_key:
|
|
49
51
|
specification_version: 4
|
|
50
|
-
summary: Spotify client for
|
|
52
|
+
summary: Spotify API client for Crawlora (38 endpoints)
|
|
51
53
|
test_files: []
|