Get detailed listening statistics for a specific track from your listening history.

Returns information including:

• Total play count across all time

• Total listening time

• First and last time you played the track

• Average plays per day

• Your peak listening day for this track

Example queries:

• "How many times have I listened to Bohemian Rhapsody?"

• "When did I first listen to this song?"

• "What's my most played day for this track?"

Get your most played tracks for any time period.

Returns your top tracks ranked by play count, with full track details and play statistics. This queries your complete listening history (not limited to Spotify's 50 recent tracks).

Time period options:

• Omit dates for all-time top tracks

• Specify start_date only for "since X" queries

• Specify both dates for a specific range

Example queries:

• "What are my top 10 songs?"

• "What were my most played tracks in summer 2024?"

• "Show me my top 20 songs from last month"

• "What are my all-time top tracks?"

Get detailed listening statistics for a specific artist from your listening history.

Returns information including:

• Total play count across all their tracks

• Total listening time

• First and last time you played any of their tracks

• Your top tracks by this artist

Example queries:

• "How much have I listened to Radiohead?"

• "What are my top songs by The Weeknd?"

• "When did I first discover NF?"

Get your top artists for a specified time period.

Returns artists ranked by play count including:

• Artist name and Spotify ID

• Total play count

• Total listening time

Example queries:

• "Who are my top 10 artists this year?"

• "What artists did I listen to most in summer 2024?"

• "Show me my all-time top 20 artists"

Search through your complete Spotify listening history.

Unlike Spotify's recent tracks (limited to 50), this searches your ENTIRE history stored in Your Spotify.

Example queries:

• "Find all times I listened to Radiohead"

• "Search for songs with 'love' in the title"

• "When did I listen to OK Computer?"

Generate a custom Spotify Wrapped summary for ANY time period.

Unlike Spotify's official Wrapped (limited to the past year), this creates personalized listening summaries for any date range you choose.

Perfect for:

• Seasonal summaries ("My Summer 2024 Wrapped")

• Event-based recaps ("Music during my vacation")

• Comparative analysis ("This semester vs last semester")

• Monthly or weekly reviews

Returns comprehensive statistics including:

• Total listening time and track counts

• Top 5 tracks, artists, and albums

• Listening patterns (peak hours, days)

• New music discoveries in that period

Example queries:

• "Create my Spotify Wrapped for summer 2024"

• "What did my music look like during my road trip in March?"

• "Generate a wrapped for the first half of 2024"

• "Show me my December listening stats"

Analyze listening overlap between multiple Your Spotify users.

Find songs that multiple users share in common - perfect for:

• Creating collaborative playlists

• Road trip music everyone enjoys

• Party playlists where everyone knows the songs

• Understanding shared music tastes with friends

Two analysis modes:

• minima: Songs EVERYONE has listened to (highest overlap)

  • Good for: "Songs we ALL know"

  • Score based on lowest listener's play count

• average: Songs that satisfy SOME people a lot

  • Good for: "Songs someone will love"

  • Score based on average play count

Example queries:

• "What songs do my girlfriend and I both like?"

• "Find music that everyone at the party knows"

• "What's our shared music taste?"

Analyze your listening activity over time.

Returns a timeline of plays and listening duration at day, week, or month granularity.

Example queries:

• "Show my listening timeline for 2024"

• "How has my listening changed month over month?"

• "What were my most active listening days last summer?"

Find where a specific artist ranks in your listening history.

Shows the artist's position among all artists you've listened to, along with percentile ranking.

Example queries:

• "Where does Radiohead rank in my listening?"

• "Is Taylor Swift in my top 10?"

• "What's my percentile for The Beatles?"

Find where a specific track ranks in your listening history.

Shows the track's position among all tracks you've listened to, along with percentile ranking.

Example queries:

• "Where does Bohemian Rhapsody rank in my plays?"

• "Is this song in my top 100?"

• "What percentile is Blinding Lights in my history?"

Analyze your listening patterns over time.

Discover when you listen to music most - by hour of day, day of week, or month.

Example queries:

• "What time of day do I listen to music most?"

• "Which day of the week has the most plays?"

• "Am I a morning or evening listener?"

Discover new music you found in a specific time period.

Shows tracks and artists you listened to for the first time during the period.

Example queries:

• "What new music did I discover in 2024?"

• "Show me artists I found this summer"

• "What were my new discoveries last month?"

Compare your listening habits between two time periods.

See how your listening volume, diversity, and preferences have changed.

Example queries:

• "Compare my listening in summer 2024 vs summer 2023"

• "How did my music habits change from Q1 to Q2?"

• "Am I listening more this year than last year?"

Export your listening data in various formats.

Get a structured export of your listening history, top tracks, artists, etc.

Example queries:

• "Export my 2024 listening stats"

• "Give me a summary of my listening data"

• "Export my top 100 tracks as JSON"

Update your Your Spotify account settings.

Currently supports updating timezone preferences.

Example queries:

• "Set my timezone to Pacific Time"

• "Change my timezone to Europe/London"

Change your display username in Your Spotify.

This only affects your Your Spotify profile, not your actual Spotify account.

Example queries:

• "Change my username to JonDown"

• "Rename my account to MusicFan2024"

Generate a public link to share your Your Spotify statistics.

Anyone with this link can view your listening history without logging in. Use revoke_public_access to disable the link when you're done sharing.

Example queries:

• "Create a public link to share my 2024 stats"

• "Generate a shareable link for my profile"

Revoke your public share token, immediately disabling the public link.

Use this when you no longer want your stats publicly accessible.

Example queries:

• "Revoke my public share link"

• "Disable public access to my stats"

• "Remove my public profile"