Tuneping

Create a wishlist that records when something is detected on air: kind artist (value art_… id), track (value trk_… id) or query (value free text 'Artist - Title'); optional station_filter narrows it to station ids or countries. Matches are read with list_wishlist_matches (polling; this tool never creates webhook delivery). Needs TUNEPING_API_KEY: Developer allows 10 wishlists, Pro 100. The only tool that writes. Metadata detections, not fingerprinted airplay; about 73 % of directory stations expose a title, about half are songs.

Airplay report for one artist (art_… from search_artists): plays, stations and distinct_tracks per station, country or day. Defaults to = the current hour, from = to − 30 days. Pro and Business keep 30 days, judged from the current hour (an older from → 403 forbidden_tier); the 366-day window cap applies only to custom depth. Up to 1000 groups per call; more → 422 too_many_groups (narrow the window or use group_by=country or day). The response's note says the counts are metadata detections. Needs TUNEPING_API_KEY with the Pro plan (Developer keys get 403 forbidden_tier). Metadata detections, not fingerprinted airplay; about 73 % of directory stations expose a title, about half are songs.

Tuneping's live coverage: stations_total, stations_with_live_metadata, stations_polled_last_5m, title_changes_per_minute, songs_identified_share, by_method, by_country (top 20), sources. Use it to qualify answers about coverage. No API key needed. Metadata detections, not fingerprinted airplay; about 73 % of directory stations expose a title, about half are songs.

Current titles for up to 100 stations in one call (20 without an API key, 100 with a Developer key); unknown ids come back in missing[]; is_stale marks old titles. No API key needed. Metadata detections, not fingerprinted airplay; about 73 % of directory stations expose a title, about half are songs.

One station by Radio Browser UUID: name, country, tags, codec, bitrate, stream_url, homepage, clickcount and metadata.coverage (live, static or none: whether Tuneping sees titles from it). No API key needed. Metadata detections, not fingerprinted airplay; about 73 % of directory stations expose a title, about half are songs.

Past titles of one station, newest first (PlayEvent rows: started_at, ended_at, duration_seconds, artist, title, track). from inclusive, to exclusive, RFC 3339 UTC; defaults to = now, from = to − 24 h; window at most 31 days. One call returns at most 200 rows, newest first; a non-null next_cursor means older rows exist, so narrow from/to to see them. Needs TUNEPING_API_KEY: Developer keeps 10 days, Pro and Business 30 days (an older from → 403 forbidden_tier). Metadata detections, not fingerprinted airplay; about 73 % of directory stations expose a title, about half are songs.

The title one station announces right now: raw_title, artist, title, track (trk_… id or null), classification, confidence, started_at, observed_at. When no song is announced, track is null and classification is ident, programme, ad_break, empty, junk or unknown. No API key needed. Metadata detections, not fingerprinted airplay; about 73 % of directory stations expose a title, about half are songs.

Where and when one track (trk_… from search_tracks) was detected: PlayEvent rows newest first (station, started_at, ended_at, confidence) plus the effective window {from, to}. from inclusive, to exclusive, RFC 3339 UTC; defaults to = now, from = to − 24 h; window at most 31 days. One call returns at most 200 rows, newest first; a non-null next_cursor means older rows exist, so narrow from/to to see them. Needs TUNEPING_API_KEY: Developer keeps 10 days, Pro and Business 30 days (an older from → 403 forbidden_tier). Metadata detections, not fingerprinted airplay; about 73 % of directory stations expose a title, about half are songs.

Matches of one wishlist (wl_… from create_wishlist), ascending by matched_at: station, raw_title, track, started_at, confidence and expected_end_hint_at (a hint, not a prediction). The newest page (100 rows); matches are kept 30 days. Needs TUNEPING_API_KEY (Developer or higher). Metadata detections, not fingerprinted airplay; about 73 % of directory stations expose a title, about half are songs.

Catalogue lookup of artists (id art_…, name, MusicBrainz mbid, track_count, seen_on_radio) by name; use the art_… id with get_artist_airplay or create_wishlist. No API key needed. Metadata detections, not fingerprinted airplay; about 73 % of directory stations expose a title, about half are songs.

Find stations currently playing a title matching q (artist, title or both, e.g. 'queen bohemian'; case- and accent-insensitive, at least 2 characters). Returns up to limit (default 20, max 100) live detections from the last 3 minutes with station, raw_title, artist, title, track id (trk_…), classification and confidence. No API key needed. Metadata detections, not fingerprinted airplay; about 73 % of directory stations expose a title, about half are songs.

Find stations by name (fuzzy), optionally filtered by ISO country and one tag (e.g. 'jazz'). Returns up to 20 Station objects (by popularity) with the station_id to use elsewhere, and next_cursor when more exist. No API key needed. Metadata detections, not fingerprinted airplay; about 73 % of directory stations expose a title, about half are songs.

Catalogue lookup of tracks (id trk_…, title, artist, MusicBrainz mbid, seen_on_radio) by title or 'artist title'; use the trk_… id with get_track_plays or create_wishlist. For what is playing now use search_now_playing instead. No API key needed. Metadata detections, not fingerprinted airplay; about 73 % of directory stations expose a title, about half are songs.