find_nearby_stations
ChatGPTFind live radio stations near the user, using the coarse location ChatGPT shares (city or country level). Use when the user says 'near me', 'local radio' or 'stations here'. If no location is available it says so; then ask the user for a city or country and use search_stations.
get_artist
ChatGPTLook up a music artist on Spinn Radio: short bio, genres, top tracks, similar artists, and which radio stations played them in the last 30 days (from Spinn's own airplay tracking). Use the airplay station ids with play_station to hear a station that plays the artist.
get_now_playing
ChatGPTGet the song and artist a station is playing right now, from the station's own stream metadata. Some stations don't broadcast titles; then it says so.
get_podcast_episodes
ChatGPTThe newest episodes of a podcast, with titles, dates and lengths, and episode ids to pass to play_podcast_episode. Does not play audio.
get_station_stream
ChatGPTUsed by the Spinn Radio widgets when the user taps a station: returns the station and a playable stream for the widget.
open_globe
ChatGPTOpen the interactive Spinn Radio globe: every dot is a live station the user can tap to hear, with a spin button for a random one. Optionally centre it on a country. Use when the user wants to explore radio around the world.
play_audiobook
ChatGPTOpen the Spinn Radio player on an audiobook chapter so the user can listen in the chat, with a seek bar and skip; the next chapters follow on. Pass book_id from search_audiobooks and a chapter number (default 1). Only some chapters of a book may play here; the result says so. Playback starts when the user taps play.
play_podcast_episode
ChatGPTOpen the Spinn Radio player on a podcast episode so the user can listen in the chat, with a seek bar, skip and speed. Pass show_id from search_podcasts, top_podcasts or get_podcast_episodes, and episode_id for a particular episode; without one it plays the newest. Playback starts when the user taps play.
play_station
ChatGPTOpen the Spinn Radio player for one live station so the user can listen in the chat. First find the station id with search_stations, find_nearby_stations, get_artist or show_station_cards. Playback starts when the user taps play.
search_audiobooks
ChatGPTFind audiobooks on Spinn Radio by title or author: public-domain classics from LibriVox, Spinn originals, the Bible and the Quran. Returns book ids for play_audiobook, with how many chapters can be played in the chat. Does not play audio.
search_playlists
ChatGPTFind Spinn Radio playlists (curated by the Spinn team or published by listeners) by theme, mood or artist. Returns titles and links to open them on spinnradio.com.
search_podcasts
ChatGPTFind podcasts by name, host or topic in Apple's podcast directory (explicit shows are left out). Returns show ids to pass to get_podcast_episodes or play_podcast_episode. Does not play audio.
search_stations
ChatGPTFind live radio stations in the Spinn Radio catalog by station name, genre or mood tag, country, city or language. Returns up to 12 stations with ids to pass to play_station or show_station_cards. Only stations that passed their last health check are returned. Does not play audio.
show_station_cards
ChatGPTShow a carousel of 2 to 8 stations the user can audition with one tap each. Pass ids from search_stations or find_nearby_stations, in the order to show them. Use when there are several good options; use play_station when there is one clear choice.
spin_the_globe
ChatGPTPick one random live station, like spinning a globe, and open the player for it. Optionally stay within a country or genre. Use when the user wants a surprise, something new, or 'anywhere'.
top_podcasts
ChatGPTThe most popular podcasts right now from Apple's charts, overall or in one category. Returns show ids to pass to get_podcast_episodes or play_podcast_episode. Does not play audio.
