{ "id": "spotify-api-v2", "slug": "spotify-api-v2", "name": "Spotify API v2 for AI Agents", "provider": { "slug": "apistead-labs", "name": "APIStead Labs", "verified": true }, "category": "Media", "tagline": "Spotify metadata v2: tracks, albums, artists, playlists, search, full discographies, artist playlists, related artists, discovered-on and featuring playlists, similar albums, podcasts, episodes, audiobooks, chapters, genres and users. No auth, no API key.", "description": "Spotify v2 metadata API for AI agents. Search tracks, albums, artists, playlists, podcasts, episodes, audiobooks, genres and users; fetch complete artist discographies, artist playlists, related artists, similar albums, podcast episodes, audiobook chapters and public user playlists. No Spotify login or API key required.", "agent_summary": "Spotify v2 metadata for agents: search the catalogue; fetch complete artist discographies, artist playlists, related artists, similar albums, podcast episodes, audiobook chapters and public user playlists. No Spotify login or API key.", "scope": "The v2 release covers public Spotify search, playlists, albums, artists, artist top tracks, related artists, artist playlists, discovered-on playlists, featuring playlists, complete artist discographies, tracks, similar albums, podcasts, podcast episodes, episodes, audiobooks, audiobook chapters, genres and public user profiles. The five v1 routes remain live. It does not access a user library, playback, downloads or account data. Playlist creation dates and per-track added dates are not exposed in public metadata.", "intent_phrases": [ "Spotify search API", "Spotify API without login", "Spotify API without an API key", "Spotify API no OAuth", "Spotify catalogue search", "Spotify music metadata API", "Spotify discography API", "Spotify artist playlists API", "Spotify related artists API", "get Spotify related artists", "get Spotify artist playlists", "get Spotify artist discovered-on playlists", "get Spotify artist featuring playlists", "get Spotify albums similar to a track", "search Spotify podcasts", "search Spotify episodes", "search Spotify audiobooks", "search Spotify users", "get a Spotify podcast", "get Spotify podcast episodes", "get a Spotify episode", "get a Spotify audiobook", "get Spotify audiobook chapters", "get Spotify genres", "get a Spotify public user profile", "search Spotify tracks", "search Spotify albums", "search Spotify artists", "search Spotify playlists", "get Spotify metadata without a token", "search Spotify for a track", "search Spotify for an album or artist", "search Spotify without an API key", "get a Spotify artist's complete discography", "get a Spotify playlist with full track metadata", "get Spotify metadata without a Spotify account", "Spotify API v2 for AI agents", "Spotify API alternative" ], "faqs": [ { "answer": "v1 keeps playlist, album, artist, artist top-tracks and track metadata. v2 adds keyword search, complete artist discographies, artist playlists, related artists, discovered-on playlists, featuring playlists, similar albums and dedicated spoken-audio and user search. v2 returns the same core shapes as v1.", "question": "What is the difference between Spotify v1 and v2?" }, { "answer": "No. The provider uses public catalogue metadata. There is no Spotify login, OAuth grant, user library scope or playback scope, and the buyer does not send a Spotify token.", "question": "Does v2 require a Spotify account?" }, { "answer": "No. APIStead is an independent first-party API and is not affiliated with or endorsed by Spotify. It reads public Spotify catalogue metadata without a buyer account.", "question": "Is APIStead affiliated with Spotify?" }, { "answer": "No. Playlist creation dates are not exposed in public playlist metadata. Per-track added dates are not exposed in public metadata. V2 does not return or fabricate either.", "question": "Does v2 include playlist creation or per-track added dates?" }, { "answer": "No. The public catalogue source exposes world_rank but does not expose Spotify genre labels or popularity scores. V2 does not fabricate them.", "question": "Does v2 include artist genres or popularity?" }, { "answer": "No. It pages through the complete playlist and returns every ordered track. album_limit only controls how many tracks receive album enrichment.", "question": "Does the v2 playlist endpoint limit tracks?" }, { "answer": "Search returns tracks, albums, artists, playlists, podcasts, episodes, audiobooks, genres and users with per-type counts and totals. Dedicated search routes return only podcasts, episodes, audiobooks or users. Detail routes return podcasts, podcast episodes, episodes, audiobooks, audiobook chapters, genres and public user profiles. Artist records include world_rank, and artist routes return playlists, related artists, discovered-on playlists and featuring playlists.", "question": "What does v2 search return?" }, { "answer": "V2 includes artist playlists, related artists, discovered-on playlists, featuring playlists and similar albums based on a track. These return normalized JSON for agents.", "question": "What artist and recommendation routes does v2 include?" }, { "answer": "No. Radio is created by the playback client and is not exposed as a stable public catalogue query. V2 returns similar albums based on a track and related artists instead.", "question": "Does v2 include track, album or artist radio?" }, { "answer": "v2 returns all albums, singles and EPs and marks complete as true when the release feed was fully read. The public Appears On section exposes up to 50 items and reports appears_on_total.", "question": "Is the v2 discography complete?" }, { "answer": "No. v2 returns metadata only. It does not download audio, stream audio, control playback or access a user library.", "question": "Does v2 download or play music?" }, { "answer": "Every v2 route costs $0.03 USDC on Base. The agent reads the x402 402 challenge, pays the provider wallet directly and retries. There is no API key or subscription.", "question": "How much does a v2 call cost?" } ], "code_examples": [ { "code": "import asyncio\nimport os\n\nfrom eth_account import Account\nfrom x402 import x402Client\nfrom x402.http.clients import x402HttpxClient\nfrom x402.mechanisms.evm import EthAccountSigner\nfrom x402.mechanisms.evm.exact.register import register_exact_evm_client\n\naccount = Account.from_key(os.environ[\"EVM_PRIVATE_KEY\"])\nclient = x402Client()\nregister_exact_evm_client(client, EthAccountSigner(account))\n\n\nasync def main():\n async with x402HttpxClient(client) as http:\n response = await http.get(\n \"https://apistead.qd.je/api/v2/spotify/search\",\n params={\"q\": \"daft punk\", \"type\": \"track\", \"limit\": 5},\n )\n response.raise_for_status()\n print(response.json())\n\n\nasyncio.run(main())", "label": "Python: v2 search", "language": "python" }, { "code": "import { x402Client } from \"@x402/core/client\";\nimport { ExactEvmScheme } from \"@x402/evm/exact/client\";\nimport { wrapFetchWithPayment } from \"@x402/fetch\";\nimport { privateKeyToAccount } from \"viem/accounts\";\n\nconst account = privateKeyToAccount(process.env.EVM_PRIVATE_KEY);\nconst client = new x402Client();\nclient.register(\"eip155:8453\", new ExactEvmScheme(account));\n\nconst paidFetch = wrapFetchWithPayment(fetch, client);\nconst response = await paidFetch(\n \"https://apistead.qd.je/api/v2/spotify/search?q=daft%20punk&type=track&limit=5\",\n);\n\nconsole.log(await response.json());", "label": "JavaScript: v2 search", "language": "javascript" }, { "code": "curl -i \"https://apistead.qd.je/api/v2/spotify/search?q=daft%20punk&type=track&limit=5\"", "label": "cURL: v2 search challenge", "language": "bash" }, { "code": "import asyncio\nimport os\n\nfrom eth_account import Account\nfrom x402 import x402Client\nfrom x402.http.clients import x402HttpxClient\nfrom x402.mechanisms.evm import EthAccountSigner\nfrom x402.mechanisms.evm.exact.register import register_exact_evm_client\n\naccount = Account.from_key(os.environ[\"EVM_PRIVATE_KEY\"])\nclient = x402Client()\nregister_exact_evm_client(client, EthAccountSigner(account))\n\n\nasync def main():\n async with x402HttpxClient(client) as http:\n response = await http.get(\n \"https://apistead.qd.je/api/v2/spotify/track\",\n params={\"id\": \"4cOdK2wGLETKBW3PvgPWqT\"},\n )\n response.raise_for_status()\n print(response.json())\n\n\nasyncio.run(main())", "label": "Python: v2 track", "language": "python" } ], "price": { "min_usdc": 0.03, "max_usdc": 0.03, "unit": "per_call" }, "payment": { "protocol": "x402", "protocol_version": 2, "network": "eip155:8453", "network_name": "Base", "asset": "USDC", "price_min_usdc": 0.03, "price_max_usdc": 0.03, "unit": "per_call", "pay_to": "0x2E9804240E493DD8daeBa4F341a5086b92cde235", "authoritative_source": "402_challenge" }, "networks": [ "base" ], "primary_network": "base", "verification": "verified", "verification_detail": { "state": "verified", "verified_routes": 23, "total_routes": 23, "last_verified_at": "2026-11-13T13:53:04.807Z", "receipt_url": "https://basescan.org/tx/0x3f369c98f7753d3fda50495d941342c1880dd2480d6e80170fa235127b97ef1b" }, "verified_routes": 23, "total_routes": 23, "reliability": { "score": 79, "band": "caution", "uptime30d": 78.54, "lastCheckedAt": "2026-11-14T03:35:09.916Z" }, "last_verified_at": "2026-11-13T13:53:04.807Z", "receipt_url": "https://basescan.org/tx/0x3f369c98f7753d3fda50495d941342c1880dd2480d6e80170fa235127b97ef1b", "base_url": "https://apistead.qd.je/api/v2", "mcp_endpoint": "https://apistead.qd.je/mcp", "docs_url": "https://apistead.qd.je/api", "tags": [ "spotify", "spotify-v2", "spotify-search", "spotify-api", "search", "playlist", "album", "artist", "artist-playlists", "related-artists", "similar-albums", "top-tracks", "discography", "podcast", "episode", "audiobook", "genre", "user", "music", "tracks", "metadata", "no-login", "no-auth", "no-api-key", "catalogue", "music-search", "spotify-metadata" ], "use_cases": [ "Search Spotify for a track, album, artist or playlist without a login", "Find Spotify metadata without an OAuth token or API key", "Fetch a complete Spotify artist discography", "List an artist's playlists, related artists, discovered-on playlists and featuring playlists", "Search the Spotify catalogue by keyword", "Search podcasts, episodes, audiobooks or public users directly", "Fetch a Spotify podcast and its episodes", "Fetch an audiobook and its chapters", "Find Spotify genres and public user profiles", "Find albums similar to a track", "Summarize a Spotify playlist or album for a user", "Build a music discovery or recommendation workflow" ], "links": { "docs": "https://apistead.qd.je/api", "json": "https://x402.apistead.qd.je/api/apis/spotify-api-v2", "markdown": "https://x402.apistead.qd.je/api/apis/spotify-api-v2/md", "routes": "https://x402.apistead.qd.je/agent/routes?id=spotify-api-v2", "receipts": "https://x402.apistead.qd.je/agent/receipts?id=spotify-api-v2", "api_reference": "https://x402.apistead.qd.je/api", "mcp_guide": "https://x402.apistead.qd.je/mcp-docs", "skill": "https://x402.apistead.qd.je/skill", "openapi": "https://x402.apistead.qd.je/openapi.json" }, "demo": true, "long_description": "Spotify v2 is the additive generation of the APIStead Spotify API. The five v1 routes remain live; v2 adds keyword search, complete artist discographies, artist playlist sections, related artists and similar albums.\n\nEvery v2 route accepts a Spotify URL, URI or 22-character id and returns normalized JSON. Playlists return every ordered track with no song limit. Search returns tracks, albums, artists, playlists, podcasts, episodes, audiobooks, genres and users with per-type counts and totals. Dedicated search routes cover podcasts, episodes, audiobooks and users. Detail routes return podcasts, podcast episodes, episodes, audiobooks, audiobook chapters, genres and public user profiles. Artist routes return playlists, related artists, discovered-on playlists and featuring playlists. Discography returns the artist's release sections and marks `complete: true` when the full discography was read.\n\nThe API reads public Spotify catalogue metadata. No Spotify account, login, OAuth token or API key is required from the buyer. This is an independent APIStead API and is not affiliated with or endorsed by Spotify.\n\nPlaylist creation dates and per-track added dates are not exposed in public metadata, so those fields are not returned. Playback control, downloads and user-library access are not included.", "provider_detail": { "slug": "apistead-labs", "name": "APIStead Labs", "description": "First-party data APIs built and verified by APIStead. US ZIP codes, IP intelligence, geocoding, weather, email and public records, all priced per call.", "website": "https://apistead.qd.je", "verified": true, "firstParty": true }, "routes": [ { "method": "GET", "path": "/spotify/search", "url": "https://apistead.qd.je/api/v2/spotify/search", "price_usdc": 0.03, "pay_to": "0x2E9804240E493DD8daeBa4F341a5086b92cde235", "description": "Search Spotify tracks, albums, artists, playlists, podcasts, episodes, audiobooks, genres and users.", "example_request": "GET https://apistead.qd.je/api/v2/spotify/search?q=daft%20punk&type=all&limit=2", "example_response": { "note": "Spotify catalogue search, normalized for agents. Returns public tracks, albums, artists, playlists, podcasts, episodes, audiobooks, genres and users. Playback control, downloads and user-library access are not included.", "type": "all", "limit": 2, "query": "daft punk", "users": [], "albums": [ { "id": "5WulAOx9ilWy1h8UGZ1gkI", "uri": "spotify:album:5WulAOx9ilWy1h8UGZ1gkI", "url": "https://open.spotify.com/album/5WulAOx9ilWy1h8UGZ1gkI", "name": "Deadbeat", "type": "album", "artists": [ { "id": "5INjqkS1o8h1imAzPqGZBb", "url": "https://open.spotify.com/artist/5INjqkS1o8h1imAzPqGZBb", "name": "Tame Impala" } ], "cover_image": "https://i.scdn.co/image/ab67616d0000b273208500450dcd0fd294d7bd3b", "track_count": null, "release_date": "2025-10-17" } ], "counts": { "users": 0, "albums": 1, "genres": 0, "tracks": 1, "artists": 1, "episodes": 0, "podcasts": 0, "playlists": 1, "audiobooks": 0 }, "genres": [], "offset": 0, "source": "spotify", "totals": { "users": 0, "albums": 1, "genres": 0, "tracks": 1, "artists": 1, "episodes": 0, "podcasts": 0, "playlists": 1, "audiobooks": 0 }, "tracks": [ { "id": "4whkhyXTrTgHKZzkUvdwoq", "uri": "spotify:track:4whkhyXTrTgHKZzkUvdwoq", "url": "https://open.spotify.com/track/4whkhyXTrTgHKZzkUvdwoq", "album": { "id": "5WulAOx9ilWy1h8UGZ1gkI", "url": "https://open.spotify.com/album/5WulAOx9ilWy1h8UGZ1gkI", "name": "Deadbeat", "release_date": "2025-10-17" }, "title": "My Old Ways", "artists": [ { "id": "5INjqkS1o8h1imAzPqGZBb", "url": "https://open.spotify.com/artist/5INjqkS1o8h1imAzPqGZBb", "name": "Tame Impala" } ], "artwork": "https://i.scdn.co/image/ab67616d0000b273208500450dcd0fd294d7bd3b", "explicit": true, "playable": true, "position": 1, "duration_ms": 298783, "preview_url": "https://p.scdn.co/mp3-preview/7a7303f1efe59a3ef469aed4ea5fa7a3ef0e677d", "release_date": "2025-10-17", "duration_formatted": "4:59" } ], "artists": [ { "id": "5INjqkS1o8h1imAzPqGZBb", "uri": "spotify:artist:5INjqkS1o8h1imAzPqGZBb", "url": "https://open.spotify.com/artist/5INjqkS1o8h1imAzPqGZBb", "name": "Tame Impala", "image": "https://i.scdn.co/image/ab6761610000e5ebe412a782245eb20d9626c601" } ], "preview": false, "episodes": [], "podcasts": [], "playlists": [ { "id": "37i9dQZF1DXcBWIGoYBM5M", "uri": "spotify:playlist:37i9dQZF1DXcBWIGoYBM5M", "url": "https://open.spotify.com/playlist/37i9dQZF1DXcBWIGoYBM5M", "name": "Daft Punk Mix", "owner": { "id": "spotify", "url": "https://open.spotify.com/user/spotify", "name": "Spotify", "avatar": null }, "cover_image": "https://i.scdn.co/image/ab67616d0000b2730893a0c33fd4b8497b0ef2f6", "description": "", "track_count": null } ], "audiobooks": [], "retrieved_at": "2026-11-12T00:00:00Z" }, "verified": true, "last_checked_at": "2026-11-14T03:35:09.788Z", "latency_ms": 3, "uptime_30d": 80.65 }, { "method": "GET", "path": "/spotify/playlist", "url": "https://apistead.qd.je/api/v2/spotify/playlist", "price_usdc": 0.03, "pay_to": "0x2E9804240E493DD8daeBa4F341a5086b92cde235", "description": "Spotify playlist metadata and every ordered track. There is no song limit.", "example_request": "GET https://apistead.qd.je/api/v2/spotify/playlist?url=https://open.spotify.com/playlist/37i9dQZF1DXcBWIGoYBM5M&include_albums=true&album_limit=10", "example_response": { "note": "Spotify playlist metadata, normalized for agents. Playback control, downloads and user-library access are not included.", "source": "spotify", "tracks": [ { "id": "4whkhyXTrTgHKZzkUvdwoq", "uri": "spotify:track:4whkhyXTrTgHKZzkUvdwoq", "url": "https://open.spotify.com/track/4whkhyXTrTgHKZzkUvdwoq", "album": { "id": "5WulAOx9ilWy1h8UGZ1gkI", "url": "https://open.spotify.com/album/5WulAOx9ilWy1h8UGZ1gkI", "name": "Deadbeat", "release_date": "2025-10-17" }, "title": "My Old Ways", "artists": [ { "id": "5INjqkS1o8h1imAzPqGZBb", "url": "https://open.spotify.com/artist/5INjqkS1o8h1imAzPqGZBb", "name": "Tame Impala" } ], "artwork": "https://i.scdn.co/image/ab67616d0000b273208500450dcd0fd294d7bd3b", "explicit": true, "playable": true, "position": 1, "duration_ms": 298783, "preview_url": "https://p.scdn.co/mp3-preview/7a7303f1efe59a3ef469aed4ea5fa7a3ef0e677d", "release_date": "2025-10-17", "duration_formatted": "4:59" } ], "preview": false, "summary": { "duration_ms": 298783, "track_count": 1, "unique_albums": 1, "explicit_count": 1, "unique_artists": 1, "returned_tracks": 1, "duration_formatted": "4:59", "average_track_duration_ms": 298783 }, "playlist": { "id": "37i9dQZF1DXcBWIGoYBM5M", "uri": "spotify:playlist:37i9dQZF1DXcBWIGoYBM5M", "url": "https://open.spotify.com/playlist/37i9dQZF1DXcBWIGoYBM5M", "name": "Today's Top Hits", "owner": { "id": "spotify", "url": "https://open.spotify.com/user/spotify", "name": "Spotify", "avatar": "https://i.scdn.co/image/ab6775700000ee8555c25988a6ac314394d3fbf5" }, "saves": 3500000, "playable": true, "cover_image": "https://i.scdn.co/image/ab67616d0000b2730893a0c33fd4b8497b0ef2f6", "description": "The hottest 50.", "duration_ms": 199000, "track_count": 1, "explicit_count": 0, "duration_formatted": "3:19" }, "retrieved_at": "2026-11-12T00:00:00Z", "album_enrichment": { "limit": 10, "limited": false, "requested": true, "enriched_tracks": 1 } }, "verified": true, "last_checked_at": "2026-11-14T03:35:09.735Z", "latency_ms": 3, "uptime_30d": 79.03 }, { "method": "GET", "path": "/spotify/album", "url": "https://apistead.qd.je/api/v2/spotify/album", "price_usdc": 0.03, "pay_to": "0x2E9804240E493DD8daeBa4F341a5086b92cde235", "description": "Spotify album metadata and full track list.", "example_request": "GET https://apistead.qd.je/api/v2/spotify/album?url=https://open.spotify.com/album/5WulAOx9ilWy1h8UGZ1gkI", "example_response": { "note": "Spotify album metadata, normalized for agents. Playback control, downloads and user-library access are not included.", "album": { "id": "5WulAOx9ilWy1h8UGZ1gkI", "uri": "spotify:album:5WulAOx9ilWy1h8UGZ1gkI", "url": "https://open.spotify.com/album/5WulAOx9ilWy1h8UGZ1gkI", "name": "Deadbeat", "type": "album", "artists": [ { "id": "5INjqkS1o8h1imAzPqGZBb", "url": "https://open.spotify.com/artist/5INjqkS1o8h1imAzPqGZBb", "name": "Tame Impala" } ], "playable": true, "copyrights": [ "℗ 2025 Columbia Records, a Division of Sony Music Entertainment, under exclusive license from Tame Impala" ], "cover_image": "https://i.scdn.co/image/ab67616d0000b273208500450dcd0fd294d7bd3b", "duration_ms": 2600000, "track_count": 12, "release_date": "2025-10-17", "explicit_count": 1, "duration_formatted": "43:20" }, "source": "spotify", "tracks": [ { "id": "4whkhyXTrTgHKZzkUvdwoq", "uri": "spotify:track:4whkhyXTrTgHKZzkUvdwoq", "url": "https://open.spotify.com/track/4whkhyXTrTgHKZzkUvdwoq", "album": { "id": "5WulAOx9ilWy1h8UGZ1gkI", "url": "https://open.spotify.com/album/5WulAOx9ilWy1h8UGZ1gkI", "name": "Deadbeat", "release_date": "2025-10-17" }, "title": "My Old Ways", "artists": [ { "id": "5INjqkS1o8h1imAzPqGZBb", "url": "https://open.spotify.com/artist/5INjqkS1o8h1imAzPqGZBb", "name": "Tame Impala" } ], "artwork": "https://i.scdn.co/image/ab67616d0000b273208500450dcd0fd294d7bd3b", "explicit": true, "playable": true, "position": 1, "duration_ms": 298783, "preview_url": "https://p.scdn.co/mp3-preview/7a7303f1efe59a3ef469aed4ea5fa7a3ef0e677d", "release_date": "2025-10-17", "duration_formatted": "4:59" } ], "preview": false, "summary": { "duration_ms": 2600000, "track_count": 12, "explicit_count": 1, "unique_artists": 1, "returned_tracks": 12, "duration_formatted": "43:20", "average_track_duration_ms": 216667 }, "retrieved_at": "2026-11-12T00:00:00Z" }, "verified": true, "last_checked_at": "2026-11-14T03:35:09.683Z", "latency_ms": 8, "uptime_30d": 80.65 }, { "method": "GET", "path": "/spotify/artist", "url": "https://apistead.qd.je/api/v2/spotify/artist", "price_usdc": 0.03, "pay_to": "0x2E9804240E493DD8daeBa4F341a5086b92cde235", "description": "Spotify artist profile and top tracks.", "example_request": "GET https://apistead.qd.je/api/v2/spotify/artist?url=https://open.spotify.com/artist/5INjqkS1o8h1imAzPqGZBb", "example_response": { "note": "Spotify artist metadata, normalized for agents. Bio is included when Spotify publishes it. Playback control, downloads and user-library access are not included.", "artist": { "id": "5INjqkS1o8h1imAzPqGZBb", "bio": "Kevin Parker has emerged as one of the most influential voices of the last decade.", "uri": "spotify:artist:5INjqkS1o8h1imAzPqGZBb", "url": "https://open.spotify.com/artist/5INjqkS1o8h1imAzPqGZBb", "name": "Tame Impala", "image": "https://i.scdn.co/image/ab6761610000e5ebe412a782245eb20d9626c601", "followers": 12382756, "world_rank": 31, "monthly_listeners": 65445089 }, "source": "spotify", "preview": false, "summary": { "top_tracks": 5, "duration_ms": 1200000, "explicit_count": 2, "unique_artists": 1, "duration_formatted": "20:00" }, "top_tracks": [ { "id": "4whkhyXTrTgHKZzkUvdwoq", "uri": "spotify:track:4whkhyXTrTgHKZzkUvdwoq", "url": "https://open.spotify.com/track/4whkhyXTrTgHKZzkUvdwoq", "album": { "id": "5WulAOx9ilWy1h8UGZ1gkI", "url": "https://open.spotify.com/album/5WulAOx9ilWy1h8UGZ1gkI", "name": "Deadbeat", "release_date": "2025-10-17" }, "title": "My Old Ways", "artists": [ { "id": "5INjqkS1o8h1imAzPqGZBb", "url": "https://open.spotify.com/artist/5INjqkS1o8h1imAzPqGZBb", "name": "Tame Impala" } ], "artwork": "https://i.scdn.co/image/ab67616d0000b273208500450dcd0fd294d7bd3b", "explicit": true, "playable": true, "position": 1, "duration_ms": 298783, "preview_url": "https://p.scdn.co/mp3-preview/7a7303f1efe59a3ef469aed4ea5fa7a3ef0e677d", "release_date": "2025-10-17", "duration_formatted": "4:59" } ], "retrieved_at": "2026-11-12T00:00:00Z" }, "verified": true, "last_checked_at": "2026-11-14T03:35:09.889Z", "latency_ms": 7, "uptime_30d": 85.07 }, { "method": "GET", "path": "/spotify/artist/top-tracks", "url": "https://apistead.qd.je/api/v2/spotify/artist/top-tracks", "price_usdc": 0.03, "pay_to": "0x2E9804240E493DD8daeBa4F341a5086b92cde235", "description": "Spotify artist top tracks with album context.", "example_request": "GET https://apistead.qd.je/api/v2/spotify/artist/top-tracks?url=https://open.spotify.com/artist/5INjqkS1o8h1imAzPqGZBb&limit=2", "example_response": { "note": "Spotify artist top tracks, normalized for agents. Each track includes album context. Playback control, downloads and user-library access are not included.", "artist": { "id": "5INjqkS1o8h1imAzPqGZBb", "bio": "Kevin Parker has emerged as one of the most influential voices of the last decade.", "uri": "spotify:artist:5INjqkS1o8h1imAzPqGZBb", "url": "https://open.spotify.com/artist/5INjqkS1o8h1imAzPqGZBb", "name": "Tame Impala", "image": "https://i.scdn.co/image/ab6761610000e5ebe412a782245eb20d9626c601", "followers": 12382756, "world_rank": 31, "monthly_listeners": 65445089 }, "source": "spotify", "preview": false, "summary": { "duration_ms": 480000, "explicit_count": 1, "unique_artists": 1, "requested_limit": 2, "returned_tracks": 2, "duration_formatted": "8:00", "available_top_tracks": 5 }, "top_tracks": [ { "id": "4whkhyXTrTgHKZzkUvdwoq", "uri": "spotify:track:4whkhyXTrTgHKZzkUvdwoq", "url": "https://open.spotify.com/track/4whkhyXTrTgHKZzkUvdwoq", "album": { "id": "5WulAOx9ilWy1h8UGZ1gkI", "url": "https://open.spotify.com/album/5WulAOx9ilWy1h8UGZ1gkI", "name": "Deadbeat", "release_date": "2025-10-17" }, "title": "My Old Ways", "artists": [ { "id": "5INjqkS1o8h1imAzPqGZBb", "url": "https://open.spotify.com/artist/5INjqkS1o8h1imAzPqGZBb", "name": "Tame Impala" } ], "artwork": "https://i.scdn.co/image/ab67616d0000b273208500450dcd0fd294d7bd3b", "explicit": true, "playable": true, "position": 1, "duration_ms": 298783, "preview_url": "https://p.scdn.co/mp3-preview/7a7303f1efe59a3ef469aed4ea5fa7a3ef0e677d", "release_date": "2025-10-17", "duration_formatted": "4:59" } ], "retrieved_at": "2026-11-12T00:00:00Z" }, "verified": true, "last_checked_at": "2026-11-14T03:35:09.833Z", "latency_ms": 5, "uptime_30d": 81.97 }, { "method": "GET", "path": "/spotify/artist/discography", "url": "https://apistead.qd.je/api/v2/spotify/artist/discography", "price_usdc": 0.03, "pay_to": "0x2E9804240E493DD8daeBa4F341a5086b92cde235", "description": "Spotify artist discography with complete release sections. The example response is abbreviated; the live route returns all albums, singles and EPs by default.", "example_request": "GET https://apistead.qd.je/api/v2/spotify/artist/discography?url=https://open.spotify.com/artist/5INjqkS1o8h1imAzPqGZBb", "example_response": { "note": "Spotify discography, normalized for agents. Albums, singles and EPs cover the artist's full discography; Popular releases and Appears On come from the artist overview. Playback control, downloads and user-library access are not included.", "artist": { "id": "5INjqkS1o8h1imAzPqGZBb", "bio": "Kevin Parker has emerged as one of the most influential voices of the last decade.", "uri": "spotify:artist:5INjqkS1o8h1imAzPqGZBb", "url": "https://open.spotify.com/artist/5INjqkS1o8h1imAzPqGZBb", "name": "Tame Impala", "image": "https://i.scdn.co/image/ab6761610000e5ebe412a782245eb20d9626c601", "followers": 12382756, "world_rank": 31, "monthly_listeners": 65445089 }, "source": "spotify", "preview": false, "summary": { "scope": "full_discography", "albums": 1, "complete": true, "appears_on": 1, "total_releases": 6, "singles_and_eps": 1, "appears_on_total": 1, "popular_releases": 1, "appears_on_complete": true }, "sections": { "albums": [ { "id": "5WulAOx9ilWy1h8UGZ1gkI", "uri": "spotify:album:5WulAOx9ilWy1h8UGZ1gkI", "url": "https://open.spotify.com/album/5WulAOx9ilWy1h8UGZ1gkI", "type": "album", "year": 2025, "title": "Deadbeat", "section": "albums", "position": 1, "cover_image": "https://i.scdn.co/image/ab67616d0000b273208500450dcd0fd294d7bd3b", "release_date": "2025-10-17" } ], "appears_on": [ { "id": "4wtZQMNTC1O79kDxMBsEan", "uri": "spotify:album:4wtZQMNTC1O79kDxMBsEan", "url": "https://open.spotify.com/album/4wtZQMNTC1O79kDxMBsEan", "type": "album", "year": 2023, "title": "Cracker Island", "section": "appears_on", "position": 1, "cover_image": "https://i.scdn.co/image/ab67616d0000b273208500450dcd0fd294d7bd3b", "release_date": "2023-02-24" } ], "singles_and_eps": [ { "id": "1V8Qu6CwkBfYucnCWxynq8", "uri": "spotify:album:1V8Qu6CwkBfYucnCWxynq8", "url": "https://open.spotify.com/album/1V8Qu6CwkBfYucnCWxynq8", "type": "single", "year": 2026, "title": "Flower In A Hurricane", "section": "singles_and_eps", "position": 1, "cover_image": "https://i.scdn.co/image/ab67616d0000b273208500450dcd0fd294d7bd3b", "release_date": "2026-10-15" } ], "popular_releases": [ { "id": "5WulAOx9ilWy1h8UGZ1gkI", "uri": "spotify:album:5WulAOx9ilWy1h8UGZ1gkI", "url": "https://open.spotify.com/album/5WulAOx9ilWy1h8UGZ1gkI", "type": "album", "year": 2025, "title": "Deadbeat", "section": "popular_releases", "position": 1, "cover_image": "https://i.scdn.co/image/ab67616d0000b273208500450dcd0fd294d7bd3b", "release_date": "2025-10-17" } ] }, "retrieved_at": "2026-11-12T00:00:00Z" }, "verified": true, "last_checked_at": "2026-11-14T03:35:09.861Z", "latency_ms": 6, "uptime_30d": 82.54 }, { "method": "GET", "path": "/spotify/track", "url": "https://apistead.qd.je/api/v2/spotify/track", "price_usdc": 0.03, "pay_to": "0x2E9804240E493DD8daeBa4F341a5086b92cde235", "description": "Spotify track metadata.", "example_request": "GET https://apistead.qd.je/api/v2/spotify/track?url=https://open.spotify.com/track/4whkhyXTrTgHKZzkUvdwoq", "example_response": { "note": "Spotify track metadata, normalized for agents. Playback control, downloads and user-library access are not included.", "track": { "id": "4whkhyXTrTgHKZzkUvdwoq", "uri": "spotify:track:4whkhyXTrTgHKZzkUvdwoq", "url": "https://open.spotify.com/track/4whkhyXTrTgHKZzkUvdwoq", "album": { "id": "5WulAOx9ilWy1h8UGZ1gkI", "url": "https://open.spotify.com/album/5WulAOx9ilWy1h8UGZ1gkI", "name": "Deadbeat", "release_date": "2025-10-17" }, "title": "My Old Ways", "artists": [ { "id": "5INjqkS1o8h1imAzPqGZBb", "url": "https://open.spotify.com/artist/5INjqkS1o8h1imAzPqGZBb", "name": "Tame Impala" } ], "artwork": "https://i.scdn.co/image/ab67616d0000b273208500450dcd0fd294d7bd3b", "explicit": true, "playable": true, "copyrights": [ "℗ 2025 Columbia Records, a Division of Sony Music Entertainment, under exclusive license from Tame Impala" ], "duration_ms": 298783, "preview_url": "https://p.scdn.co/mp3-preview/7a7303f1efe59a3ef469aed4ea5fa7a3ef0e677d", "release_date": "2025-10-17", "duration_formatted": "4:59" }, "source": "spotify", "preview": false, "retrieved_at": "2026-11-12T00:00:00Z" }, "verified": true, "last_checked_at": "2026-11-14T03:35:09.801Z", "latency_ms": 4, "uptime_30d": 80.65 }, { "method": "GET", "path": "/spotify/podcast", "url": "https://apistead.qd.je/api/v2/spotify/podcast", "price_usdc": 0.03, "pay_to": "0x2E9804240E493DD8daeBa4F341a5086b92cde235", "description": "Spotify podcast metadata from a podcast link.", "example_request": "GET https://apistead.qd.je/api/v2/spotify/podcast?id=79CkJF3UJTHFV8Dse3Oy0P", "example_response": { "note": "Spotify podcast metadata, normalized for agents. Playback control, downloads and user-library access are not included.", "source": "spotify", "podcast": { "id": "79CkJF3UJTHFV8Dse3Oy0P", "uri": "spotify:show:79CkJF3UJTHFV8Dse3Oy0P", "url": "https://open.spotify.com/show/79CkJF3UJTHFV8Dse3Oy0P", "name": "Huberman Lab", "rating": { "total": 132040, "average": 4.9 }, "topics": [ "Health", "Science" ], "explicit": true, "playable": true, "publisher": "Scicomm Media", "media_type": "MIXED", "cover_image": "https://i.scdn.co/image/ab6765630000ba8a66aed32f8066a72781b3b12a", "description": "The Huberman Lab podcast discusses neuroscience and science-based tools for everyday life.", "total_episodes": 458 }, "preview": false, "retrieved_at": "2026-11-12T00:00:00Z" }, "verified": true, "last_checked_at": "2026-11-14T03:35:09.728Z", "latency_ms": 3, "uptime_30d": 80 }, { "method": "GET", "path": "/spotify/podcast/episodes", "url": "https://apistead.qd.je/api/v2/spotify/podcast/episodes", "price_usdc": 0.03, "pay_to": "0x2E9804240E493DD8daeBa4F341a5086b92cde235", "description": "Spotify podcast episodes with limit and offset.", "example_request": "GET https://apistead.qd.je/api/v2/spotify/podcast/episodes?id=79CkJF3UJTHFV8Dse3Oy0P&limit=2", "example_response": { "note": "Spotify podcast episodes, normalized for agents. Playback control, downloads and user-library access are not included.", "limit": 2, "total": 458, "offset": 0, "source": "spotify", "podcast": { "id": "79CkJF3UJTHFV8Dse3Oy0P", "uri": "spotify:show:79CkJF3UJTHFV8Dse3Oy0P", "url": "https://open.spotify.com/show/79CkJF3UJTHFV8Dse3Oy0P", "name": "Huberman Lab", "cover_image": "https://i.scdn.co/image/ab6765630000ba8a66aed32f8066a72781b3b12a" }, "preview": false, "episodes": [ { "id": "2jMJRxwPQPErrwRGo8duQQ", "uri": "spotify:episode:2jMJRxwPQPErrwRGo8duQQ", "url": "https://open.spotify.com/episode/2jMJRxwPQPErrwRGo8duQQ", "title": "Overcome Addictions & Obsessions of All Kinds", "artwork": "https://i.scdn.co/image/ab67656300005f1fa233a74360db2864b66acf79", "podcast": { "id": "79CkJF3UJTHFV8Dse3Oy0P", "url": "https://open.spotify.com/show/79CkJF3UJTHFV8Dse3Oy0P", "name": "Huberman Lab" }, "explicit": false, "playable": true, "description": "A conversation about dopamine, habits and compulsive behaviour.", "duration_ms": 8210602, "media_types": [ "AUDIO", "VIDEO" ], "preview_url": "https://p.scdn.co/mp3-preview/e6e12cd874abb5a8684c059f7e884f47e64e6acd.mp3", "release_date": "2026-11-09", "duration_formatted": "2:16:50" } ], "retrieved_at": "2026-11-12T00:00:00Z" }, "verified": true, "last_checked_at": "2026-11-14T03:35:09.814Z", "latency_ms": 3, "uptime_30d": 75 }, { "method": "GET", "path": "/spotify/episode", "url": "https://apistead.qd.je/api/v2/spotify/episode", "price_usdc": 0.03, "pay_to": "0x2E9804240E493DD8daeBa4F341a5086b92cde235", "description": "Spotify episode metadata from an episode link.", "example_request": "GET https://apistead.qd.je/api/v2/spotify/episode?id=2jMJRxwPQPErrwRGo8duQQ", "example_response": { "note": "Spotify episode metadata, normalized for agents. Playback control, downloads and user-library access are not included.", "source": "spotify", "episode": { "id": "2jMJRxwPQPErrwRGo8duQQ", "uri": "spotify:episode:2jMJRxwPQPErrwRGo8duQQ", "url": "https://open.spotify.com/episode/2jMJRxwPQPErrwRGo8duQQ", "title": "Overcome Addictions & Obsessions of All Kinds", "artwork": "https://i.scdn.co/image/ab67656300005f1fa233a74360db2864b66acf79", "podcast": { "id": "79CkJF3UJTHFV8Dse3Oy0P", "url": "https://open.spotify.com/show/79CkJF3UJTHFV8Dse3Oy0P", "name": "Huberman Lab" }, "explicit": false, "playable": true, "description": "A conversation about dopamine, habits and compulsive behaviour.", "duration_ms": 8210602, "media_types": [ "AUDIO", "VIDEO" ], "preview_url": "https://p.scdn.co/mp3-preview/e6e12cd874abb5a8684c059f7e884f47e64e6acd.mp3", "release_date": "2026-11-09", "duration_formatted": "2:16:50" }, "preview": false, "retrieved_at": "2026-11-12T00:00:00Z" }, "verified": true, "last_checked_at": "2026-11-14T03:35:09.807Z", "latency_ms": 3, "uptime_30d": 78.57 }, { "method": "GET", "path": "/spotify/audiobook", "url": "https://apistead.qd.je/api/v2/spotify/audiobook", "price_usdc": 0.03, "pay_to": "0x2E9804240E493DD8daeBa4F341a5086b92cde235", "description": "Spotify audiobook metadata from an audiobook link.", "example_request": "GET https://apistead.qd.je/api/v2/spotify/audiobook?id=0Db3QPOPFO0SYx0TGG0mim", "example_response": { "note": "Spotify audiobook metadata, normalized for agents. Audiobook audio, downloads and user-library access are not included.", "source": "spotify", "preview": false, "audiobook": { "id": "0Db3QPOPFO0SYx0TGG0mim", "uri": "spotify:show:0Db3QPOPFO0SYx0TGG0mim", "url": "https://open.spotify.com/show/0Db3QPOPFO0SYx0TGG0mim", "price": { "amount": 32.9, "currency": "USD", "formatted": "$32.90" }, "title": "Protocols: An Operating Manual for the Human Body", "rating": { "total": 188, "average": 4.87 }, "authors": [ "Andrew Huberman" ], "explicit": false, "language": "en", "playable": false, "narrators": [ "Andrew D. Huberman Ph.D." ], "publisher": "Andrew D. Huberman Ph.D.", "cover_image": "https://i.scdn.co/image/ab676663000022a8d702d1894bc0c54c801f5ad5", "description": "A science-based operating manual for the human body.", "duration_ms": 65133789, "release_date": "2026-09-15", "chapters_count": 64, "duration_formatted": "18:05:33" }, "retrieved_at": "2026-11-12T00:00:00Z" }, "verified": true, "last_checked_at": "2026-11-14T03:35:09.851Z", "latency_ms": 5, "uptime_30d": 80.36 }, { "method": "GET", "path": "/spotify/audiobook/chapters", "url": "https://apistead.qd.je/api/v2/spotify/audiobook/chapters", "price_usdc": 0.03, "pay_to": "0x2E9804240E493DD8daeBa4F341a5086b92cde235", "description": "Spotify audiobook chapters with limit and offset.", "example_request": "GET https://apistead.qd.je/api/v2/spotify/audiobook/chapters?id=0Db3QPOPFO0SYx0TGG0mim&limit=2", "example_response": { "note": "Spotify audiobook chapters, normalized for agents. Audiobook audio, downloads and user-library access are not included.", "limit": 2, "total": 64, "offset": 0, "source": "spotify", "preview": false, "chapters": [ { "id": "6z4sRbQH1K2drBheUVeytw", "uri": "spotify:episode:6z4sRbQH1K2drBheUVeytw", "url": "https://open.spotify.com/episode/6z4sRbQH1K2drBheUVeytw", "title": "Track 1", "artwork": "https://i.scdn.co/image/ab676663000022a8d702d1894bc0c54c801f5ad5", "explicit": false, "playable": false, "position": 1, "audiobook": { "id": "0Db3QPOPFO0SYx0TGG0mim", "url": "https://open.spotify.com/show/0Db3QPOPFO0SYx0TGG0mim", "title": "Protocols: An Operating Manual for the Human Body" }, "description": "", "duration_ms": 66507, "preview_url": null, "duration_formatted": "1:07" } ], "audiobook": { "id": "0Db3QPOPFO0SYx0TGG0mim", "uri": "spotify:show:0Db3QPOPFO0SYx0TGG0mim", "url": "https://open.spotify.com/show/0Db3QPOPFO0SYx0TGG0mim", "title": "Protocols: An Operating Manual for the Human Body", "cover_image": "https://i.scdn.co/image/ab676663000022a8d702d1894bc0c54c801f5ad5" }, "retrieved_at": "2026-11-12T00:00:00Z" }, "verified": true, "last_checked_at": "2026-11-14T03:35:09.795Z", "latency_ms": 4, "uptime_30d": 78.57 }, { "method": "GET", "path": "/spotify/genres", "url": "https://apistead.qd.je/api/v2/spotify/genres", "price_usdc": 0.03, "pay_to": "0x2E9804240E493DD8daeBa4F341a5086b92cde235", "description": "Search Spotify genres by keyword.", "example_request": "GET https://apistead.qd.je/api/v2/spotify/genres?q=pop&limit=2", "example_response": { "note": "Spotify genres, normalized for agents.", "query": "pop", "total": 37, "genres": [ { "id": "0JQ5DAqbMKFEC4WFtoNRpw", "uri": "spotify:genre:0JQ5DAqbMKFEC4WFtoNRpw", "name": "Pop", "image": "https://t.scdn.co/media/derived/pop-274x274_447148649685019f5e2a03a39e78ba52_0_0_274_274.jpg" } ], "source": "spotify", "preview": false, "retrieved_at": "2026-11-12T00:00:00Z" }, "verified": true, "last_checked_at": "2026-11-14T03:35:09.586Z", "latency_ms": 4, "uptime_30d": 75 }, { "method": "GET", "path": "/spotify/user", "url": "https://apistead.qd.je/api/v2/spotify/user", "price_usdc": 0.03, "pay_to": "0x2E9804240E493DD8daeBa4F341a5086b92cde235", "description": "Spotify public user profile and public playlists.", "example_request": "GET https://apistead.qd.je/api/v2/spotify/user?id=spotify", "example_response": { "note": "Spotify public user profile, normalized for agents. Private account data is not included.", "user": { "id": "spotify", "uri": "spotify:user:spotify", "url": "https://open.spotify.com/user/spotify", "image": "https://i.scdn.co/image/ab6775700000ee8555c25988a6ac314394d3fbf5", "username": "spotify", "display_name": "Spotify", "playlists_count": 1000, "public_playlists": [ { "id": "37i9dQZF1DXcBWIGoYBM5M", "uri": "spotify:playlist:37i9dQZF1DXcBWIGoYBM5M", "url": "https://open.spotify.com/playlist/37i9dQZF1DXcBWIGoYBM5M", "name": "Today's Top Hits", "followers": 33597453, "cover_image": null } ] }, "source": "spotify", "preview": false, "retrieved_at": "2026-11-12T00:00:00Z" }, "verified": true, "last_checked_at": "2026-11-14T03:35:09.825Z", "latency_ms": 7, "uptime_30d": 78.57 }, { "method": "GET", "path": "/spotify/search/podcasts", "url": "https://apistead.qd.je/api/v2/spotify/search/podcasts", "price_usdc": 0.03, "pay_to": "0x2E9804240E493DD8daeBa4F341a5086b92cde235", "description": "Search Spotify podcasts by keyword.", "example_request": "GET https://apistead.qd.je/api/v2/spotify/search/podcasts?q=huberman&limit=1", "example_response": { "note": "Spotify podcast search, normalized for agents. Playback control, downloads and user-library access are not included.", "type": "podcast", "limit": 1, "query": "huberman", "total": 209, "offset": 0, "source": "spotify", "preview": false, "podcasts": [ { "id": "79CkJF3UJTHFV8Dse3Oy0P", "uri": "spotify:show:79CkJF3UJTHFV8Dse3Oy0P", "url": "https://open.spotify.com/show/79CkJF3UJTHFV8Dse3Oy0P", "name": "Huberman Lab", "publisher": "Scicomm Media", "media_type": "MIXED", "cover_image": "https://i.scdn.co/image/ab6765630000ba8a66aed32f8066a72781b3b12a" } ], "retrieved_at": "2026-11-12T00:00:00Z" }, "verified": true, "last_checked_at": "2026-11-14T03:35:09.774Z", "latency_ms": 4, "uptime_30d": 74.07 }, { "method": "GET", "path": "/spotify/search/episodes", "url": "https://apistead.qd.je/api/v2/spotify/search/episodes", "price_usdc": 0.03, "pay_to": "0x2E9804240E493DD8daeBa4F341a5086b92cde235", "description": "Search Spotify podcast episodes by keyword.", "example_request": "GET https://apistead.qd.je/api/v2/spotify/search/episodes?q=dopamine&limit=1", "example_response": { "note": "Spotify episode search, normalized for agents. Playback control, downloads and user-library access are not included.", "type": "episode", "limit": 1, "query": "dopamine", "total": 3, "offset": 0, "source": "spotify", "preview": false, "episodes": [ { "id": "2jMJRxwPQPErrwRGo8duQQ", "uri": "spotify:episode:2jMJRxwPQPErrwRGo8duQQ", "url": "https://open.spotify.com/episode/2jMJRxwPQPErrwRGo8duQQ", "title": "Overcome Addictions & Obsessions of All Kinds", "artwork": "https://i.scdn.co/image/ab67656300005f1fa233a74360db2864b66acf79", "podcast": { "id": "79CkJF3UJTHFV8Dse3Oy0P", "url": "https://open.spotify.com/show/79CkJF3UJTHFV8Dse3Oy0P", "name": "Huberman Lab" }, "explicit": false, "playable": true, "description": "A conversation about dopamine, habits and compulsive behaviour.", "duration_ms": 8210602, "release_date": "2026-11-09", "duration_formatted": "2:16:50" } ], "retrieved_at": "2026-11-12T00:00:00Z" }, "verified": true, "last_checked_at": "2026-11-14T03:35:09.840Z", "latency_ms": 4, "uptime_30d": 77.78 }, { "method": "GET", "path": "/spotify/search/audiobooks", "url": "https://apistead.qd.je/api/v2/spotify/search/audiobooks", "price_usdc": 0.03, "pay_to": "0x2E9804240E493DD8daeBa4F341a5086b92cde235", "description": "Search Spotify audiobooks by keyword.", "example_request": "GET https://apistead.qd.je/api/v2/spotify/search/audiobooks?q=atomic%20habits&limit=1", "example_response": { "note": "Spotify audiobook search, normalized for agents. Audiobook audio, downloads and user-library access are not included.", "type": "audiobook", "limit": 1, "query": "atomic habits", "total": 2, "offset": 0, "source": "spotify", "preview": false, "audiobooks": [ { "id": "40ygvasZaqVMMBkgYoUy8C", "uri": "spotify:show:40ygvasZaqVMMBkgYoUy8C", "url": "https://open.spotify.com/show/40ygvasZaqVMMBkgYoUy8C", "title": "Atomic Habits: An Easy & Proven Way to Build Good Habits & Break Bad Ones", "authors": [ "James Clear" ], "cover_image": "https://i.scdn.co/image/ab676663000022a843d3293222816f8305c3eaaa", "description": "Author(s): James Clear Narrator(s): James Clear. Tiny changes, remarkable results.", "release_date": "2018-10-16" } ], "retrieved_at": "2026-11-12T00:00:00Z" }, "verified": true, "last_checked_at": "2026-11-14T03:35:09.551Z", "latency_ms": 7, "uptime_30d": 74.07 }, { "method": "GET", "path": "/spotify/search/users", "url": "https://apistead.qd.je/api/v2/spotify/search/users", "price_usdc": 0.03, "pay_to": "0x2E9804240E493DD8daeBa4F341a5086b92cde235", "description": "Search Spotify public user profiles by keyword.", "example_request": "GET https://apistead.qd.je/api/v2/spotify/search/users?q=huberman&limit=1", "example_response": { "note": "Spotify public user search, normalized for agents. Private account data is not included.", "type": "user", "limit": 1, "query": "huberman", "total": 195, "users": [ { "id": "31ad2j7c46tsiqvkw2msrjfmgky4", "uri": "spotify:user:31ad2j7c46tsiqvkw2msrjfmgky4", "url": "https://open.spotify.com/user/31ad2j7c46tsiqvkw2msrjfmgky4", "image": "https://i.scdn.co/image/ab6775700000ee851ce7fdc8210fb842b4dd8292", "username": "31ad2j7c46tsiqvkw2msrjfmgky4", "display_name": "Andrew Huberman" } ], "offset": 0, "source": "spotify", "preview": false, "retrieved_at": "2026-11-12T00:00:00Z" }, "verified": true, "last_checked_at": "2026-11-14T03:35:09.716Z", "latency_ms": 3, "uptime_30d": 75.93 }, { "method": "GET", "path": "/spotify/artist/playlists", "url": "https://apistead.qd.je/api/v2/spotify/artist/playlists", "price_usdc": 0.03, "pay_to": "0x2E9804240E493DD8daeBa4F341a5086b92cde235", "description": "Spotify playlists owned by or associated with an artist.", "example_request": "GET https://apistead.qd.je/api/v2/spotify/artist/playlists?url=https://open.spotify.com/artist/5INjqkS1o8h1imAzPqGZBb", "example_response": { "note": "Spotify playlists owned by or associated with the artist, normalized for agents.", "total": 1, "artist": { "id": "5INjqkS1o8h1imAzPqGZBb", "uri": "spotify:artist:5INjqkS1o8h1imAzPqGZBb", "url": "https://open.spotify.com/artist/5INjqkS1o8h1imAzPqGZBb", "name": "Tame Impala" }, "source": "spotify", "preview": false, "complete": true, "returned": 1, "playlists": [ { "id": "4wmXlb759ceIV2O4JRWjSo", "uri": "spotify:playlist:4wmXlb759ceIV2O4JRWjSo", "url": "https://open.spotify.com/playlist/4wmXlb759ceIV2O4JRWjSo", "name": "Tame Impala Complete", "owner": { "url": null, "name": "Tame Impala" }, "followers": null, "cover_image": "https://image-cdn-fa.spotifycdn.com/image/ab67706c0000da84eab552ee34feabfe2e6f36aa", "description": "Listen to \"Loser\" from Tame Impala's album Deadbeat, out now." } ], "retrieved_at": "2026-11-12T00:00:00Z" }, "verified": true, "last_checked_at": "2026-11-14T03:35:09.755Z", "latency_ms": 4, "uptime_30d": 77.36 }, { "method": "GET", "path": "/spotify/artist/related", "url": "https://apistead.qd.je/api/v2/spotify/artist/related", "price_usdc": 0.03, "pay_to": "0x2E9804240E493DD8daeBa4F341a5086b92cde235", "description": "Spotify related artists for an artist.", "example_request": "GET https://apistead.qd.je/api/v2/spotify/artist/related?url=https://open.spotify.com/artist/5INjqkS1o8h1imAzPqGZBb", "example_response": { "note": "Spotify related artists, normalized for agents.", "total": 40, "artist": { "id": "5INjqkS1o8h1imAzPqGZBb", "uri": "spotify:artist:5INjqkS1o8h1imAzPqGZBb", "url": "https://open.spotify.com/artist/5INjqkS1o8h1imAzPqGZBb", "name": "Tame Impala" }, "source": "spotify", "artists": [ { "id": "67hb7towEyKvt5Z8Bx306c", "uri": "spotify:artist:67hb7towEyKvt5Z8Bx306c", "url": "https://open.spotify.com/artist/67hb7towEyKvt5Z8Bx306c", "name": "Empire Of The Sun", "image": "https://i.scdn.co/image/ab6761610000e5ebc806f3e714afa21861e20248" } ], "preview": false, "complete": true, "returned": 40, "retrieved_at": "2026-11-12T00:00:00Z" }, "verified": true, "last_checked_at": "2026-11-14T03:35:09.742Z", "latency_ms": 4, "uptime_30d": 75.93 }, { "method": "GET", "path": "/spotify/artist/discovered-on", "url": "https://apistead.qd.je/api/v2/spotify/artist/discovered-on", "price_usdc": 0.03, "pay_to": "0x2E9804240E493DD8daeBa4F341a5086b92cde235", "description": "Spotify playlists that surface an artist.", "example_request": "GET https://apistead.qd.je/api/v2/spotify/artist/discovered-on?url=https://open.spotify.com/artist/5INjqkS1o8h1imAzPqGZBb", "example_response": { "note": "Spotify playlists that surface the artist, normalized for agents.", "total": 100, "artist": { "id": "5INjqkS1o8h1imAzPqGZBb", "uri": "spotify:artist:5INjqkS1o8h1imAzPqGZBb", "url": "https://open.spotify.com/artist/5INjqkS1o8h1imAzPqGZBb", "name": "Tame Impala" }, "source": "spotify", "preview": false, "complete": false, "returned": 40, "playlists": [ { "id": "4wmXlb759ceIV2O4JRWjSo", "uri": "spotify:playlist:4wmXlb759ceIV2O4JRWjSo", "url": "https://open.spotify.com/playlist/4wmXlb759ceIV2O4JRWjSo", "name": "Tame Impala Complete", "owner": { "url": null, "name": "Tame Impala" }, "followers": null, "cover_image": "https://image-cdn-fa.spotifycdn.com/image/ab67706c0000da84eab552ee34feabfe2e6f36aa", "description": "Listen to \"Loser\" from Tame Impala's album Deadbeat, out now." } ], "retrieved_at": "2026-11-12T00:00:00Z" }, "verified": true, "last_checked_at": "2026-11-14T03:35:09.701Z", "latency_ms": 15, "uptime_30d": 77.78 }, { "method": "GET", "path": "/spotify/artist/featuring", "url": "https://apistead.qd.je/api/v2/spotify/artist/featuring", "price_usdc": 0.03, "pay_to": "0x2E9804240E493DD8daeBa4F341a5086b92cde235", "description": "Spotify playlists featuring an artist.", "example_request": "GET https://apistead.qd.je/api/v2/spotify/artist/featuring?url=https://open.spotify.com/artist/5INjqkS1o8h1imAzPqGZBb", "example_response": { "note": "Spotify playlists featuring the artist, normalized for agents.", "total": 8, "artist": { "id": "5INjqkS1o8h1imAzPqGZBb", "uri": "spotify:artist:5INjqkS1o8h1imAzPqGZBb", "url": "https://open.spotify.com/artist/5INjqkS1o8h1imAzPqGZBb", "name": "Tame Impala" }, "source": "spotify", "preview": false, "complete": true, "returned": 8, "playlists": [ { "id": "4wmXlb759ceIV2O4JRWjSo", "uri": "spotify:playlist:4wmXlb759ceIV2O4JRWjSo", "url": "https://open.spotify.com/playlist/4wmXlb759ceIV2O4JRWjSo", "name": "Tame Impala Complete", "owner": { "url": null, "name": "Tame Impala" }, "followers": null, "cover_image": "https://image-cdn-fa.spotifycdn.com/image/ab67706c0000da84eab552ee34feabfe2e6f36aa", "description": "Listen to \"Loser\" from Tame Impala's album Deadbeat, out now." } ], "retrieved_at": "2026-11-12T00:00:00Z" }, "verified": true, "last_checked_at": "2026-11-14T03:35:09.748Z", "latency_ms": 3, "uptime_30d": 75.93 }, { "method": "GET", "path": "/spotify/track/similar-albums", "url": "https://apistead.qd.je/api/v2/spotify/track/similar-albums", "price_usdc": 0.03, "pay_to": "0x2E9804240E493DD8daeBa4F341a5086b92cde235", "description": "Spotify albums similar to a track.", "example_request": "GET https://apistead.qd.je/api/v2/spotify/track/similar-albums?url=https://open.spotify.com/track/4whkhyXTrTgHKZzkUvdwoq&limit=2", "example_response": { "note": "Spotify albums similar to the supplied track, normalized for agents.", "total": 42, "track": { "id": "4whkhyXTrTgHKZzkUvdwoq", "uri": "spotify:track:4whkhyXTrTgHKZzkUvdwoq", "url": "https://open.spotify.com/track/4whkhyXTrTgHKZzkUvdwoq" }, "albums": [ { "id": "31qVWUdRrlb8thMvts0yYL", "uri": "spotify:album:31qVWUdRrlb8thMvts0yYL", "url": "https://open.spotify.com/album/31qVWUdRrlb8thMvts0yYL", "name": "The Slow Rush", "type": "album", "artists": [ { "id": "5INjqkS1o8h1imAzPqGZBb", "url": "https://open.spotify.com/artist/5INjqkS1o8h1imAzPqGZBb", "name": "Tame Impala" } ], "cover_image": "https://i.scdn.co/image/ab67616d0000b27358267bd34420a00d5cf83a49", "track_count": 12, "release_date": "2020-02-14" } ], "source": "spotify", "preview": false, "complete": false, "returned": 2, "retrieved_at": "2026-11-12T00:00:00Z" }, "verified": true, "last_checked_at": "2026-11-14T03:35:09.768Z", "latency_ms": 3, "uptime_30d": 77.36 } ], "changelog": [ { "version": "2.3.0", "title": "Artist sections, similar albums and focused search", "body": "Added artist playlists, related artists, discovered-on and featuring playlists, similar albums based on a track, and dedicated podcast, episode, audiobook and user search routes. V2 now has twenty-three routes at /bin/bash.03 per call.", "type": "release", "author": "APIStead Labs", "published_at": "2026-11-12T09:37:20.353Z" }, { "version": "2.2.0", "title": "Podcasts, audiobooks, genres and users", "body": "Added podcast, podcast episode, episode, audiobook, audiobook chapter, genre search and public user profile routes. V2 now has fourteen routes at /bin/bash.03 per call.", "type": "release", "author": "APIStead Labs", "published_at": "2026-11-12T09:08:55.406Z" }, { "version": "2.1.0", "title": "Price update and release dates", "body": "V2 calls now cost /bin/bash.05 USDC. Search covers tracks, albums, artists, playlists, podcasts, episodes, audiobooks, genres and users. Playlists return every ordered track with no song limit. Track and release objects include release_date; artist records include world_rank. Appears On reports appears_on_total.", "type": "release", "author": "APIStead Labs", "published_at": "2026-11-12T07:17:46.994Z" }, { "version": "2.0.1", "title": "Full discographies and preview URLs", "body": "Discography returns all albums, singles and EPs by default. Track responses now include a 30-second preview_url when Spotify publishes one.", "type": "release", "author": "APIStead Labs", "published_at": "2026-11-12T06:33:08.871Z" }, { "version": "2.0.0", "title": "Spotify API v2", "body": "Added keyword search, complete artist discographies and seven v2 routes. All v2 routes are settlement-verified on Base mainnet.", "type": "release", "author": "APIStead Labs", "published_at": "2026-11-12T05:37:55.998Z" } ], "generated_at": "2026-11-14T03:56:30.879Z" }