get_artist_audience
ChatGPTRetrieve artist audience distributions by requested city/country metric on supported platforms. Requires artist uuid and one or more metrics; supports limit. Returns a separate list for each requested metric with geography, value and available percentage/change fields. Do not combine different audience metrics as if equivalent. Free users may request spotify_listeners_by_city or youtube_views_by_city, up to 5 results.
get_artist_chart
ChatGPTRetrieve a ranked, paginated artist chart by selected sort metric and timeframe. Supports country, genre, subgenre, label and metric-range filters. Use sort=spotify-listeners and timeframe=total for ranking by current monthly listener count; other timeframes rank by change over that period. Set sort_by_pct=true only for percentage-growth ranking. Returns artist records with nested platform metrics and pagination. Free plan: up to 3 results; Professional + MCP: up to 20 per page.
get_artist_details
ChatGPTRetrieve metadata, biography, external platform links and current ranks for one Viberate artist UUID. Use for artist identity, profile and ranking details; it is not a historical performance time series.
get_artist_events
ChatGPTRetrieve upcoming, past or all festivals and events associated with an artist UUID. Set data_type=upcoming|past|all (default upcoming). Returns dated event/festival entries, with venue and other available metadata. Requires a paid plan.
get_artist_metrics
ChatGPTRetrieve historical artist metric values for the specified artist UUID and metric. Optional date_from/date_to and period=daily|weekly|monthly. graph_mode: total returns observations, diff returns changes; leave it out to get both. Output is date-keyed. Use comparable dates and metric definitions when calculating changes. Free users must set graph_mode=total.
get_artist_spotify_playlists
ChatGPTRetrieve Spotify playlists containing tracks associated with an artist UUID. Requires sort=followers|position|date_added; supports order, limit and offset. Returns playlist metadata and an associated track for each record. Do not assume records are deduplicated by playlist UUID. Requires a paid plan.
get_artist_top_tracks_by_channel
ChatGPTRetrieve an artist's top-performing tracks separately for Spotify, YouTube, Shazam and SoundCloud. Requires artist_uuid (not uuid). Optional limit (1-20), timeframe=1d|1w|1m|12m|all and order=asc|desc. Returns separate platform lists with platform-specific consumption and growth metrics; there is no combined cross-platform ranking and no TikTok list. Free plan users must use limit=1 and timeframe=1w.
get_artist_tracks
ChatGPTRetrieve a paginated, unranked catalog of tracks associated with an artist UUID. Supports limit and offset. Returns track UUIDs, names and slugs, without track performance metrics. For an artist's most popular tracks use get_artist_top_tracks_by_channel. Requires a paid plan.
get_event_details
ChatGPTRetrieve an individual event's metadata using its Viberate event UUID. Returns name, venue, start time, genres, status and Songkick ID where available. Requires a paid plan.
get_event_lineup
ChatGPTRetrieve artists associated with an event UUID. Returns the event identity and an array of artist UUIDs, names and slugs. Does not include set times. Requires a paid plan.
get_festival_chart
ChatGPTRetrieve a ranked festival chart with optional sorting by Viberate score, lineup points, network points or start date. Supports genre, country, capacity-category, month and start-date-range filters, limit and offset. Returns festival metadata, scores, dates and pagination. Requires a paid plan.
get_festival_details
ChatGPTRetrieve a festival's metadata and external links by Viberate festival UUID. Returns available location, dates, genres, capacity category and platform links. Use get_festival_lineup for performing artists. Requires a paid plan.
get_festival_lineup
ChatGPTRetrieve the artist lineup associated with a festival UUID. Returns an array of artist UUIDs, names and slugs. The lineup identifies participating artists; it does not establish individual performance dates, stages or set times. Requires a paid plan.
get_label_artists
ChatGPTRetrieve a ranked, paginated roster of artists associated with a label UUID. Supports sort=streams|latest_release_date, timeframe=1w|1m|3m|12m|all, order, limit and offset. Returns artist profiles, label-associated performance statistics, chart information and latest-release information. Label-associated streams must not be represented as the artist's full-catalog total. Requires a paid plan.
get_label_chart
ChatGPTRetrieve ranked labels by sort metric and timeframe with optional country, genre, subgenre and Spotify-stream range filters. Returns label profiles, nested chart data, rank data and pagination. Free plan: up to 3 results; Professional + MCP: up to 20 per page.
get_label_details
ChatGPTRetrieve one label's metadata and external links by Viberate label UUID. Includes available name, address/country, genres, subgenres and contact information. For roster metrics use get_label_artists; for releases and track performance use get_label_tracks. Requires a paid plan.
get_label_tracks
ChatGPTRetrieve a ranked, paginated catalog of tracks associated with a label UUID. Supports sort metric, timeframe, order, limit, offset, genre, artist-country and release-date filters. Returns track metadata, artists, release dates, nested platform metrics and ranks. Use get_track_metrics for individual track histories. Requires a paid plan.
get_playlist_details
ChatGPTRetrieve one Spotify playlist's metadata using its Viberate playlist UUID. Returns name, Spotify ID, curator, follower count, one-month follower change, track count, genre information and playlist classification where available. Requires a paid plan.
get_playlist_tracks
ChatGPTRetrieve paginated tracks from a Spotify playlist UUID. Supports sort=position|date_added, order, limit, offset and genre/subgenre/playlist-type/popularity-type/release-type ID filters. Returns a nested playlist object containing tracks with position and date-added fields plus pagination. Requires a paid plan.
get_reference_data
ChatGPTRetrieve reference lookup values for Viberate channels, genres and subgenres, including IDs and names. Use the returned IDs to construct filters for other tools.
get_track_chart
ChatGPTRetrieve a ranked, paginated chart of tracks using sort and timeframe. Supports genre, subgenre and release-date filters. Sorting metrics include Spotify streams, YouTube views, airplay spins, SoundCloud plays, Shazam counts and Viberate performance score. Returns track records with nested platform metrics and pagination. Free plan: up to 3 results; Professional + MCP: up to 20 per page.
get_track_details
ChatGPTRetrieve a track's metadata, artists, ISRC information, platform links and current Viberate ranks by track UUID. Use for identification and source links. This tool does not provide historical metric series; use get_track_metrics for trends.
get_track_metrics
ChatGPTRetrieve a historical time series for one track UUID and metric, such as Spotify streams, YouTube views, TikTok views, Shazam counts or airplay spins. Optional date_from/date_to and period=daily|weekly|monthly. graph_mode: total returns observations, diff returns period changes; leave it out to get both. Free plan users must set graph_mode=total.
get_track_spotify_playlists
ChatGPTRetrieve Spotify playlists containing a specified track UUID. Requires sort=followers|track_position|track_added_date; supports order, limit and offset. Returns playlist identifiers, followers, track position and date added where available. Requires a paid plan.
get_venue_details
ChatGPTRetrieve one venue's metadata using its Viberate venue UUID. Returns available name, location, address, coordinates, genres and capacity type/range. Capacity range is not an exact attendance count. Requires a paid plan.
get_venue_events
ChatGPTRetrieve paginated upcoming or past events at a venue UUID. Optional filter=upcoming|past, limit and offset. Returns a venue wrapper containing its event list and pagination metadata. Requires a paid plan.
list_events
ChatGPTList events filtered by date range and location, sorted by start date with the earliest first. All filters are optional and can be combined: date_from, date_to, country, city and query. If neither date is set, date_from defaults to today, so only upcoming events are returned; set date_from to list past events. Use search_events instead to find one event by name or Songkick ID. Returns event UUIDs, names, venue, start time and status, with pagination. Requires a paid plan.
search_artists
ChatGPTSearch Viberate artists by name or external platform identifier. Supply either query or both channel_name and link_id; do not combine these modes. link_id is an external ID, not a URL. Supports limit and offset for name search. Returns matching artist UUIDs and identifying metadata including name, country, genre, rank and verification status.
search_artists_advanced
ChatGPTSearch Spotify artists when search_artists does not resolve the requested artist. Requires query; supports limit and offset. Returns Spotify artist ID, name, image, genres and a Viberate UUID where mapped. Verify the artist name before selecting a result. A null UUID cannot be used with Viberate artist detail or analytics tools. Requires a paid plan.
search_events
ChatGPTSearch individual events by name or Songkick event ID. Supply either query or both channel_name and link_id; for external ID lookup channel_name must be songkick. Returns event UUIDs, names, venue, start time and status. To browse events by date, country or city, use list_events. Requires a paid plan.
search_festivals
ChatGPTSearch festivals by name or external platform ID. Supply either query or both channel_name and link_id. Returns festival UUIDs, names, location, dates, genres, rank and size. Requires a paid plan.
search_labels
ChatGPTSearch record labels by name or external platform ID. Supply either query or both channel_name and link_id. Returns label UUIDs and identifying metadata such as name, country and genres. Requires a paid plan.
search_playlists
ChatGPTSearch Spotify playlists by name (query) or Spotify playlist ID (link_id). Do not supply both. Returns playlist UUID and available metadata such as curator, follower count, track count, genres and playlist type. Results may be returned as a paginated data object or a top-level array, depending on lookup mode. Requires a paid plan.
search_tracks
ChatGPTSearch Viberate tracks by name, ISRC or external platform identifier. Supply exactly one mode: query, isrc, or both channel_name and link_id. link_id must be a platform ID, not a URL. Returns matching track UUIDs, title, artists, ISRC, release date and metadata.
search_tracks_advanced
ChatGPTSearch Spotify tracks when search_tracks does not resolve a recording. Requires query; supports limit and offset. Returns Spotify track ID, title, artists, preview information and Viberate UUID where mapped. A null UUID cannot be passed to Viberate track tools. Verify track and artist before selecting a result. Requires a paid plan.
search_venues
ChatGPTSearch venues by name or external platform ID. Supply either query or both channel_name and link_id. Returns venue UUIDs, name, address, city, country, coordinates and capacity category where available. Disambiguate similarly named venues by location. Requires a paid plan.