Phish.in

Entertainmentby Phish.in

Launched Mar 11, 2026 on ChatGPT

Phish.in is a free archive of live Phish audience recordings. This legal open source site is carefully maintained by phans to help music lovers discover and enjoy the music of the popular improvisational rock band. Search and browse the database by song, venue, tour, and more. Play audio without leaving ChatGPT.

16ChatGPT Tools

Phish.inDeveloper

EntertainmentCategory

Available Tools

Get Audio Track

get_audio_track

Full Description

Get a song performance with audio player widget. triggers: 'play [song]', 'random track', 'listen to', 'surprise me', or when user selects a performance from get_song results. params: random=true for random; slug='YYYY-MM-DD/track-slug' for specific. display: Widget renders audio player; provide only a brief 1-2 sentence summary. Link to track web URL (use 'url', not 'mp3_url').

Parameters (0 required, 2 optional)

Optional

randomboolean

Set to true for a random audio track

slugstring

Track slug: 'YYYY-MM-DD/track-slug' (e.g., '1997-11-22/tweezer'). Omit for random.

Get Playlist

get_playlist

Full Description

Get a playlist with interactive widget. display: Widget renders track listing; provide only a brief 1-2 sentence summary. Do NOT list tracks. Link tracks to web URLs (use 'url', not 'mp3_url').

Parameters (0 required, 1 optional)

Optional

slugstring

Playlist slug (omit for random playlist)

Get Show

get_show

Full Description

Get a Phish show with setlist widget. triggers: 'random show', specific dates ('Halloween 1995', '12/31/99'), or follow-up to list_shows/search. params: random=true for random; date='YYYY-MM-DD' for specific. display: Widget renders setlist; provide only a brief 1-2 sentence summary. Do NOT list tracks. Link tracks to web URLs (use 'url', not 'mp3_url').

Parameters (0 required, 2 optional)

Optional

datestring

Show date (YYYY-MM-DD). Omit for random show.

randomboolean

Set to true for a random show (ignores date)

Get Song

get_song

Full Description

Get a Phish song with performance history. triggers: 'random song' or specific song by slug. params: random=true for random; slug='song-slug' for specific. display: Format dates as 'Jul 4, 2023'. Link tracks to web URLs (use 'url', not 'mp3_url').

Parameters (0 required, 5 optional)

Optional

limitinteger

Max performances to return (default: 25)

randomboolean

Set to true for a random song (ignores slug)

slugstring

Song slug (e.g., 'tweezer', 'you-enjoy-myself'). Omit for random song.

sort_bystring

Sort performances by date (default), likes, duration, or random

Options:datelikesdurationrandom

sort_orderstring

Sort order: asc or desc (default: desc)

Options:ascdesc

Get Tag

get_tag

Full Description

Get shows or tracks associated with a specific tag. params: type='show' for tagged shows (e.g., costume); type='track' for tagged tracks (e.g., jamcharts). display: Link dates to show URLs, song names to track web URLs (use 'url', not 'mp3_url'). Format dates as 'Jul 4, 2023'. Example: | [Tweezer](track_url) | [Jul 4, 2023](show_url) |

Parameters (2 required, 3 optional)

Required

slugstring

Tag slug (e.g., 'jamcharts', 'costume', 'guest')

typestring

Entity type to return: 'show' for tagged shows, 'track' for tagged tracks

Options:showtrack

Optional

limitinteger

Max items to return (default: 25)

sort_bystring

Sort by date (default), likes, duration (tracks only), or random

Options:datelikesdurationrandom

sort_orderstring

Sort order: asc or desc (default: desc)

Options:ascdesc

Get Tour

get_tour

Full Description

Get a Phish tour with date range and show count. params: random=true for random; slug='tour-slug' for specific. follow-up: Use list_shows with tour_slug to get shows on this tour. display: Format dates as 'Jul 4, 2023'.

Parameters (0 required, 2 optional)

Optional

randomboolean

Set to true for a random tour (ignores slug)

slugstring

Tour slug (e.g., 'fall-tour-1997', 'summer-tour-2023'). Omit for random tour.

Get Venue

get_venue

Full Description

Get a venue with location, show count, and date range. params: random=true for random; slug='venue-slug' for specific. follow-up: Use list_shows with venue_slug to get shows at this venue. display: Format dates as 'Jul 4, 2023'.

Parameters (0 required, 2 optional)

Optional

randomboolean

Set to true for a random venue (ignores slug)

slugstring

Venue slug (e.g., 'madison-square-garden'). Omit for random venue.

List Playlists

list_playlists

Full Description

List user-created playlists with optional sorting. follow-up: Use get_playlist with slug for full track listing. display: Link playlist names to their URLs. Example: [My Favorite Jams](url)

Parameters (0 required, 3 optional)

Optional

limitinteger

Max playlists to return (default: 50)

sort_bystring

Sort by name, likes_count (default), tracks_count, duration, updated_at, or random

Options:namelikes_counttracks_countdurationupdated_atrandom

sort_orderstring

Sort order: asc or desc (default)

Options:ascdesc

List Shows

list_shows

Full Description

Browse shows by year, date range, tour, or venue. Returns shows WITHOUT setlists. params: At least one filter required. follow-up: Call get_show with date to display setlist widget. display: Link dates to show URLs, venues to venue URLs. Format dates as 'Jul 4, 2023'. Example: | [Jul 4, 2023](show_url) | [MSG](venue_url) |

Parameters (0 required, 8 optional)

Optional

end_datestring

End date for range filter (YYYY-MM-DD)

limitinteger

Max shows to return (default: 50)

sort_bystring

Sort by date (default), likes, duration, or random

Options:datelikesdurationrandom

sort_orderstring

Sort order: asc (default for date) or desc

Options:ascdesc

start_datestring

Start date for range filter (YYYY-MM-DD)

tour_slugstring

Filter by tour slug (e.g., 'fall-tour-1997')

venue_slugstring

Filter by venue slug (e.g., 'madison-square-garden')

yearinteger

Filter by year (e.g., 1997)

List Songs

list_songs

Full Description

List Phish songs with optional filtering and sorting. follow-up: Use get_song with slug for detailed performance history. display: Link song titles to their URLs. Example: [Tweezer](url)

Parameters (0 required, 5 optional)

Optional

limitinteger

Max songs to return (default: 50)

min_playsinteger

Minimum number of performances (filters out rarely played songs)

song_typestring

Filter by song type: all (default), original, or cover

Options:alloriginalcover

sort_bystring

Sort by name (default) or times_played

Options:nametimes_played

sort_orderstring

Sort order: asc (default for name) or desc (default for times_played)

Options:ascdesc

List Tags

list_tags

Full Description

List all tags with show and track counts. Tags categorize content: Jamcharts (notable jams), Costume, Guest, Debut, and more. follow-up: Use get_tag with a tag slug to see tagged items.

List Tours

list_tours

Full Description

List all Phish tours with optional year filtering. follow-up: Use get_tour with slug for tour details.

Parameters (0 required, 1 optional)

Optional

yearinteger

Filter tours by year (e.g., 1997)

List Venues

list_venues

Full Description

List Phish venues with optional geographic filtering. follow-up: Use get_venue with slug for venue details. display: Link venue names to their URLs. Example: [Madison Square Garden](url)

Parameters (0 required, 6 optional)

Optional

citystring

Filter by city name

countrystring

Filter by country (e.g., 'USA', 'Germany')

limitinteger

Max venues to return (default: 50)

sort_bystring

Sort by name (default) or shows_count

Options:nameshows_count

sort_orderstring

Sort order: asc (default for name) or desc (default for shows_count)

Options:ascdesc

statestring

Filter by state (e.g., 'NY', 'California')

List Years

list_years

Full Description

List all years/eras when Phish performed, with show counts. Eras: 1.0 (1983-2000), 2.0 (2002-2004), 3.0 (2009-2020), 4.0 (2021+). follow-up: Use list_shows with year to see shows. display: Link years to their URLs. Example: [1995](url)

Search

search

Full Description

Case-insensitive substring search across shows, songs, venues, tours, tags, and playlists. note: For specific dates ('Halloween 95', 'NYE 99'), use get_show directly. follow-up: Call get_show to display setlist widget. display: Link dates to show URLs, titles to song URLs, names to venue URLs. Format dates as 'Jul 4, 2023'.

Parameters (1 required, 1 optional)

Required

querystring

Search query (2-200 characters)

Optional

limitinteger

Max results per category (default: 25)

Stats

stats

Full Description

Statistical analysis: gaps (bustouts), transitions, set positions, geographic patterns, co-occurrence, and song frequency. display: Link song names to song URLs, dates to track web URLs (use 'url', not 'mp3_url'). Format dates as 'Jul 4, 2023'. Example: | [Tweezer](song_url) | 42 | [Dec 31, 1995](track_url) | api: https://phish.in/api/v2/swagger_doc (no key required)

Parameters (1 required, 14 optional)

Required

stat_typestring

Type of statistic to compute

Options:gapstransitionsset_positionsgeographicco_occurrencesong_frequency

Optional

directionstring

Transition direction

Options:beforeafter

geo_typestring

Geographic analysis type

Options:state_frequencynever_playedstate_debuts

limitinteger

Max results to return (default: 25). Set this to match how many results you intend to display.

min_gapinteger

Minimum show gap for bustout queries

min_playsinteger

Minimum times played to include (default: 2)

positionstring

Set position filter

Options:openercloserencore

setstring

Set number for opener/closer analysis (default: 1 for openers, 2 for closers)

Options:1234

song_b_slugstring

Second song slug for co-occurrence comparison

song_slugstring

Song slug for song-specific analysis

statestring

US state code for geographic analysis

tour_slugstring

Filter to specific tour

venue_slugstring

Venue slug for venue-specific analysis

yearinteger

Filter to specific year

year_rangearray

Filter to year range [start, end]

Links

Website Privacy Policy Terms of Service