How to Automate Spotify Artist Data Sync & Release Radar Tracking using the API

Understanding the Spotify Web API

Setting Up Spotify API Authentication

Artist tracking requires OAuth 2.0 Authorization Code flow because you need access to the user's followed artists (a user-specific resource). Client Credentials flow only covers public catalog data. You need the user-follow-read scope to call GET /v1/me/following. Access tokens expire in 3,600 seconds — implement refresh token handling from the start.

1. 1Log in at https://developer.spotify.com/dashboard with your Spotify Premium account
2. 2Click 'Create app', add a name, description, and set a redirect URI (e.g., http://localhost:8888/callback)
3. 3Copy your Client ID and Client Secret from the app settings
4. 4Build the authorization URL: GET https://accounts.spotify.com/authorize?client_id=YOUR_CLIENT_ID&response_type=code&redirect_uri=YOUR_REDIRECT_URI&scope=user-follow-read
5. 5After user authorization, you receive ?code=AUTH_CODE at your redirect URI
6. 6Exchange the code: POST https://accounts.spotify.com/api/token with grant_type=authorization_code, code, redirect_uri; use Authorization: Basic base64(client_id:client_secret)
7. 7Store access_token (expires in 3600s) and refresh_token securely in environment variables
8. 8Refresh via POST https://accounts.spotify.com/api/token with grant_type=refresh_token before each scheduled run

1import os
2import base64
3import requests
4
5CLIENT_ID = os.environ['SPOTIFY_CLIENT_ID']
6CLIENT_SECRET = os.environ['SPOTIFY_CLIENT_SECRET']
7REFRESH_TOKEN = os.environ['SPOTIFY_REFRESH_TOKEN']
8
9def get_access_token():
10    """Refresh and return a new Spotify access token."""
11    creds = base64.b64encode(f"{CLIENT_ID}:{CLIENT_SECRET}".encode()).decode()
12    response = requests.post(
13        'https://accounts.spotify.com/api/token',
14        headers={'Authorization': f'Basic {creds}'},
15        data={'grant_type': 'refresh_token', 'refresh_token': REFRESH_TOKEN}
16    )
17    response.raise_for_status()
18    return response.json()['access_token']
19
20token = get_access_token()
21headers = {'Authorization': f'Bearer {token}'}

Key endpoints

1{"artists":{"items":[{"id":"0OdUWJ0sBjDrqHygGUXeCF","name":"Band of Horses","genres":["indie rock","folk rock"],"popularity":58,"followers":{"total":890000}},{"id":"1Cs0zKBU1kc0i8ypK3B9ai","name":"Fleet Foxes","genres":["chamber pop","indie folk"],"popularity":67}],"next":"https://api.spotify.com/v1/me/following?type=artist&after=1Cs0zKBU1kc0i8ypK3B9ai&limit=20","total":47,"cursors":{"after":"1Cs0zKBU1kc0i8ypK3B9ai"}}}

1{"items":[{"id":"382ObEPsp2rxGrnsizN5TX","name":"Is There a Ghost","release_date":"2024-09-15","release_date_precision":"day","album_type":"single","artists":[{"name":"Band of Horses"}],"external_urls":{"spotify":"https://open.spotify.com/album/382ObEPsp2rxGrnsizN5TX"}}],"total":42,"next":null}

1{"id":"0OdUWJ0sBjDrqHygGUXeCF","name":"Band of Horses","genres":["indie rock","folk rock"],"popularity":58,"external_urls":{"spotify":"https://open.spotify.com/artist/0OdUWJ0sBjDrqHygGUXeCF"},"images":[{"url":"https://i.scdn.co/image/ab6761610000e5eb...","height":640,"width":640}]}

1{"id":"382ObEPsp2rxGrnsizN5TX","name":"Is There a Ghost","release_date":"2024-09-15","release_date_precision":"day","label":"Sub Pop","tracks":{"items":[{"id":"7lEptt4wbM0yJTyqhLXsIV","name":"Is There a Ghost","duration_ms":218400,"track_number":1}],"total":1}}

Step-by-step automation

1# First page
2curl -G 'https://api.spotify.com/v1/me/following' \
3  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
4  -d 'type=artist' \
5  -d 'limit=50'
6
7# Next page using cursor
8curl -G 'https://api.spotify.com/v1/me/following' \
9  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
10  -d 'type=artist' \
11  -d 'limit=50' \
12  -d 'after=LAST_ARTIST_ID_FROM_CURSORS'

1curl -G 'https://api.spotify.com/v1/artists/0OdUWJ0sBjDrqHygGUXeCF/albums' \
2  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
3  -d 'include_groups=album,single' \
4  -d 'limit=10' \
5  -d 'market=US'

1curl 'https://api.spotify.com/v1/artists/0OdUWJ0sBjDrqHygGUXeCF' \
2  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'

1# Send to a Slack webhook (replace with your actual webhook URL)
2curl -X POST 'https://hooks.slack.com/services/YOUR/WEBHOOK/URL' \
3  -H 'Content-Type: application/json' \
4  -d '{"text":"New release: Band of Horses - Is There a Ghost (2024-09-15)\nhttps://open.spotify.com/album/382ObEPsp2rxGrnsizN5TX"}'

Complete working code

This script runs the complete release radar pipeline: refresh OAuth token, fetch all followed artists, check each for new releases since the last sync, enrich with artist metadata, and send a Slack notification with the results. Last sync time is persisted to a file. Set the environment variables listed in the auth section plus SLACK_WEBHOOK_URL.

1import os
2import base64
3import time
4import json
5import requests
6from datetime import datetime, timedelta
7
8CLIENT_ID = os.environ['SPOTIFY_CLIENT_ID']
9CLIENT_SECRET = os.environ['SPOTIFY_CLIENT_SECRET']
10REFRESH_TOKEN = os.environ['SPOTIFY_REFRESH_TOKEN']
11SLACK_WEBHOOK = os.environ.get('SLACK_WEBHOOK_URL')
12SYNC_FILE = os.environ.get('SYNC_STATE_FILE', '/tmp/spotify_sync.json')
13
14def get_token():
15    creds = base64.b64encode(f"{CLIENT_ID}:{CLIENT_SECRET}".encode()).decode()
16    r = requests.post('https://accounts.spotify.com/api/token',
17        headers={'Authorization': f'Basic {creds}'},
18        data={'grant_type': 'refresh_token', 'refresh_token': REFRESH_TOKEN})
19    r.raise_for_status()
20    return r.json()['access_token']
21
22def api_get(token, path, params=None):
23    r = requests.get(f'https://api.spotify.com/v1{path}',
24        headers={'Authorization': f'Bearer {token}'}, params=params)
25    if r.status_code == 429:
26        time.sleep(int(r.headers.get('Retry-After', 5)))
27        return api_get(token, path, params)
28    r.raise_for_status()
29    return r.json()
30
31def parse_date(release_date, precision):
32    if precision == 'day': return datetime.strptime(release_date, '%Y-%m-%d')
33    if precision == 'month': return datetime.strptime(release_date + '-01', '%Y-%m-%d')
34    return datetime.strptime(release_date + '-01-01', '%Y-%m-%d')
35
36def load_state():
37    try:
38        with open(SYNC_FILE) as f: return json.load(f)
39    except: return {'last_sync': (datetime.now() - timedelta(days=7)).isoformat()}
40
41def save_state(state):
42    with open(SYNC_FILE, 'w') as f: json.dump(state, f)
43
44def main():
45    token = get_token()
46    state = load_state()
47    since = datetime.fromisoformat(state['last_sync'])
48    print(f'Checking releases since {since.date()}')
49
50    # Fetch all followed artists
51    artists = []
52    url, params = '/me/following', {'type': 'artist', 'limit': 50}
53    while url:
54        data = api_get(token, url if url.startswith('/') else url.replace('https://api.spotify.com/v1', ''), params)
55        page = data['artists']
56        artists.extend(page['items'])
57        url = page['next']
58        params = {}
59        time.sleep(0.1)
60
61    print(f'Monitoring {len(artists)} artists')
62
63    # Check each for new releases
64    new_releases = []
65    for i, artist in enumerate(artists):
66        albums = api_get(token, f'/artists/{artist["id"]}/albums',
67            {'include_groups': 'album,single', 'limit': 10, 'market': 'US'})
68        for album in albums['items']:
69            if parse_date(album['release_date'], album['release_date_precision']) >= since:
70                new_releases.append({**album, 'artist_name': artist['name']})
71        time.sleep(0.2)
72
73    print(f'Found {len(new_releases)} new releases')
74
75    # Send notification
76    if new_releases and SLACK_WEBHOOK:
77        lines = [f'*Spotify Release Radar: {len(new_releases)} new releases*']
78        for r in new_releases:
79            lines.append(f"• {r['artist_name']} — *{r['name']}* ({r['album_type']}, {r['release_date']}) {r['external_urls']['spotify']}")
80        requests.post(SLACK_WEBHOOK, json={'text': '\n'.join(lines)}).raise_for_status()
81
82    save_state({'last_sync': datetime.now().isoformat()})
83    print('Sync complete')
84
85if __name__ == '__main__':
86    main()

Error handling

Rate Limits for Spotify API

1import time
2
3def with_rate_limit_retry(request_fn, max_retries=5):
4    for attempt in range(max_retries):
5        response = request_fn()
6        if response.status_code == 429:
7            retry_after = int(response.headers.get('Retry-After', 2 ** attempt))
8            print(f'Rate limited. Waiting {retry_after}s...')
9            time.sleep(retry_after)
10        elif response.ok:
11            return response
12        else:
13            response.raise_for_status()
14    raise RuntimeError('Max retries exceeded')

• Add 200ms delays between each artist album check — essential when monitoring more than 20 artists
• Honor the Retry-After header exactly on 429 responses — do not use fixed sleep durations
• Cache artist metadata (genres, image URLs) locally and only re-fetch weekly to reduce API calls
• Run the tracker daily, not hourly — Spotify releases are not real-time and daily polling is sufficient
• Persist your last_sync timestamp so you don't re-process releases you've already notified about

Security checklist

Automation use cases

No-code alternatives

Don't want to write code? These platforms can automate the same workflows visually.

Best practices

• Always check release_date_precision before parsing release dates — Spotify returns 'year', 'month', or 'day' precision and parsing a year-only date as a full date will throw errors
• Use include_groups=album,single to exclude 'appears_on' compilations from release radar to reduce noise
• Store artist IDs in your own database rather than re-fetching the following list on every run — check for new follows weekly, not daily
• Persist the last_sync timestamp between runs to avoid re-notifying about releases you've already processed
• Skip and log 404 errors gracefully — artists can be removed from Spotify's catalog, and hard failures will break your entire pipeline
• Do not rely on artist popularity or follower counts in Development Mode — these fields are restricted as of February 2026 and may return 0
• Test your release date parsing logic with all three precision types (year, month, day) before deploying — a missed release due to a parsing bug is hard to debug retroactively

Ask AI to help

Copy one of these prompts to get a personalized, working implementation.

Related automations

Explore related guides

Guides from other topics that help with this issue