2. Global Charts & Viral Trends

Querying Global Music Charts

Group 8 tools provide agents with the ability to read the industry's pulse.

Tool: get_available_charts

Description: Before fetching a ranking, you must know what charts exist. This tool lists the available chart 'slugs' for a given platform (Spotify, Shazam, Airplay) and standard country codes.

Tool: get_chart_ranking

Description: Once you have the slug, this tool fetches the actual ranking ladder. It returns a list of tracks or albums with their current positions on that specific chart.

Tool: get_global_song_chart

Description: A faster, direct tool to retrieve the absolute latest ranking of songs for massive global milestones (e.g., Spotify Global 50, TikTok Viral).