[GH-ISSUE #65] Release v2.0.20 - Documentation Fixes #84

New issue

Closed

opened 2026-03-13 23:00:45 +03:00 by kerem · 0 comments

kerem commented

2026-03-13 23:00:45 +03:00

Owner

Originally created by @AliAkhtari78 on GitHub (May 28, 2025).
Original GitHub issue: https://github.com/AliAkhtari78/SpotifyScraper/issues/65

SpotifyScraper v2.0.20 Released

This release fixes important documentation issues regarding available track fields.

What's Fixed

📝 Documentation Corrections: Fixed incorrect documentation that listed 'popularity' as an available field for tracks
🔧 Example Updates: Updated all example code to remove references to track['popularity']
📚 Field Clarification: Added clear documentation about which fields are available via web scraping vs the official API

Key Changes

The popularity field is NOT available when scraping track data from the web
This field is only available through Spotify's official Web API which requires authentication
Updated all documentation and examples to reflect the actual available fields

Available Track Fields (Web Scraping)

✅ Available:

id, name, uri, type
duration_ms
artists (with name, uri, id)
album (with name, type, images)
preview_url
is_explicit, is_playable
release_date

❌ NOT Available (API only):

popularity
track_number, disc_number
available_markets
external_ids, external_urls
Audio features (tempo, key, loudness, etc.)

Example Usage

from spotify_scraper import SpotifyClient

client = SpotifyClient()
track = client.get_track_info(track_url)

# Correct - safe field access
print(f"Track: {track.get('name', 'Unknown')}")
print(f"Duration: {track.get('duration_ms', 0) / 60000:.2f} minutes")

# Wrong - will raise KeyError
# print(f"Popularity: {track['popularity']}")  # ❌ This field doesn't exist!

Installation

pip install --upgrade spotifyscraper

View the full changelog for more details.

Originally created by @AliAkhtari78 on GitHub (May 28, 2025). Original GitHub issue: https://github.com/AliAkhtari78/SpotifyScraper/issues/65 ## SpotifyScraper v2.0.20 Released This release fixes important documentation issues regarding available track fields. ### What's Fixed - 📝 **Documentation Corrections**: Fixed incorrect documentation that listed 'popularity' as an available field for tracks - 🔧 **Example Updates**: Updated all example code to remove references to `track['popularity']` - 📚 **Field Clarification**: Added clear documentation about which fields are available via web scraping vs the official API ### Key Changes - The `popularity` field is **NOT** available when scraping track data from the web - This field is only available through Spotify's official Web API which requires authentication - Updated all documentation and examples to reflect the actual available fields ### Available Track Fields (Web Scraping) ✅ Available: - `id`, `name`, `uri`, `type` - `duration_ms` - `artists` (with name, uri, id) - `album` (with name, type, images) - `preview_url` - `is_explicit`, `is_playable` - `release_date` ❌ NOT Available (API only): - `popularity` - `track_number`, `disc_number` - `available_markets` - `external_ids`, `external_urls` - Audio features (tempo, key, loudness, etc.) ### Example Usage ```python from spotify_scraper import SpotifyClient client = SpotifyClient() track = client.get_track_info(track_url) # Correct - safe field access print(f"Track: {track.get('name', 'Unknown')}") print(f"Duration: {track.get('duration_ms', 0) / 60000:.2f} minutes") # Wrong - will raise KeyError # print(f"Popularity: {track['popularity']}") # ❌ This field doesn't exist! ``` ### Installation ```bash pip install --upgrade spotifyscraper ``` View the [full changelog](https://github.com/AliAkhtari78/SpotifyScraper/blob/master/CHANGELOG.md) for more details.