Chartmetric MCP

Access Chartmetric's music industry analytics — artist, track, playlist, and chart data across 18 domains via natural language

От сообществаРаботаетБез входаГлобальныйБесплатноТолько чтение

Что умеет

  • Search Chartmetric Id: Search for a Chartmetric ID. REQUIRED: entity_name (string) - the bare entity name ONLY, with no extra qualifiers (no group/band, genre, language, country, or words copied from
  • Get Ai Insights: Get cached AI insights for a Chartmetric entity using semantic search. REQUIRED: entity_id (int, Chartmetric entity ID), search_terms (list of strings like 'TikTok engagement', 'audie
  • Tool Response Guidelines: Returns formatting guidance for presenting Chartmetric results in natural language rather than raw API detail. Optional: user_question (string) - if this is the first tool ca

Какие данные видит

Нужен ли аккаунт

Не нужен: сервер работает без входа

Access Chartmetric's music industry analytics — artist, track, playlist, and chart data across 18 domains via natural language

Список инструментов сервера (27)

Технические названия из tools/list. Нужны только разработчикам.

search_chartmetric_idSearch for a Chartmetric ID. REQUIRED: entity_name (string) - the bare entity name ONLY, with no extra qualifiers (no group/band, genre, language, country, or words copied from the user's question). E.g. for 'Winter from aespa (kpop)' pass 'Winter', NOT 'Winter aespa kpop'. Optional: entity_type ('artist'|'track'|'album') - if omitted, searches all entity types. Returns the cm_id needed for other tools. Optional: artist (string) - for a 'track' or 'album', the performing artist's bare name when known; many tracks/albums share a title, and this selects the one by that artist instead of an arbitrary same-title result. E.g. 'California Sober by Twin Fin' -> entity_name='California Sober', artist='Twin Fin'. The artist only disambiguates exact-title matches, so pass the bare title without qualifiers like '(feat. X)' or '- Remix'. When a title is shared by multiple artists and none is given, the tool returns the candidates to choose from. Leave empty for other entity types. Optional: user_question (string) - if this is the first tool call after a new user question, pass the exact user question here verbatim for observability; omit on subsequent calls within the same question. Optional: reasoning (string, 1-2 sentences) - briefly explain why you chose this tool.
get_ai_insightsGet cached AI insights for a Chartmetric entity using semantic search. REQUIRED: entity_id (int, Chartmetric entity ID), search_terms (list of strings like 'TikTok engagement', 'audience demographics', 'streaming performance'). Optional: entity_type (string, 'artist' or 'track', defaults to 'artist'). Optional: user_question (string) - if this is the first tool call after a new user question, pass the exact user question here verbatim for observability; omit on subsequent calls within the same question. Optional: reasoning (string, 1-2 sentences) - briefly explain why you chose this tool.
tool_response_guidelinesReturns formatting guidance for presenting Chartmetric results in natural language rather than raw API detail. Optional: user_question (string) - if this is the first tool call after a new user question, pass the exact user question here verbatim for observability; omit on subsequent calls within the same question. Optional: reasoning (string, 1-2 sentences) - briefly explain why you chose this tool.
get_relevant_endpointsDiscover relevant Chartmetric API endpoints for a given query. Uses semantic search over sitemap features to find matching endpoints. Returns endpoint paths, methods, and descriptions but NOT parameter details. Use get_endpoint_details to get parameter specs for a specific endpoint. Optional: user_question (string) - if this is the first tool call after a new user question, pass the exact user question here verbatim for observability; omit on subsequent calls within the same question. Optional: reasoning (string, 1-2 sentences) - briefly explain why you chose this tool.
get_endpoint_detailsGet detailed parameter specifications for a specific Chartmetric API endpoint. Returns parameter names, types, required/optional status, constraints, and location (path/query/header). Use get_relevant_endpoints first to discover endpoints, then this tool to get parameters for a specific one. Pass service ('main' or 'flow', as surfaced by get_relevant_endpoints; defaults to 'main') to disambiguate when the same endpoint path exists under more than one service. Optional: user_question (string) - if this is the first tool call after a new user question, pass the exact user question here verbatim for observability; omit on subsequent calls within the same question. Optional: reasoning (string, 1-2 sentences) - briefly explain why you chose this tool.
call_read_apiDEPRECATED — prefer the query_* and get_artist/get_track tools; they are faster (no discovery step) and cover most endpoints. Use this only when no domain tool covers the endpoint you need. Makes a GET request to any Chartmetric API endpoint. Use get_relevant_endpoints first to discover available endpoints, their parameters, and their owning service. Pass the endpoint path (e.g., '/artist/123'), the service ('main' or 'flow', as surfaced by get_relevant_endpoints / get_endpoint_details; defaults to 'main'), and optional query parameters. Optional: user_question (string) - if this is the first tool call after a new user question, pass the exact user question here verbatim for observability; omit on subsequent calls within the same question. Optional: reasoning (string, 1-2 sentences) - briefly explain why you chose this tool.
get_cm_factsRetrieve semantically relevant facts about Chartmetric's data (public, non-internal) that can ground reasoning before planning a SQL query or answering a music analytics question. These facts clarify the limitations, definitions, and nuances of Chartmetric's datasets and platform features (e.g., chart position limits, metric definitions). Not general industry facts. Optional: user_question (string) - if this is the first tool call after a new user question, pass the exact user question here verbatim for observability; omit on subsequent calls within the same question. Optional: reasoning (string, 1-2 sentences) - briefly explain why you chose this tool.
query_albumsChartmetric albums data, one operation per API endpoint. Every operation below operates on albums. REQUIRED: operation (string) - pick one from the list below. Resolve a name to a Chartmetric id with search_chartmetric_id first, then pass it as id (if id is also present in params, the id argument wins). Query parameters go in params (a dict); any path placeholder other than {id} goes in params too (e.g. params={'streamingType': 'spotify'}). For the full parameter spec of one operation, call get_endpoint_details with its path template. Optional: user_question (string) - if this is the first tool call after a new user question, pass the exact user question here verbatim for observability; omit on subsequent calls within the same question. Optional: reasoning (string, 1-2 sentences) - briefly explain why you chose this tool. Operations: - get_album (/album/{streamingType}/{id}): Album metadata: name, artwork, record label, UPC, release date and track count, the credited Chartmetric artists, the album's linked Spotify, iTunes, Deezer and Boomplay ids, and its Chartmetric mood and activity tags. Use streamingType=cm with a Chartmetric album id — of the values the streamingType schema enum carries only cm and itunes resolve (itunes wants Chartmetric's internal iTunes album id, not the Apple collection id); spotify and amazon have non-numeric ids the route's integer validator rejects, deezer errors upstream, and every other value returns 400 'Streaming type does not exist.' - get_album_chart_summary (/album/{streamingType}/{id}/albumChartSummary): Retrieves album chart summary data for a specified streaming platform. Returns information on chart events and unique tracks for the given album ID. - get_artist_ids (/album/{id}/artistIds): Retrieves a list of artist IDs associated with a specific album. Returns a structured response indicating the presence of artist data linked to the specified album ID. - get_charts (/album/{streamingType}/{id}/charts): Retrieves chart data for albums based on the specified streaming type and album ID. Returns detailed ranking information and metadata, including artist details, album information, genre, moods, and more. - get_comparable_metrics (/album/comparable/metrics): Retrieves comparable metrics for specified albums across multiple streaming platforms. Returns various statistics, including playlist counts and reach, as well as popularity data for the albums provided. - get_comparable_metrics_metadata (/album/comparable/metrics/metadata): Retrieves comparable metrics metadata for various music platforms. Returns information related to likes, views, and followers, along with comparability details for city and country analysis. - get_discogs_stats (/album/{id}/discogs/stats): Retrieves statistical data for a specified album from the Discogs database. Returns an array of statistics related to the album, including metrics such as popularity and sales. - get_flags_by_id_type (/album/{id}/flags/{type}): Retrieves flag information for a specific album on a given platform, allowing users to view events categorized by type, such as milestones or playlist additions. Returns a list structure containing relevant flag data. - get_flags_by_id_type_date (/album/{id}/flags/{type}/{date}): Timeline flag events for an album on one calendar date — Apple Music / iTunes only, so in practice that day's playlist adds: playlist name, artwork and track count, the track added and its position, the storefront, and how long it stayed. - get_flags_by_type (/album/flags/{type}): Retrieves flagging information for albums based on the specified type from a given platform. Returns a structured response containing relevant metadata and status indicators. - get_ids (/album/{platform}/{id}/get-ids): Retrieves album ID information from the specified music platform. Returns a collection of album details including identifiers across various platforms for the given album. - get_list (/album/list): Retrieves a list of albums from the Chartmetric database. Returns detailed metadata for each album, including identifiers, labels, mood tags, scoring, and latest metrics on airplay and streaming popularity. - get_list_stats (/album/list/stats): Retrieves statistical data for albums in the Chartmetric database. Returns aggregated metrics on total albums, categorized by bands, moods, countries, and record labels. - get_milestones (/album/{id}/milestones): Retrieves milestone data for a specific album identified by its unique ID. Returns a structured object containing details about the album's milestones. - get_milestones_stats (/album/{id}/milestones/stats): Retrieves milestone statistics for a specific album by its ID. Returns a dictionary containing various statistical data related to the album's milestones. - get_playlist_reach_stats (/album/{id}/cmStats): Playlist reach for an album: Spotify playlist count, editorial playlist count, total playlist reach and editorial reach, Spotify popularity, and the Apple Music, Amazon, Deezer and YouTube playlist-count equivalents. - get_tracks (/album/{streamingType}/{id}/tracks): Retrieves a list of tracks for a specified album from various streaming platforms. Returns a structured response containing track information based on the provided album ID and streaming type. - get_tunefind (/album/{id}/tunefind): Retrieves TuneFind data for a specific album. Returns a list of relevant information associated with the identified album's tracks. - get_tunefind_episodes (/album/{id}/tunefind/episodes): Retrieves episode data related to a specific album from the TuneFind database. Returns a list of episodes associated with the specified album ID. - get_tunefind_video_games (/album/{id}/tunefind/video-games): Video-game sync placements for an album's tracks, sourced from Tunefind. - get_youtube_comments (/album/{id}/youtube/comments): Retrieves YouTube comments for a specific album identified by its unique ID. Returns a structured dictionary containing the comments related to the album. - get_youtube_videos (/album/{id}/youtube/videos): Retrieves YouTube video data for a specific album. Returns a list of videos associated with the given album ID.
query_artistsChartmetric artists data, one operation per API endpoint. Every operation below operates on artists. REQUIRED: operation (string) - pick one from the list below. Resolve a name to a Chartmetric id with search_chartmetric_id first, then pass it as id (if id is also present in params, the id argument wins). Query parameters go in params (a dict); any path placeholder other than {id} goes in params too (e.g. params={'streamingType': 'spotify'}). For the full parameter spec of one operation, call get_endpoint_details with its path template. Optional: user_question (string) - if this is the first tool call after a new user question, pass the exact user question here verbatim for observability; omit on subsequent calls within the same question. Optional: reasoning (string, 1-2 sentences) - briefly explain why you chose this tool. Operations: - get_ai_insights (/artist/{id}/aiInsights): Retrieves AI insights for a specific artist using their unique identifier. Returns a summary of performance metrics and insights related to the artist's influence and popularity. - get_airplay_dump (/artist/{id}/airplay-dump): Retrieves airplay data for a specific artist. Returns a list of airplay metrics associated with the specified artist ID. - get_album_release_at_date (/artist/{id}/albumReleaseAtDate): Retrieves album release information for a given artist by their ID. Returns a list of albums with details such as UPC, name, label, image URL, and release date. - get_album_release_dates (/artist/{id}/albumReleaseDates): Retrieves album release dates for a specified artist by their ID. Returns a list of release dates within a given timeframe. - get_albums (/artist/{id}/albums): Retrieves a list of albums for a specific artist identified by their unique ID. Returns a structured response containing album information associated with the specified artist. - get_anr_by_playlists (/artist/ANR/by/playlists): Retrieves playlists data for an artist on Chartmetric. Returns a list of playlists organized based on specified criteria, including trends in follower reach over time. - get_anr_by_social_index (/artist/ANR/by/socialIndex): Retrieves social index data for a specific artist from Chartmetric. Returns a ranked list of social media metrics and engagement statistics based on the specified sorting criteria. - get_anr_list_stats_social_index (/artist/ANR/list/stats/socialIndex): Retrieves social index statistics for a specific artist on Chartmetric. Returns a total count of social media engagements along with filtered data on genres and geographical distribution. - get_anr_metrics (/artist/ANR/metrics): Retrieves performance metrics for a specific artist on Chartmetric. Returns detailed information including artist ID, name, tags, genres, career stage, user curation data, and the latest release date. - get_anr_metrics_parallel_follower_growth (/artist/ANR/metrics/parallel-follower-growth/{id}): Retrieves metrics on parallel follower growth for a specific artist identified by the given ID. Returns a structured data object containing relevant follower growth metrics. - get_anr_stats (/artist/ANR/stats): Retrieves statistics for the artist with the identifier "ANR". Returns aggregated data including total counts, genre tags, geographic distribution, gender breakdown, and label affiliations. - get_artist_chart_insights (/artist/{id}/artistChartInsights): Retrieves insights on an artist's chart performance. Returns a structured object containing relevant data about the artist's standing and metrics in charts. - get_artist_chart_insights_top_and_trending (/artist/{id}/artistChartInsightsTopAndTrending): Retrieves top and trending chart insights for a specific artist by their ID. Returns details on the leading and trending tracks, including ISRC codes, track names, countries, and associated image URLs. - get_artist_chart_summary (/artist/{streamingType}/{id}/artistChartSummary): Retrieves the artist chart summary for a specified streaming platform. Returns data on chart events and unique tracks over a given time period. - get_audience_top_locations (/artist/{id}/top-locations): Where an artist's audience is: top countries and top cities by listener/fan volume. This is the city-by-city and country-by-country audience breakdown. - get_batch_milestones (/artist/batch/milestones): Retrieves milestone insights for artists in bulk from the Chartmetric database. Returns a count of insights along with detailed information about each milestone, including artist-related metadata and summary data. - get_batch_similar_artists (/artist/batch/similar-artists): Retrieves a list of similar artists based on the provided artist IDs. Returns a dictionary containing relevant similarity data for each specified artist. - get_bio (/artist/{id}/bio): Retrieves the biography information for a specific artist identified by their unique ID. Returns a structured dictionary containing the artist's bio details. - get_brand_list (/artist/{id}/brand/list): Retrieves a list of brands associated with a specific artist identified by their ID. Returns detailed brand information including category, verification status, demographics of followers, and brand links. - get_brand_list_categories (/artist/{id}/brand/list/categories/{category}): Brands in one brand category whose audience matches an artist's: match score, follower counts and contact details, paginated with a total. - get_brand_list_countries (/artist/{id}/brand/list/countries/{code2}): Brands based in one country (ISO alpha-2) whose audience matches an artist's: match score, follower counts and contact details, paginated with a total. - get_brand_list_stats (/artist/{id}/brand/list/stats): Retrieves brand statistics for a specific artist identified by their ID. Returns aggregated data on countries, categories, Instagram followers, and subcategories related to the artist's brand engagement. - get_brand_posts (/artist/{id}/brand/posts): Retrieves brand-related social media posts for a specific artist identified by their ID. Returns details about each post, including links, content, engagement metrics, and sponsorship information. - get_brand_posts_history (/artist/{id}/brand/posts/{postId}/history): Retrieves the historical data for a specific brand post associated with an artist identified by the provided ID. Returns a structured list of historical entries related to the specified post. - get_brand_posts_stats (/artist/{id}/brand/posts/stats): Retrieves brand post statistics for a specific artist by their ID. Returns data on hashtags, mentions, and sponsors related to the artist's posts. - get_career (/artist/{id}/career): Retrieves career data for a specific artist identified by their unique ID. Returns a dictionary containing comprehensive information about the artist's career trajectory and related metrics. - get_chart_history (/artist/{streamingType}/{id}/charts): Chart appearances for an artist on one streaming platform (spotify, itunes, applemusic, shazam, tiktok, youtube, deezer, amazon, …): chart name, country, rank, peak rank and time on chart. - get_chart_insights_top_and_trending (/artist/{id}/chart-insights/top-and-trending/{platform}): Retrieves top and trending chart insights for a specified artist on the given platform. Returns a dictionary containing relevant ranking data and insights related to the artist's performance. - get_chart_score (/artist/{id}/chart-score): Retrieves the chart score for a specific artist based on their unique identifier. Returns a structured JSON object containing the artist's chart performance data. - get_chart_top_countries (/artist/{id}/chart-top-countries): Retrieves the top chart countries for a specific artist based on their ID. Returns an array of country-specific chart data related to the artist's performance. - get_charted_countries (/artist/{streamingType}/{id}/charted-countries): Countries where an artist's tracks or albums appeared on one platform's charts over the requested day window. - get_cluster_artists (/artist/{id}/clusterArtists): Retrieves a list of artists clustered by similarities based on a specified metric for a given artist ID. Returns detailed ranking and engagement data for the related artists. - get_cm_stats_comparison_group (/artist/{id}/cmStats/comparison-group): Peer artists whose value for a platform's headline metric sits within 25% of this artist's, each with that metric plus genre and country ranks. - get_cm_stats_movements (/artist/{id}/cmStats/movements): Retrieves movement statistics for a specific artist identified by their unique ID. Returns a structured dictionary containing relevant data regarding the artist's performance metrics. - get_cm_stats_movements_batch (/artist/cmStats/movements/batch): Retrieves movement statistics for artists, providing insights into their growth across various metrics. Returns detailed data on weekly changes and current values for specific engagement and popularity indicators. - get_collaborations (/artist/{id}/collaborations): Retrieves collaboration data for a specific artist identified by the provided ID. Returns a dictionary containing details about the artist's collaborations. - get_collaborations_tracks (/artist/{id}/collaborations/tracks): Retrieves a list of collaborative tracks for a specific artist. Returns the total number of collaborations along with the corresponding track details. - get_comparable_locations (/artist/comparable/locations/{metric}): Retrieves comparable artist location data based on the specified metric. Returns a list of cities and countries with associated geographical and demographic information, including artist presence and population statistics. - get_comparable_metrics (/artist/comparable/metrics): Retrieves comparable metrics for specified artists. Returns performance data across various platforms, including spins, views, likes, and followers. - get_comparable_metrics_metadata (/artist/comparable/metrics/metadata): Retrieves metadata metrics for comparable artists across various platforms. Returns ranking information and engagement statistics related to each platform, such as likes, views, and followers. - get_comparable_time_machine (/artist/comparable/time-machine): Retrieves comparable artist data from the Chartmetric database. Returns raw response data for the specified artists in the form of a string. - get_comparison_report (/artist/{id}/comparison-report): Retrieves a comparison report for an artist based on their unique identifier. Returns detailed metrics and insights across various platforms, including TikTok, Spotify, YouTube, and airplay statistics. - get_comparison_report_suggestions (/artist/comparison-report/suggestions): Retrieves artist comparison suggestions based on specified artist IDs. Returns a raw response consisting of data related to the comparative analysis of the artists. - get_events (/artist/{id}/{status}/events): Retrieves event data for a specific artist based on their status (current or past). Returns a list of events occurring from a specified number of days ago. - get_events_co_performers (/artist/{id}/events/co-performers): Retrieves co-performer data for a specified artist. Returns a list of co-performing artists along with their event statistics and last performance details. - get_events_co_performers_shared_events (/artist/{id}/events/co-performers/{coArtistId}/shared-events): Retrieves shared event information for a specified artist and their co-performer. Returns a list of events where both artists are scheduled to perform together. - get_events_top_venues (/artist/{id}/events/top-venues): Retrieves the top venues for events associated with a specific artist. Returns a list structure containing venue data related to the artist's live performances. - get_flags_by_id_type (/artist/{id}/flags/{type}): Retrieves flag information for a specific artist based on the provided ID and flag type, allowing users to track milestones, sync events, or playlist additions associated with the artist. Returns a list of relevant flag objects indicating the specified artist's activities. - get_flags_by_id_type_date (/artist/{id}/flags/{type}/{date}): Timeline flag events for an artist on one calendar date — Apple Music / iTunes only, so in practice that day's playlist adds. - get_flags_by_type (/artist/flags/{type}): Retrieves flag data for artists based on the specified type. Returns a structured object containing relevant artist flags and associated information. - get_genre_order (/artist/{id}/genreOrder): Retrieves the genre order for a specific artist identified by their unique ID. This endpoint returns a list of genres associated with the artist, including their identifiers and source information. - get_genre_tags (/artist/genreTags/{genreType}): Retrieves genre tags for artists based on the specified genre type. Returns a list of corresponding genre tags that categorize artists within the Chartmetric database. - get_ids (/artist/{platform}/{id}/get-ids): Retrieves artist identification data across specified platforms. Returns detailed information including various platform-specific artist IDs and names for the requested artist. - get_initial (/artist/{id}/initial): Retrieves initial artist data from the Chartmetric API based on the provided artist ID. Returns a structured JSON object containing relevant details about the artist. - get_insights (/artist/insights): Retrieves insights for specified artists over a defined time range. Returns detailed analytical data in a structured format for the requested artist IDs. - get_label_evidence (/artist/{id}/label/{labelId}/evidence): Retrieves evidence data related to a specific artist and label on Chartmetric. Returns links to various sources including YouTube videos, Wikidata entries, and Wikipedia articles associated with the artist. - get_labels (/artist/{id}/labels): Retrieves label information for a specific artist based on their unique identifier. Returns a dictionary containing the associated labels of the specified artist. - get_list (/artist/list): Retrieves a list of artists from the Chartmetric database. Returns the total number of artists and the offset for pagination. - get_list_legacy (/artist/list/legacy): Retrieves a list of artists from the Chartmetric database. Returns detailed metadata for each artist, including identifiers, genres, and their latest performance metrics. - get_list_recommended (/artist/list/recommended): Retrieves a list of recommended artists from the Chartmetric API. Returns an array of artist objects, each containing the artist's ID, name, image URL, preview URL of a track, and the corresponding preview track ID. - get_list_stats (/artist/list/stats): Retrieves statistical data for artists in the Chartmetric database. Returns aggregated counts of artists filtered by DJ type, genre tags, and mood classifications. - get_list_stats_percent_histograms (/artist/list/stats/percent-histograms): Retrieves historical percentage statistics for artists from the Chartmetric API. Returns a dictionary containing statistical data based on the specified time period of interest. - get_mentions (/artist/{id}/mentions): Retrieves mention data for a specific artist identified by their unique ID. Returns a list of mentions associated with the artist in the dataset. - get_metadata (/artist/{id}): Retrieves detailed information about a specific artist using their unique identifier. Returns metadata including the artist's name, genres, ISNI, gender, debut date and ranking data. - get_milestones (/artist/{id}/milestones): Retrieves milestone data for a specific artist identified by their unique ID. Returns a structured dictionary containing relevant milestone information associated with the artist. - get_milestones_stats (/artist/{id}/milestones/stats): Retrieves milestone statistics for a specific artist identified by their unique ID. Returns a structured data object containing the relevant statistical information for the artist's milestones. - get_neighboring_artists (/artist/{id}/neighboring-artists): Retrieves neighboring artists for a specific artist identified by their ID, based on various engagement metrics. Returns a list of related artists along with their corresponding metrics for analysis. - get_neighboring_artists_clustered (/artist/{id}/neighboring-artists/clustered): Retrieves a list of neighboring artists for a specified artist, clustered by performance metrics. Returns detailed ranking and engagement data related to the specified artist's influence and connections within the music landscape. - get_network_strength (/artist/{id}/network-strength): Retrieves the network strength of an artist across various social media platforms. Returns a score indicating the overall influence and detailed platform-specific metrics, including scores and active user counts. - get_noteworthy_insights (/artist/{id}/noteworthy-insights): Retrieves noteworthy insights for a specific artist based on their unique identifier. Returns detailed data regarding significant metrics and trends on various platforms, including statistics on listeners and followers. - get_playlist_adds_by_id_platform (/artist/{id}/{platform}/playlist-adds): Retrieves playlist add data for a specific artist on the designated platform. Returns a list indicating the number of times the artist's music has been added to playlists on that platform. - get_playlist_adds_by_id_platform_date (/artist/{id}/{platform}/playlist-adds/{date}): Retrieves playlist addition data for a specific artist on the specified platform for the given date. Returns a list object containing the relevant playlist adds information. - get_playlists_recommendation (/artist/{id}/playlists/recommendation): Retrieves recommended playlists for a specific artist based on their ID. Returns detailed information on tracks, curators, and playlist characteristics, including fit scores and reach metrics. - get_rank_trends (/artist/{id}/rankTrends): Retrieves ranking trends for a specific artist based on their unique identifier. Returns historical ranking data and timestamps for the artist across multiple entries. - get_recommended_collaborators (/artist/{id}/recommended-collaborators): Retrieves recommended collaborators for a specific artist based on various similarity metrics. Returns a list of potential collaborators along with their relevant attributes and engagement scores. - get_related_artists (/artist/{id}/relatedArtists): Retrieves a list of related artists for a specified artist ID. Returns a collection of related artist objects based on the provided parameters. - get_riaa_awards (/artist/{id}/riaa-awards): Retrieves RIAA award data for a specific artist based on their ID. Returns a list of awards associated with the artist. - get_rich_comparison (/artist/{id}/rich-comparison): Retrieves rich comparison statistics for a specific artist against another artist. Returns detailed statistical data for both the main artist and the comparing artist in a structured format. - get_score_explainability (/artist/{id}/score-explainability): Explains why an artist's Chartmetric Score (cm_score) changed over a chosen period by breaking the movement into the individual platform metrics that drove it — each with a percent change, its weight in the score, a signed weighted impact, and an impact level. Supports a latest snapshot per period or a full historical range. - get_similar_artists_by_configurations (/artist/{id}/similar-artists/by-configurations): Retrieves similar artists for a specified artist ID based on various configurations. Returns a dictionary object containing relevant data about the similar artists. - get_similar_artists_by_genre_metric (/artist/{id}/similarArtists): Artists similar to a given artist, ranked by one performance metric and optionally restricted to a genre. The metric-ranked variant of similar-artist lookup. - get_similar_artists_country_counts (/artist/{id}/similar-artists/country-counts): Retrieves a list of similar artists for a specified artist ID. Returns the count of similar artists categorized by country. - get_similar_artists_filtered (/artist/{id}/similar-artists): Artists similar to a given artist, narrowed by band vs solo, career stage, career trend, genre, sub-genre, country or pronouns. Returns similarity scores and optionally each artist's latest stats. - get_social_and_streaming_stats (/artist/{id}/cmStats): Fanbase metrics for an artist: Spotify monthly listeners, Spotify followers and popularity, Instagram followers and engagement rate, YouTube subscribers and views, TikTok followers and likes, Facebook, Twitter, Deezer, SoundCloud and Shazam counts — latest snapshot plus weekly/monthly deltas and total fanbase. Pass `date` for a historical snapshot. - get_social_engagement_by_platform (/artist/{id}/social-engagement): Per-platform engagement rates and overall influence score for an artist (Instagram, TikTok, YouTube, Twitter, Facebook). - get_social_impact_network (/artist/{id}/social-impact/network): Retrieves social impact network data for a specific artist. Returns a list indicating the artist's influence and reach across various social platforms. - get_sounds_performance (/artist/{id}/soundsPerformance): Retrieves sound performance data for a specific artist on TikTok. Returns aggregated statistics and individual sound details, including total uses and creator information for each sound. - get_sounds_performance_records (/artist/{id}/soundsPerformance/records): Retrieves performance records for a specific artist identified by the given ID. Returns an array of sound performance records associated with the artist. - get_sounds_performance_stats (/artist/{id}/soundsPerformance/stats): Retrieves performance statistics for a specified artist's sounds. Returns the total count of sounds and tracked videos associated with the artist. - get_streams_spotify (/artist/streams/spotify): Spotify play counts for a Spotify artist id, broken down by album or by track and joined back to Chartmetric ids. - get_tiktok_follower_activity (/artist/{id}/tiktok/postActivity): Daily TikTok posting activity and follower counts for an artist, with day-over-day changes. - get_tiktok_posts (/artist/{id}/tiktok/posts): Retrieves TikTok posts associated with a specific artist identified by the given ID. Returns a JSON object containing an array of the artist's TikTok posts and relevant metadata. - get_tiktok_top_influencers_deep_social (/artist/{id}/tiktokTopInfluencers/deepSocial): Retrieves top TikTok influencers for a specified artist. Returns a dictionary containing deep social analytics related to the artist's influence on TikTok, YouTube Shorts, or Instagram Reels. - get_tiktok_top_influencers_featured_videos (/artist/{id}/tiktokTopInfluencers/featuredVideos): Returns the top TikTok videos grouped by creator for influencers using an artist's sounds, for creator preview and post drilldowns. - get_tiktok_top_videos (/artist/{id}/tiktok/topVideos): Retrieves the top TikTok videos for a specific artist identified by their unique ID. Returns detailed metadata and engagement statistics for each video, including links, descriptions, and performance metrics. - get_tiktok_top_videos_featured_tracks (/artist/{id}/tiktok/topVideos/featuredTracks): Retrieves featured TikTok videos for a specific artist. Returns a list of top tracks along with their metadata, including ID, title, video count, and associated image URLs. - get_tiktok_top_videos_filter_stats (/artist/{id}/tiktok/topVideos/filterStats): Retrieves TikTok filter statistics for an artist's top videos based on the provided artist ID. Returns the maximum and minimum counts of likes, saves, views, shares, and comments for those videos. - get_tiktok_video_trends (/artist/tiktokVideoTrends): Daily view, like and comment history for one TikTok video of a TikTok account. - get_top_influencers (/artist/{id}/topInfluencers/{domain}): Retrieves the top influencers for a specific artist on the given social media domain. Returns a list of influencers associated with the artist, relevant to the specified platform. - get_top_influencers_stats (/artist/{id}/topInfluencers/{domain}/stats): Retrieves statistics on the top influencers for a specified artist within a given domain. Returns detailed demographic and filtering information related to the influencers, including tags, types, gender, age groups, and more. - get_top_influencers_tiktok_creator (/artist/{id}/topInfluencers/tiktok/{influencerArtistId}/creator): Retrieves the top TikTok influencers associated with a specific artist based on their unique IDs. Returns a structured object containing relevant influencer data for the specified artist. - get_top_videos_by_id (/artist/{id}/topVideos): Retrieves the top videos for a specified artist on TikTok, YouTube Shorts, or Instagram Reels. Returns a count of available videos along with a list of the top videos based on the specified metrics. - get_top_videos_by_id_platform (/artist/{id}/{platform}/topVideos): Retrieves the top videos for a specified artist on a given platform. Returns detailed video metadata, including engagement statistics and user information. - get_track_release_dates (/artist/{id}/trackReleaseDates): Retrieves track release dates for a specific artist identified by their ID. Returns a list of release dates within a specified time frame relative to the current date. - get_tracks (/artist/{id}/tracks): Retrieves a list of tracks for a specific artist identified by their unique ID. Returns detailed information about each track, including metadata such as album details, genre, moods, and ranking scores. - get_tracks_top (/artist/{id}/tracks/top): Retrieves the top tracks for a specific artist. Returns a list of tracks that represent the artist's highest-performing music. - get_trending_artists (/artist/trendingArtists): Retrieves a list of trending artists. Returns data representing the artists currently trending in the music industry. - get_tunefind (/artist/{id}/tunefind): Retrieves Tunefind data for a specified artist. Returns a list of music tracks associated with the artist from the Tunefind database. - get_tunefind_episodes (/artist/{id}/tunefind/episodes): Retrieves detailed episode data for a specified artist from the Tunefind platform. Returns a structured list of episodes associated with the artist's music. - get_tunefind_video_games (/artist/{id}/tunefind/video-games): Retrieves video game data associated with a specified artist. Returns a list of games along with relevant track information, including track details and their respective game IDs. - get_tvmaze (/artist/{id}/tvmaze): Retrieves TV show information associated with a specific artist. Returns a structured dictionary containing data related to the artist's appearances and involvement in television shows. - get_youtube (/artist/{id}/youtube): Retrieves YouTube data for a specific artist identified by their ID. Returns a list of relevant data along with pagination information, including total counts and offsets. - get_youtube_comments (/artist/{id}/youtube/comments): Retrieves YouTube comments for a specific artist identified by their unique ID. Returns a structured response containing the comments associated with the artist's YouTube presence. - get_youtube_noteworthy_comments (/artist/{id}/youtube/noteworthy-comments): Retrieves noteworthy comments for a specific artist on YouTube. Returns a list of comments associated with the artist's content. - get_youtube_sounds_posts (/artist/{id}/youtubeSoundsPosts): Retrieves YouTube sound post data for a specific artist identified by their unique ID. Returns a list of sound posts related to the artist's activity on the platform. - get_youtube_subscribers_and_views (/artist/{id}/youtube/channel): YouTube channel statistics for an artist: subscribers, views, their platform ranks, and weekly deltas. - get_youtube_trending (/artist/{id}/youtube/{trendingType}/trending): Retrieves trending YouTube content for a specified artist. Returns a list object containing trending videos or shorts based on the given artist ID and trending type.
query_brandsChartmetric brands data, one operation per API endpoint. Every operation below operates on brands. REQUIRED: operation (string) - pick one from the list below. Resolve a name to a Chartmetric id with search_chartmetric_id first, then pass it as id (if id is also present in params, the id argument wins). Query parameters go in params (a dict); any path placeholder other than {id} goes in params too (e.g. params={'streamingType': 'spotify'}). For the full parameter spec of one operation, call get_endpoint_details with its path template. Optional: user_question (string) - if this is the first tool call after a new user question, pass the exact user question here verbatim for observability; omit on subsequent calls within the same question. Optional: reasoning (string, 1-2 sentences) - briefly explain why you chose this tool. Operations: - get_artist_countries (/brand/{id}/artist-countries): Retrieves a list of countries associated with artists for a specific brand. Returns an array of country data relevant to the given brand ID. - get_artist_languages (/brand/{id}/artist-languages): Audience languages of the artists matching a brand: each language with the number of those artists whose Instagram, TikTok or YouTube audience counts it among their top five, ranked by that count. - get_audience (/brand/{id}/audience): Retrieves audience insights for a specified brand by its ID. Returns demographic information, top countries, top interests, and the source platform related to the brand's audience. - get_brand (/brand/{brandId}): Retrieves brand information associated with a specific brand ID. Returns a structured object containing relevant brand details. - get_countries (/brand/{id}/countries): Retrieves country-specific branding data for a given brand ID. Returns a structured dictionary containing relevant information about the brand's presence across various countries. - get_genres (/brand/{id}/genres): Retrieves genre information for a specific brand identified by its unique ID. Returns a list structure indicating the genres associated with the specified brand. - get_list (/brand/list): Retrieves a list of brands from the Chartmetric database. Returns an object containing brand-related information in a structured format. - get_list_v2 (/brand/list/v2): Retrieves a list of brands available on the platform. Returns detailed information about each brand, including attributes such as name, country, category, associated top artists, and audience demographics. - get_names (/brand/names): Retrieves a list of brand names from the Chartmetric database. Returns an array of objects containing the unique identifiers and names of each brand. - get_top_artists (/brand/{id}/top-artists): Retrieves a list of top artists for a specified brand. Returns an object containing an array of artist data and the total count of artists. - get_top_posts (/brand/{id}/top-posts): Retrieves the top posts for a specified brand. Returns a structured data response containing an array of popular posts associated with the provided brand ID.
query_chartsChartmetric charts data, one operation per API endpoint. Every operation below operates on charts. REQUIRED: operation (string) - pick one from the list below. Resolve a name to a Chartmetric id with search_chartmetric_id first, then pass it as id (if id is also present in params, the id argument wins). Query parameters go in params (a dict); any path placeholder other than {id} goes in params too (e.g. params={'streamingType': 'spotify'}). For the full parameter spec of one operation, call get_endpoint_details with its path template. Optional: user_question (string) - if this is the first tool call after a new user question, pass the exact user question here verbatim for observability; omit on subsequent calls within the same question. Optional: reasoning (string, 1-2 sentences) - briefly explain why you chose this tool. Operations: - get_acr_artists_trend (/charts/acr/artists-trend): Retrieves trending data for a specific artist on the Chartmetric platform. Returns a list of rankings, play counts, and timestamps for the specified time frame. - get_acr_siriusxm_tracks_trend (/charts/acr/siriusxm-tracks-trend): Retrieves trend data for the specific SiriusXM track on the Chartmetric platform. Returns ranking information and play count metadata for the specified time period. - get_acr_tracks_trend (/charts/acr/tracks-trend): Retrieves trend data for a specific track on the Chartmetric API. Returns ranking information along with the associated counts and timestamps for each entry in the specified period. - get_amazon_albums_trend (/charts/amazon/albums-trend): Rank history of one album on an Amazon Music album chart (popular_album or new_album) in one storefront country and genre: rank and date at each chart run. - get_amazon_tracks_trend (/charts/amazon/tracks-trend): Rank history of one track on an Amazon Music track chart (popular_track or new_track) in one storefront country and genre: rank and date at each chart run. - get_anghami_tracks_trend (/charts/anghami/tracks-trend): Retrieves the trending tracks data from Anghami. Returns a list of tracks along with their ranking information for the specified time period. - get_anghami_tracks_trend_liked (/charts/anghami/tracks-trend/liked): Retrieves trending track data for the Anghami platform based on user likes. Returns a list of ranked tracks along with relevant metadata for the specified time frame. - get_apple_music_albums_trend (/charts/apple_music/albums-trend): Retrieves trending album data from Apple Music. Returns a list of ranking information along with timestamps for the specified album. - get_apple_music_playlists (/charts/apple_music/playlists): Retrieves playlist information from Apple Music. Returns details such as playlist names, rankings, ownership, and additional metadata. - get_apple_music_tracks_trend (/charts/apple_music/tracks-trend): Retrieves trending track data for Apple Music. Returns ranking information along with timestamps for the specified track over a defined time period. - get_apple_music_videos_trend (/charts/apple_music/videos-trend): Retrieves trending video chart data from Apple Music. Returns ranking information along with corresponding timestamps for the specified video. - get_beatport_tracks_trend (/charts/beatport/tracks-trend): Retrieves trending track data from Beatport. Returns ranking information for track over a specified time period. - get_chart_ranks_by_country (/charts/ranking/{platform}/{byType}/{id}): Every country in which one entity (artist, album, track, playlist, video or shorts) was charting on a platform on a given date, with its rank and the chart genre in each. - get_charts (/charts): One platform's chart for a date or day range: ranked entries with rank, rank change and trend, peak rank and peak date, periods and consecutive periods on chart, 7-day velocity and countries charting, plus entity metadata — selectable by chartEntity (track, album, artist, video), chart type, country, city, genre and duration. - get_cities (/charts/cities/{streamingType}): Retrieves chart data for cities based on the specified streaming type. Returns a list of city-specific chart information relevant to the chosen streaming platform. - get_countries (/charts/countries/{streamingType}): Retrieves country-specific chart data based on the selected streaming type. Returns a list of country codes representing the regions available for the specified streaming type. - get_dates (/charts/{streamingType}/dates): Retrieves date information for specific types of streaming charts. Returns a list of timestamps indicating the relevant dates associated with the specified streaming type. - get_deezer_tracks_trend (/charts/deezer/tracks-trend): Retrieves trending track data from Deezer. Returns ranking information along with corresponding timestamps for the specified track. - get_genres (/charts/genres/{platform}): Retrieves genre data for charts on a specified platform. Returns a list of genres along with their unique identifiers. - get_itunes_albums_trend (/charts/itunes/albums-trend): Rank history of one album on the iTunes album chart for one country and genre: rank and date at each chart run. - get_itunes_tracks_trend (/charts/itunes/tracks-trend): Retrieves trending track data from the iTunes charts. Returns ranking information along with corresponding timestamps for the specified record. - get_itunes_videos_trend (/charts/itunes/videos-trend): Retrieves trending video chart data from the iTunes platform. Returns a list of rankings along with timestamps for the specified video over a given time period. - get_line_tracks_trend (/charts/line/tracks-trend): Retrieves trending track data from the Chartmetric platform. Returns a list of rankings along with corresponding timestamps for the specified track. - get_melon_tracks_trend (/charts/melon/tracks-trend): Retrieves trending track data for the Melon platform. Returns ranking positions and timestamps for a specific track over a specified time interval. - get_most_followed_on_chartmetric (/charts/cm): Chartmetric's own community chart: the artists, tracks or playlists most followed by Chartmetric users, each with its Chartmetric follower count — artists also carry Spotify followers, popularity and monthly listeners. - get_netease_tracks_trend (/charts/netease/tracks-trend): Retrieves trending track data from Netease, allowing users to access various chart types based on specified parameters. Returns a list of track rankings and related metadata for the selected chart type. - get_pandora_tracks_trend (/charts/pandora/tracks-trend): Retrieves trend data for tracks on Pandora. Returns a list of trending tracks along with their associated metadata. - get_qq_tracks_trend (/charts/qq/tracks-trend): Retrieves trending track data for the specified QQ charts. Returns rank information along with timestamps for the tracks over a defined period. - get_shazam_tracks_trend (/charts/shazam/tracks-trend): Retrieves trending track data from Shazam. Returns ranking information along with timestamps for the specified tracks over time. - get_soundcloud_tracks_trend (/charts/soundcloud/tracks-trend): Retrieves trending track data from SoundCloud. Returns ranking information along with timestamps for the specified tracks over a defined time range. - get_spotify_artists_trend (/charts/spotify/artists-trend): Rank history of one artist on a Chartmetric-built Spotify artist chart — monthly listeners, popularity, followers, playlist count or playlist reach — at daily, weekly or monthly cadence. - get_spotify_breaking_tracks (/charts/spotify/breaking-tracks): Tracks ranked by their weekly gain in Spotify playlist count: latest playlist count and total playlist reach, Spotify plays and popularity, each with weekly change and percent change, plus track name, ISRC, album, artists and genres. - get_spotify_breaking_unsigned_artists (/charts/spotify/breaking-artists): Unsigned artists — no current or prior major-label association — ranked by their weekly gain in Spotify playlist count: playlist count and total playlist reach with weekly change, Spotify popularity, followers and monthly listeners with weekly deltas, genres, track count, first and latest release, and Chartmetric rank and score. - get_spotify_fresh_finds_chart (/charts/spotify/freshfind): The weekly Spotify Fresh Finds chart: ranked tracks with the number of Fresh Finds playlists each appears on and the ids and names of those playlists, plus each track's total Spotify playlist count and metadata. - get_spotify_playlist_covers (/charts/spotify/playlist-covers): Retrieves Spotify playlist cover data for various artists. Returns detailed artist information including name, popularity, genre tags, and related statistics. - get_spotify_playlist_covers_label (/charts/spotify/playlist-covers/label/{labelSlug}): Retrieves playlist cover data for a specific music label on Spotify. Returns label information, artist statistics, and details about playlists associated with the label. - get_spotify_playlist_covers_playlists (/charts/spotify/playlist-covers/{cmArtist}/playlists): Retrieves playlist cover images for tracks by a specified artist on Spotify. Returns an array of playlist cover data associated with the artist. - get_spotify_tracks_trend (/charts/spotify/tracks-trend): Rank history of one track on a Spotify chart: for the official Viral 50 and Top 200 charts, rank plus stream count per date for one country at daily or weekly cadence; with official=false, rank per date on a Chartmetric-built chart of plays, popularity, playlist count or playlist reach. - get_tencent_tracks_trend (/charts/tencent/tracks-trend): Retrieves trend data for Tencent tracks. Returns a list of ranking information for the specified duration. - get_tiktok_sound_usage_rank_history (/charts/tiktok/tracks-trend): Rank history of one sound on TikTok: by default Chartmetric's post-count chart, returning rank and the number of TikTok videos created with that sound per date (daily, weekly or all-time); with official=true, rank and creation count on TikTok's own weekly country chart. - get_tiktok_sounds (/charts/tiktok/sounds): Retrieves trending sound data from TikTok, including ranking information and metadata for the most popular sounds currently being used on the platform. Returns details such as artist names, song titles, and associated URLs for audio and images. - get_tiktok_sounds_countries (/charts/tiktok/sounds/countries): Retrieves a list of countries associated with TikTok sounds. Returns an array of country codes representing the geographical availability of the sounds. - get_tiktok_sounds_dates (/charts/tiktok/sounds/dates): Retrieves the dates associated with trending sounds on TikTok. Returns a list of timestamps indicating when these sounds were popular. - get_tiktok_sounds_evolution (/charts/tiktok/sounds/evolution): Retrieves the evolution of sound trends on TikTok. Returns an array of objects representing the historical data and metrics related to popular sounds on the platform. - get_tiktok_sounds_videos (/charts/tiktok/sounds/videos): Retrieves video data associated with TikTok sounds. Returns a collection of videos along with their total count and the corresponding TikTok sound ID. - get_tiktok_sounds_weekly_chart_countries (/charts/tiktok/sounds/weekly-chart-countries): Retrieves the weekly chart data for TikTok sounds across multiple countries. Returns a list of countries along with the most recent date for which chart data is available. - get_tiktok_users (/charts/tiktok/users): Retrieves TikTok user chart data based on specified metrics. Returns a list of user rankings and associated metadata since a defined date, filtered by either likes or followers. - get_tiktok_users_trend (/charts/tiktok/users-trend): Rank history of one TikTok creator on the TikTok user charts by likes or followers (daily, weekly or all-time): rank plus the like or follower count at each date. - get_tiktok_videos_trend (/charts/tiktok/videos-trend): Rank history of one TikTok video on the TikTok trending-video chart: rank plus views, likes and comments at each date. - get_track_chart_rank_history (/charts/{streamingType}/{id}/track-stat): Chart rank history of one Chartmetric track (or album, via chartEntity) on one platform's chart over a day range: rank with chart date and timestamp at each point, filterable by chart type, duration, country, city and genre. - get_twitch_users_trend (/charts/twitch/users-trend): Rank history of one Twitch channel on the Twitch user charts by followers or viewer hours (daily, weekly or monthly): rank plus the follower or viewer-hour value at each date. - get_youtube_artists_trend (/charts/youtube/artists-trend): Rank history of one artist on the YouTube artist chart for one country: rank and total view count at each chart date. - get_youtube_shorts_chart_rank_history (/charts/youtube/shorts-trend): Rank history of one Shorts video on the daily or weekly YouTube Shorts chart for one country: rank and view count at each chart date. - get_youtube_tracks_trend (/charts/youtube/tracks-trend): Rank history of one track on the YouTube top-songs chart for one country: rank and view count at each chart date. - get_youtube_trending_chart_rank_history (/charts/youtube/trends-trend): Rank history of one video on YouTube's trending-videos chart for one country: rank and country at each chart date. This chart carries no view count. - get_youtube_videos_trend (/charts/youtube/videos-trend): Rank history of one music video on the YouTube top-videos chart for one country: rank and view count at each chart date.
query_citiesChartmetric cities data, one operation per API endpoint. Every operation below operates on cities. REQUIRED: operation (string) - pick one from the list below. Resolve a name to a Chartmetric id with search_chartmetric_id first, then pass it as id (if id is also present in params, the id argument wins). Query parameters go in params (a dict); any path placeholder other than {id} goes in params too (e.g. params={'streamingType': 'spotify'}). For the full parameter spec of one operation, call get_endpoint_details with its path template. Optional: user_question (string) - if this is the first tool call after a new user question, pass the exact user question here verbatim for observability; omit on subsequent calls within the same question. Optional: reasoning (string, 1-2 sentences) - briefly explain why you chose this tool. Operations: - get_artists_audience (/city/{id}/artists/audience): Retrieves audience information for artists in a specific city. Returns detailed metadata such as artist names, genres, images, and audience metrics including rankings and score changes. - get_artists_audience_spotlight (/city/{id}/artists/audience/spotlight): Retrieves audience spotlight information for artists in a specified city. Returns artist details including ID, name, rank, genres, image URL, and rank trends. - get_artists_by_platform (/city/{id}/artists/by/platform): Retrieves artist data for a specific city identified by the given ID on various platforms. Returns a dictionary structure containing relevant artist information and statistics. - get_artists_residing (/city/{id}/artists/residing): Retrieves a list of artists residing in a specified city. Returns metadata including artist names, genres, and target metrics related to their performance rankings. - get_artists_residing_spotlight (/city/{id}/artists/residing/spotlight): Retrieves a spotlight list of artists residing in a specific city identified by the provided ID. Returns metadata including artist names, ranks, genres, and image URLs. - get_artists_top (/city/{id}/artists/top): Retrieves the top artists for a specific city based on the provided city ID. Returns a list containing the ranking information of these artists. - get_artists_trending (/city/{id}/artists/trending/{interval}): Retrieves trending artist data for a specified city within a defined time interval. Returns a list of artists currently gaining popularity based on the selected timeframe. - get_batch_artist_counts (/city/batch/artist-counts): Retrieves the artist count for specified cities. Returns a mapping of city IDs to the corresponding artist counts. - get_cities_search (/city/citiesSearch/{code2}): Cities within one country matching a name query: Chartmetric city id, city name with its province, country name and ISO-2 code, population, GNP and latitude/longitude — exact name matches ranked by population first, then prefix matches. - get_city (/city/{id}): Retrieves detailed information about a specific city identified by its ID. Returns metadata including the city's name, country, population, description, and various counts of venues, artists, and stations. - get_event_artists (/city/{id}/eventArtists): Retrieves a list of event artists associated with a specific city identified by its ID. Returns a structured response confirming the data is a list. - get_event_time_graph (/city/{id}/eventTimeGraph): Retrieves event time graph data for a specified city. Returns a list of event times associated with that city. - get_events (/city/{id}/{status}/events): Retrieves event data for a specific city based on the provided ID and status. Returns a list of events categorized as either past or current for that city. - get_list (/city/list): Retrieves a list of cities along with their geographical and demographic information. Returns details such as city name, country, province, continent, population, and associated top genres and tracks. - get_list_stats (/city/list/stats): Retrieves statistical data for cities worldwide. Returns a total count of cities along with location-specific details, including latitude, longitude, and associated country information. - get_stations (/city/{id}/stations): Retrieves a list of music stations associated with a specific city. Returns a structured object indicating the presence of these stations within the city's dataset. - get_top_stats_artists (/city/{id}/{domain}/topStatsArtists): Retrieves top statistics for artists in a specified city on the chosen music domain platform. Returns a list of ranking information related to the artists based on the provided parameters. - get_top_stats_tracks (/city/{id}/{domain}/topStatsTracks): Retrieves top statistics for tracks in a specified city, filtered by domain such as YouTube, radio, or Shazam. Returns a list object containing relevant performance data for the specified criteria. - get_tours (/city/{id}/tours/{period}): Retrieves tour data for a specific city identified by its ID, allowing users to access details about tours for either the future or past. Returns a list of tours within the specified time period. - get_tracks_by_platform (/city/{id}/tracks/by/platform): Retrieves track data for a specific city identified by its ID on various platforms. Returns a structured dictionary with information related to the tracks available on those platforms.
query_countriesChartmetric countries data, one operation per API endpoint. Every operation below operates on countries. REQUIRED: operation (string) - pick one from the list below. These operations key on an ISO 3166-1 alpha-2 country code rather than a Chartmetric id: pass it in params as code2 (e.g. params={'code2': 'US'}). Query parameters go in params (a dict), and every path placeholder goes in params too. For the full parameter spec of one operation, call get_endpoint_details with its path template. Optional: user_question (string) - if this is the first tool call after a new user question, pass the exact user question here verbatim for observability; omit on subsequent calls within the same question. Optional: reasoning (string, 1-2 sentences) - briefly explain why you chose this tool. Operations: - get_ai_insights (/country/{code2}/aiInsights): Retrieves AI insights for a specific country using its two-letter code. Returns a summary of AI-generated insights related to music chart performance and trends in the specified country. - get_airplay_top_stations (/country/{code2}/airplay/topStations): Retrieves the top airplay radio stations for a specified country based on the provided 2-letter country code. Returns detailed information about each station, including metrics such as audience reach, genres, and social media statistics. - get_airplay_top_stations_tracks (/country/{code2}/airplay/topStations/{stationId}/tracks): Retrieves the top tracks of a specified radio station within a given country. Returns a structured response containing the track data and the total number of tracks available. - get_airplay_top_tracks (/country/{code2}/airplay/topTracks): Retrieves the top tracks currently being played in a specified country. Returns detailed metadata including track IDs, ISRC codes, track names, artist information, play counts, and associated artwork URLs. - get_airplay_top_tracks_stations (/country/{code2}/airplay/topTracks/{isrc}/stations): Retrieves radio station data broadcasting a specific track identified by its ISRC code within a given country. Returns a list of stations including their names, genres, total spins, and associated city information. - get_artists_by_code2_area_type_sub_area (/country/{code2}/artists/{area}/{type}/{subArea}): Retrieves artist data for a specified country and area type. Returns a list of artists along with relevant metrics based on the selected criteria. - get_artists_by_code2_platform (/country/{code2}/artists/{platform}): Retrieves a list of artists from a specified country identified by `code2` on the given `platform`. Returns a structured response containing artist data relevant to the specified platform. - get_charts (/country/{code2}/charts): Retrieves available chart data for a specific country based on the provided country code. Returns a list of platforms where charts are accessible for that country. - get_country (/country/{code2}): Retrieves country-specific data from the Chartmetric API. Returns a structured JSON object containing relevant information for the specified country code. - get_genres (/country/genres): Retrieves genre information for countries from the Chartmetric API. Returns a list indicating the available genres for various countries. - get_genres_by_code2 (/country/{code2}/genres): Retrieves genre information for a specified country using its two-letter code. Returns a structured list of genre data associated with the country. - get_import_export_ratios (/country/{code2}/import-export-ratios): Retrieves import-export ratios for countries identified by their 2-letter code. Returns a ranked list of countries along with their respective import-export ratio values. - get_list (/country/list): Retrieves a list of countries available in the Chartmetric database. Returns a structured response indicating the object type as "list". - get_stations (/country/{code2}/stations): Retrieves a list of radio stations for a specified country. Returns a collection of station objects relevant to the provided country code. - get_top_cities (/country/{code2}/top-cities): Retrieves the top cities for a specified country using its two-letter country code. Returns a list of cities relevant to the music chart metrics for that country. - get_tours (/country/{code2}/tours/{status}): Retrieves tour data for a specific country based on the tour status. Returns a list of tours categorized as either future or past events. - get_tours_genres (/country/{code2}/tours/{status}/genres): Retrieves genre data for tours in a specified country based on their status (future or past). Returns a list of genres along with their respective counts of associated tours. - get_tracks (/country/{code2}/tracks/{platform}): Retrieves track data for a specified country and platform. Returns a list of tracks and their associated metadata.
query_creatorsChartmetric creators data, one operation per API endpoint. Every operation below operates on creators. REQUIRED: operation (string) - pick one from the list below. Query parameters go in params (a dict), and every path placeholder goes in params too. For the full parameter spec of one operation, call get_endpoint_details with its path template. Optional: user_question (string) - if this is the first tool call after a new user question, pass the exact user question here verbatim for observability; omit on subsequent calls within the same question. Optional: reasoning (string, 1-2 sentences) - briefly explain why you chose this tool. Operations: - get_list (/creator/list): Retrieves a list of creators from the Chartmetric database. Returns the total number of creators alongside the detailed list of creator data. - get_list_featured_videos (/creator/list/featured-videos): Returns TikTok videos that connect an influencer to selected featured artist or track IDs on the Influencers page. - get_list_stats (/creator/list/stats): Retrieves statistics related to creators, including filters for geographic codes, languages, audience demographics, and YouTube categories. Returns a structured dataset containing various categories and classifications relevant to content creators. - get_list_top_contents (/creator/list/top-contents): Retrieves a list of top contents created by users. Returns a mapping of content identifiers to associated data, providing insights into the most popular items.
query_curatorsChartmetric curators data, one operation per API endpoint. Every operation below operates on curators. REQUIRED: operation (string) - pick one from the list below. Resolve a name to a Chartmetric id with search_chartmetric_id first, then pass it as id (if id is also present in params, the id argument wins). Query parameters go in params (a dict); any path placeholder other than {id} goes in params too (e.g. params={'streamingType': 'spotify'}). For the full parameter spec of one operation, call get_endpoint_details with its path template. Optional: user_question (string) - if this is the first tool call after a new user question, pass the exact user question here verbatim for observability; omit on subsequent calls within the same question. Optional: reasoning (string, 1-2 sentences) - briefly explain why you chose this tool. Operations: - get_amazon_list (/curator/amazon/list): Retrieves a list of curators associated with Amazon Music. Returns details about each curator, including their tags, owner information, and the total number of playlists managed. - get_curator (/curator/{streamingType}/{id}): Profile and reach for one curator on one streaming platform: name, image, description, country and genre tags, plus Spotify playlist count, curator followers, largest playlist followers and total playlist reach; Apple Music, Deezer, Amazon and YouTube playlist counts; YouTube channel views and subscribers; SoundCloud plays, likes and reposts; and the curator's own social counts. - get_deezer_list (/curator/deezer/list): Retrieves information about Deezer curators, returning data related to their playlists, including owner details, tags, and total reach metrics. - get_itunes_list (/curator/itunes/list): Retrieves a list of curators associated with iTunes, returning details such as owner information, genres, tags, and the number of playlists curated by each owner. - get_label_groups_trend (/curator/{streamingType}/{id}/label-groups/trend): Retrieves trend data for label groups associated with a specified streaming type and ID. Returns structured information about the label group's performance metrics and trends over time. - get_labels (/curator/{streamingType}/{id}/labels): Retrieves label information for a specified content type from various streaming platforms. Returns a dictionary object containing the relevant label data associated with the provided identifier. - get_list_stats (/curator/{streamingType}/list/stats): Retrieves statistics for curators based on the specified streaming type. Returns a structured dictionary containing relevant data associated with the selected streaming service. - get_playlists (/curator/{streamingType}/{id}/playlists): Retrieves playlists associated with a specific streaming type and identifier. Returns a structured object containing playlist information for the requested streaming service. - get_preferred_artists (/curator/{streamingType}/{id}/preferredArtists): Retrieves the preferred artists for a specific streaming type identified by the given ID. Returns a list of artist data tailored to the selected streaming service. - get_recent_playlist_adds_and_removes (/curator/{streamingType}/{id}/latestActivities): Recent playlisting activity for one curator on one streaming platform: per playlist and per day, whether tracks were added or removed and how many, the playlist's id, name and artwork, and on Spotify that playlist's follower count and monthly follower change — up to 7 days back. - get_related_curators (/curator/{streamingType}/{id}/relatedCurators): Retrieves related curators based on the specified streaming type and curator ID. Returns a list of curators related to the given input, facilitating insights into connected entities within the streaming ecosystem. - get_spotify_list (/curator/spotify/list): Retrieves a list of Spotify curators along with their associated metadata. Returns information including curator details, tags, ownership, and social media links. - get_tags (/curator/{streamingType}/{id}/tags): Retrieves tagging information for a specified streaming service type and identifier. Returns a list of associated tags relevant to the queried content. - get_updating_freq (/curator/{streamingType}/{id}/updatingFreq): Retrieves updating frequency data for a specific streaming type and ID, indicating the daily count of tracks that were either added or removed. Returns an array of counts grouped by day of the week. - get_youtube_list (/curator/youtube/list): Retrieves a list of YouTube channels curated by Chartmetric. Returns metadata, including channel statistics and associated tags for each channel.
query_festivalsChartmetric festivals data, one operation per API endpoint. Every operation below operates on festivals. REQUIRED: operation (string) - pick one from the list below. Resolve a name to a Chartmetric id with search_chartmetric_id first, then pass it as id (if id is also present in params, the id argument wins). Query parameters go in params (a dict); any path placeholder other than {id} goes in params too (e.g. params={'streamingType': 'spotify'}). For the full parameter spec of one operation, call get_endpoint_details with its path template. Optional: user_question (string) - if this is the first tool call after a new user question, pass the exact user question here verbatim for observability; omit on subsequent calls within the same question. Optional: reasoning (string, 1-2 sentences) - briefly explain why you chose this tool. Operations: - get_countries (/festival/countries): Retrieves a list of countries where festivals are held. Returns an array of country codes representing the locations of these festivals. - get_events_artists (/festival/events/artists): Retrieves artist information associated with specified festival events. Returns a structured object containing details related to the artists participating in the requested events. - get_festival (/festival): Retrieves festival data from the Chartmetric API. Returns information about various festivals, including their ranking, genres, artists, and event details. - get_festival_by_id (/festival/{id}): Retrieves festival information based on the specified festival ID. Returns a dictionary containing details about the festival. - get_genres (/festival/genres): Retrieves genre information related to festivals. Returns a list of genres along with the corresponding artist count for each genre. - get_neighbors (/festival/{id}/neighbors): Retrieves neighboring festival data for a specified festival ID. Returns a structured object containing relevant information about neighboring festivals. - get_top (/festival/top): Retrieves the top festivals data from the Chartmetric API. Returns a list object containing detailed information about the top festivals.
query_genresChartmetric genres data, one operation per API endpoint. Every operation below operates on genres. REQUIRED: operation (string) - pick one from the list below. Resolve a name to a Chartmetric id with search_chartmetric_id first, then pass it as id (if id is also present in params, the id argument wins). Query parameters go in params (a dict); any path placeholder other than {id} goes in params too (e.g. params={'streamingType': 'spotify'}). For the full parameter spec of one operation, call get_endpoint_details with its path template. Optional: user_question (string) - if this is the first tool call after a new user question, pass the exact user question here verbatim for observability; omit on subsequent calls within the same question. Optional: reasoning (string, 1-2 sentences) - briefly explain why you chose this tool. Operations: - get_artists (/genre/{id}/artists): Retrieves a list of artists associated with a specific genre identified by the provided ID. Returns a structured dictionary containing artist data and related information. - get_countries (/genre/{id}/countries): Retrieves country-specific genre data based on the provided genre ID. Returns a dictionary containing relevant information related to the specified genre in various countries. - get_events (/genre/{id}/events): Retrieves event data for a specified genre from the Chartmetric API. Returns a list of events categorized as either top or upcoming for the selected time period. - get_events_stats (/genre/{id}/events/stats): Retrieves event statistics for a specific genre by its ID. Returns aggregated data on either top or upcoming events based on the specified time period. - get_explanations (/genre/{entity}/{id}/explanations): Retrieves genre explanations for a specified entity and ID from the Chartmetric API. Returns detailed metadata about the genre, including co-occurring artists and their associated metrics. - get_festivals (/genre/{id}/festivals): Retrieves festival data for a specific genre identified by the given ID. Returns a list of festivals categorized as either 'top' or 'upcoming' events. - get_festivals_stats (/genre/{id}/festivals/stats): Retrieves festival statistics for a specified genre ID. Returns a dictionary containing statistical data related to festivals associated with that genre. - get_genre (/genre): Retrieves a list of music genres from the Chartmetric database. Returns an array of genre objects, each containing an ID and the genre name. - get_genre_by_id (/genre/{id}): Retrieves genre information by ID from the Chartmetric API. Returns metadata including the genre's name, type, and counts of related events, tracks, venues, artists, and playlists across different platforms. - get_list (/genre/list): Retrieves a list of music genres and their associated metadata. Returns details such as genre IDs, names, top artists, track counts, artist counts, playlist counts, and related genres. - get_main (/genre/main): Retrieves a list of main music genres available in the Chartmetric database. Returns an array of genre objects, each containing an ID, name, type, and source information. - get_playlists (/genre/{id}/playlists/{platform}/{algorithm}): Retrieves playlist data for a specific genre on the given platform using the specified algorithm. Returns a list of playlists associated with the genre and platform. - get_playlists_deezer (/genre/{id}/playlists/deezer): Retrieves a list of playlists from Deezer for the specified genre ID. Returns the total number of playlists along with pagination information. - get_playlists_spotify (/genre/{id}/playlists/spotify): Retrieves playlists for a specific genre from the Spotify platform. Returns pagination details and the total number of playlists available for the given genre ID. - get_playlists_youtube (/genre/{id}/playlists/youtube): Retrieves YouTube playlists associated with a specific genre identified by the given ID. Returns a list of playlists along with the total count and pagination information. - get_related (/genre/{id}/related): Retrieves related genres based on the specified genre ID. Returns a list of related genre data in JSON format. - get_relatives (/genre/{id}/relatives): Retrieves relative genre data based on the specified genre ID. Returns a dictionary containing related genres and their associated information. - get_stations (/genre/{id}/stations): Retrieves a list of stations associated with a specific genre identified by the provided ID. Returns a structured response indicating the presence of the requested data. - get_stations_stats (/genre/{id}/stations/stats): Retrieves statistical data for stations associated with a specific genre ID. Returns the total count of stations in the response. - get_tone_and_energy_dimensions (/genre/tags/dimensions): Tone and energy scores for one or more Chartmetric genre or mood tag ids: one row per tag with its numeric tone and energy value. - get_touring_artists (/genre/{id}/touring-artists/{status}): Retrieves touring artist information for a specific genre based on their performance status. Returns a list of artists categorized as either past or future touring acts within the specified genre. - get_tracks (/genre/{id}/tracks): Retrieves a list of tracks associated with a specific genre identified by its ID. Returns pagination information along with the total number of tracks available for that genre. - get_tracks_stats (/genre/{id}/tracks/stats): Retrieves statistical data for tracks associated with a specific genre identifier. Returns a dictionary containing relevant track statistics for the specified genre. - get_venues (/genre/{id}/venues): Retrieves venue data for a specified genre ID over a defined time period. Returns a list of venues associated with the genre based on the selected timeframe. - get_venues_stats (/genre/{id}/venues/stats): Retrieves venue statistics for a specific genre identified by the given ID. Returns the total count of venues over the specified period.
query_labelsChartmetric labels data, one operation per API endpoint. Every operation below operates on labels. REQUIRED: operation (string) - pick one from the list below. Resolve a name to a Chartmetric id with search_chartmetric_id first, then pass it as id (if id is also present in params, the id argument wins). Query parameters go in params (a dict); any path placeholder other than {id} goes in params too (e.g. params={'streamingType': 'spotify'}). For the full parameter spec of one operation, call get_endpoint_details with its path template. Optional: user_question (string) - if this is the first tool call after a new user question, pass the exact user question here verbatim for observability; omit on subsequent calls within the same question. Optional: reasoning (string, 1-2 sentences) - briefly explain why you chose this tool. Operations: - get_artists (/label/{id}/artists): Artists signed to a record label, paginated and sortable: the standard Chartmetric artist record plus a label timeline giving the signing start and end dates, a confidence score, and the evidence sources tying the artist to the label. Requires type: active (currently signed) or all. - get_label (/label/{id}): Profile for a record label: name, logo, street address, website and social URLs, headquarters city and country, its current and all-time artist and track counts, and how many parent labels, sub-labels and similarly named labels it has. - get_list (/label/list): Retrieves a list of music labels along with their associated top tracks and artists. Returns detailed information including label names, images, and counts of active tracks and artists. - get_parent_and_sub_labels (/label/{id}/related-labels): A label's place in its corporate structure: the parent labels above it and the sub-labels and imprints beneath it, by id and name, ordered from nearest outward. - get_search (/label/search): Retrieves information about music labels from the Chartmetric database. Returns a structured data object containing relevant label details. - get_similarly_named_labels (/label/{id}/similar-labels): Labels whose names closely resemble a given label's — spelling variants and near-duplicate entries — with the id, name and kind of name match for each. Name similarity, not corporate or musical relatedness. - get_tracks (/label/{id}/tracks): Tracks released on a record label, paginated and sortable: the standard Chartmetric track record plus a label timeline giving the release start and end dates, a confidence score, and the evidence sources tying the track to the label. Requires type: active or all.
query_locationsChartmetric locations data, one operation per API endpoint. Every operation below operates on locations. REQUIRED: operation (string) - pick one from the list below. Resolve a name to a Chartmetric id with search_chartmetric_id first, then pass it as id (if id is also present in params, the id argument wins). Query parameters go in params (a dict); any path placeholder other than {id} goes in params too (e.g. params={'streamingType': 'spotify'}). For the full parameter spec of one operation, call get_endpoint_details with its path template. Optional: user_question (string) - if this is the first tool call after a new user question, pass the exact user question here verbatim for observability; omit on subsequent calls within the same question. Optional: reasoning (string, 1-2 sentences) - briefly explain why you chose this tool. Operations: - get_list (/location/list): Retrieves a list of locations, including countries and their associated demographics. Returns data such as population, top music genres, and the number of artists in each location. - get_location (/location/{id}): Retrieves location data for a specific city by its ID. Returns detailed information including the city's name, population, region, and country. - get_recommended_artists (/location/{id}/artists/recommendation/{recommendationType}): A short randomized sample of notable artists for a city or country — up to five — each with Chartmetric id, name, image, audio preview, country code, top genre, top mood, gender and band flag. recommendationType=region picks artists from the place; audience picks artists whose listeners rank highly there. - get_top_radio_stations (/location/{id}/stations): Top radio stations in a city or country by local rank: station id, name, image, average quarter-hour audience (AQH), total spins, Facebook likes and followers, Twitter followers, Wikipedia pageviews, and the station's three most-played genres over the last 7 days.
query_moodsChartmetric moods data, one operation per API endpoint. Every operation below operates on moods. REQUIRED: operation (string) - pick one from the list below. Resolve a name to a Chartmetric id with search_chartmetric_id first, then pass it as id (if id is also present in params, the id argument wins). Query parameters go in params (a dict); any path placeholder other than {id} goes in params too (e.g. params={'streamingType': 'spotify'}). For the full parameter spec of one operation, call get_endpoint_details with its path template. Optional: user_question (string) - if this is the first tool call after a new user question, pass the exact user question here verbatim for observability; omit on subsequent calls within the same question. Optional: reasoning (string, 1-2 sentences) - briefly explain why you chose this tool. Operations: - get_explanations (/moods/{entity}/{id}/explanations): Why an entity carries the moods it does — up to 20 moods keyed by mood id, each with its name and description, the top Spotify playlists and top YouTube comments that evidence it (with artwork), and, for artists only, that artist's top three tracks for the mood with each track's Chartmetric score and rank. Pass entity as the literal cm_track or cm_artist; track and artist are rejected. - get_list (/moods/list): Retrieves a list of moods and activities available in the Chartmetric database. Returns an array of objects containing the ID, name, and type of each mood or activity.
query_playlistsChartmetric playlists data, one operation per API endpoint. Every operation below operates on playlists. REQUIRED: operation (string) - pick one from the list below. Resolve a name to a Chartmetric id with search_chartmetric_id first, then pass it as id (if id is also present in params, the id argument wins). Query parameters go in params (a dict); any path placeholder other than {id} goes in params too (e.g. params={'streamingType': 'spotify'}). For the full parameter spec of one operation, call get_endpoint_details with its path template. Optional: user_question (string) - if this is the first tool call after a new user question, pass the exact user question here verbatim for observability; omit on subsequent calls within the same question. Optional: reasoning (string, 1-2 sentences) - briefly explain why you chose this tool. Operations: - get_amazon_list (/playlist/amazon/list): Retrieves a list of playlists curated by Amazon. Returns metadata including the total number of playlists available and pagination information. - get_artist_country (/playlist/{streamingType}/artist/{id}/country): Retrieves country-specific playlist data for a specified artist on a particular streaming platform. Returns metadata associated with the artist's presence in the country's playlists. - get_artist_curators (/playlist/{streamingType}/artist/{id}/curators): Retrieves a list of curators associated with a specific artist on the specified streaming platform. Returns the curator's count, owner ID, and owner name for each curator. - get_by_playlists_at_date (/playlist/by/{byType}/{id}/{streamingType}/playlistsAtDate): Playlists that added or removed a given artist, track or album on one date, returned as separate added and removed lists. - get_countries (/playlist/{streamingType}/{id}/countries): Retrieves country-specific chart data for playlists on the specified streaming platform. Returns a list of countries where the playlist is ranked. - get_deezer_list (/playlist/deezer/list): Retrieves a list of Deezer playlists from Chartmetric's database. Returns metadata including the total count of playlists and the current offset for pagination. - get_genres (/playlist/{streamingType}/{id}/genres): Retrieves genre information for a specific playlist based on the streaming type and ID. Returns detailed metadata including track details, associated album information, and mood classifications. - get_itunes_list (/playlist/itunes/list): Retrieves a list of iTunes playlists. Returns a structured response containing the total number of playlists and pagination offset information. - get_journey_progress (/playlist/{platform}/{id}/{type}/journeyProgress): Retrieves the journey progress data for a specific playlist on the specified platform. Returns detailed information about the playlist events and associated tracks, including artist statistics and network strength. - get_labels (/playlist/{streamingType}/{id}/labels): Retrieves label data for a specified playlist from the selected streaming platform. Returns a dictionary containing details related to the playlist's labels. - get_legacy_labels (/playlist/{streamingType}/{id}/legacy-labels): Retrieves legacy label information for a specified playlist based on the streaming type and ID. Returns a list of labels associated with the playlist, including count, label name, associated tracks, and label group. - get_list_stats (/playlist/{streamingType}/list/stats): Retrieves statistics for playlists across various streaming platforms. Returns data encapsulated in a dictionary format related to the performance metrics of the specified streaming type. - get_moods (/playlist/{streamingType}/{id}/moods): Mood and activity tags derived from a playlist's current tracks, with the number of tracks read. - get_new_music_friday (/playlist/newMusicFriday): Retrieves the latest music releases featured in the "New Music Friday" playlist. Returns a list object containing details about the newly added tracks. - get_numtracks (/playlist/{streamingType}/{id}/numtracks): Retrieves the number of tracks in a specified playlist for a given streaming platform. Returns a list of objects containing the playlist ID, timestamp, and the corresponding number of tracks. - get_playlist (/playlist/{streamingType}/{id}): Retrieves detailed playlist information for a specified streaming service. Returns metadata including playlist name, genres, moods, and user engagement metrics. - get_playlist_audience_demographics (/playlist/{platform}/{id}/audience): Demographics of a playlist's followers: age groups, gender split and top countries. - get_playlist_audience_top_cities (/playlist/{streamingType}/{id}/aggregateCities): Top cities for a playlist's listeners. - get_playlist_evolution (/playlist/by/{byType}/{id}/playlistEvolution): How an artist's, track's or album's playlist footprint changed over a time window. - get_playlist_evolution_by_metric (/playlist/by/{byType}/{id}/playlistEvolution/{metric}): One metric of an artist's, track's or album's playlist-footprint evolution over time. - get_playlists_containing_entity (/playlist/{streamingType}/by/{byType}/{status}): Playlists that currently contain, or previously contained, a given artist, track or album on one streaming platform. - get_recommendation_by (/playlist/recommendation/{streamingType}/by/{byType}/{status}): Playlists recommended for pitching an artist and its related artists, filterable by playlist type (editorial, personalized, chart, radio, brand, major-curator, indie, …). - get_recommendation_by_playlist (/playlist/{streamingType}/recommendation/byPlaylist/{id}): Retrieves playlist recommendations based on a specified streaming type and playlist ID. Returns a list of recommended playlists along with their associated mood tags and metadata. - get_snapshot (/playlist/{id}/{streamingType}/snapshot): Retrieves a snapshot of playlist data for a specific streaming type using the provided playlist ID. Returns an array of objects containing relevant data related to the playlist's performance and contents. - get_snapshot_dates (/playlist/{id}/{streamingType}/snapshot/dates): Retrieves snapshot date information for a specific playlist on the selected streaming platform. Returns a list object with the relevant data reflecting the playlist's performance over time. - get_social_urls (/playlist/{streamingType}/{id}/socialUrls): Retrieves social media URLs for a specific playlist on the specified streaming platform. Returns the metadata and verification status for the playlist across various social channels. - get_soundcloud_list (/playlist/soundcloud/list): Retrieves a list of SoundCloud playlists from the Chartmetric API. Returns metadata including the total number of playlists and an offset for pagination. - get_spotify_artist_top_tracks (/playlist/spotify/artist/{id}/{status}/top-tracks): Retrieves the top tracks for a specific artist on Spotify based on their current status. Returns a list of track objects containing relevant details about the artist's most popular songs. - get_spotify_discovered_on (/playlist/spotify-discovered-on/{entity}/{id}): Retrieves Spotify discovered playlists or artist information based on the provided entity and ID. Returns a list object containing relevant data associated with the specified entity. - get_spotify_list (/playlist/spotify/list): Retrieves a list of Spotify playlists available through the Chartmetric API. Returns a total count of playlists and pagination details for navigating the list. - get_top_genres (/playlist/{streamingType}/{id}/topGenres): Retrieves the top genres for a specified playlist from a chosen streaming service. Returns details about the playlist, including its ID, name, and a list of associated genres. - get_track_comparison (/playlist/{streamingType}/track-comparison): Retrieves a comparison of two tracks on the specified streaming platform. Returns a list containing relevant data for the track comparison analysis. - get_track_country (/playlist/{streamingType}/track/{id}/country): Retrieves country-specific playlist data for a track on a specified streaming platform. Returns an array of country codes associated with the track's performance. - get_track_stats (/playlist/{streamingType}/trackStats): Retrieves statistical data for tracks on a specified streaming platform. Returns an array of track statistics relevant to the given parameters. - get_tracks (/playlist/{streamingType}/{id}/{status}/tracks): Retrieves track data for a specified playlist on a given streaming platform. Returns detailed metadata and ranking information for the tracks, including album details and performance metrics. - get_updated (/playlist/{streamingType}/{id}/updated): Retrieves the last updated timestamps for a specific playlist on a given streaming platform. Returns the system and playlist last updated timestamps in ISO 8601 format. - get_updating_freq (/playlist/{streamingType}/{id}/updatingFreq): Retrieves the updating frequency of tracks in a playlist for the specified streaming platform. Returns a count of tracks added or removed for each day of the week. - get_updating_freq_tracks (/playlist/{streamingType}/{id}/updatingFreq/tracks): Tracks a playlist added or removed on a given day of the week — the detail behind its updating-frequency breakdown. - get_updating_pattern (/playlist/{streamingType}/{id}/updatingPattern): Retrieves the updating pattern for a specific playlist on the specified streaming platform. Returns the number of days and survival rates associated with the playlist over time. - get_updating_pattern_tracks (/playlist/{streamingType}/{id}/updatingPattern/tracks): Tracks a playlist added or removed within a recency bucket: last week, last month, last half-year, or older. - get_youtube_list (/playlist/youtube/list): Retrieves a list of YouTube playlists from the Chartmetric API. Returns a summary object containing the total number of playlists and an offset for pagination.
query_radioChartmetric radio data, one operation per API endpoint. Every operation below operates on radio. REQUIRED: operation (string) - pick one from the list below. Resolve a name to a Chartmetric id with search_chartmetric_id first, then pass it as id (if id is also present in params, the id argument wins). Query parameters go in params (a dict); any path placeholder other than {id} goes in params too (e.g. params={'streamingType': 'spotify'}). For the full parameter spec of one operation, call get_endpoint_details with its path template. Optional: user_question (string) - if this is the first tool call after a new user question, pass the exact user question here verbatim for observability; omit on subsequent calls within the same question. Optional: reasoning (string, 1-2 sentences) - briefly explain why you chose this tool. Operations: - get_all_countries (/radio/{id}/{type}/allCountries): Retrieves radio chart data for a specified artist, track, or album from various countries. Returns a list of countries with their respective names and two-letter country codes. - get_all_stations (/radio/{id}/{type}/allStations): The terrestrial (FM/AM) radio stations that played a given Chartmetric artist, track or album in the lookback window — station id and name plus the station's country code and city id, the station filter list for the other terrestrial operations. The SiriusXM twin returns channel id and name only, with no country or city. - get_all_tracks (/radio/{id}/{type}/allTracks): The tracks of a given Chartmetric artist, track or album that received terrestrial (FM/AM) radio airplay in the lookback window — track name, Chartmetric track id and ISRC ordered by play count, the track filter list for the other terrestrial operations. - get_dates (/radio/{id}/dates): The dates on which one terrestrial (FM/AM) radio station aired music, newest first. Here {id} is the numeric station id from get_station_list, not a Chartmetric artist or track id. - get_overtime_plays (/radio/{id}/{type}/overtime-plays): Daily and cumulative terrestrial (FM/AM) radio spin counts over time for a Chartmetric artist, track or album, as separate cumulative and daily arrays of date plus plays, optionally narrowed to one station, one country (code2) or one track. - get_radio_airplay_spins (/radio/{id}/{type}/radio): Play-by-play terrestrial (FM/AM) radio airplay log for one Chartmetric artist, track or album: every detected spin with air date, UTC and station-local air time, played duration, station name and id, station city, market and country, station genre, AQH audience, and the track id/ISRC. - get_radio_city_trend (/radio/{id}/{type}/radioCityTrend): Daily terrestrial radio play counts in one city for an artist, track or album: air date plus spin count over the requested lookback, for the single city given by cityId. - get_radio_market (/radio/{id}/{type}/radioMarket): Retrieves radio market data for a specific artist, track, or album identified by the provided ID and type. Returns a structured object containing relevant market information based on the specified number of days ago. - get_radio_metadata (/radio/{id}/{type}/radioMetadata): Terrestrial (FM/AM) radio airplay headline numbers for a Chartmetric artist, track or album over a lookback window: total plays plus the count of distinct countries, cities and stations that played it, each with its absolute and percentage change against the preceding window, and for type=artist the artist's global airplay rank and its movement. Filterable by station or country (code2). The SiriusXM twin has no country, city or rank figures. - get_radio_pies (/radio/{id}/{type}/radioPies): The terrestrial (FM/AM) airplay breakdown for a Chartmetric artist, track or album in four slices — by country, by city, by station and by track — each entry pairing its counts (plays, share of total, distinct stations, top station, total market plays; city rows add country and latitude/longitude) with its own daily air-date play trend. The SiriusXM twin has channels and tracks only — satellite radio carries no geography. - get_radio_summary_stats (/radio/{id}/{type}/radioSummaryStats): Per-track terrestrial (FM/AM) airplay summary for a Chartmetric artist, track or album: track name, Chartmetric track id and ISRC with spins in the lookback window, this week versus last week, first and last played dates, and all-time total spins across stations. Narrowable to one station or one country (code2). - get_radio_target_counts (/radio/{id}/{type}/radioTargetCounts): All four terrestrial (FM/AM) airplay rankings for a Chartmetric artist, track or album in one payload — top countries, top cities (with latitude/longitude), top stations and top tracks — each row carrying plays, share of total plays, distinct station count and top station. Filterable by station, track or country (code2). The SiriusXM twin covers channels and tracks only. - get_radio_target_counts_section (/radio/{id}/{type}/radioTargetCountsSection): One paginated slice of those terrestrial (FM/AM) airplay rankings: section accepts countries, cities, stations or tracks, returning that section's rows with their plays and share of total plus a row count, with server-side sorting and free-text search over the section's names. The SiriusXM twin accepts stations and tracks only. - get_real_time_streams (/radio/{id}/{type}/realTimeStreams): Retrieves real-time streaming data for a specific radio station based on the provided ID and type. Returns detailed information about currently playing tracks, including metadata such as broadcast details and local air time. - get_sirius_all_stations (/sirius/{id}/{type}/allStations): The SiriusXM satellite-radio channels that played a given artist, track or album in the lookback window — channel id and name only, the station filter list for the other SiriusXM operations. - get_sirius_all_tracks (/sirius/{id}/{type}/allTracks): The tracks of a given artist, album or track that aired on SiriusXM satellite radio in the lookback window — track name, Chartmetric track id and ISRC, the track filter list for the other SiriusXM operations. - get_sirius_dates (/sirius/{id}/dates): The dates on which one SiriusXM satellite-radio channel aired music, newest first. Here {id} is the SiriusXM channel id (a string) from get_sirius_station_list, not a Chartmetric entity id. - get_sirius_overtime_plays (/sirius/{id}/{type}/overtime-plays): Daily and cumulative SiriusXM satellite-radio spin counts over time for an artist, track or album, as separate cumulative and daily arrays of date plus plays, optionally narrowed to one SiriusXM channel or one track. - get_sirius_radio_metadata (/sirius/{id}/{type}/radioMetadata): SiriusXM satellite-radio play totals for a Chartmetric artist, track or album: total plays and the number of SiriusXM channels that played it over the lookback window, each with its change against the preceding window. Here {id} is a Chartmetric entity id and {type} selects artist, track or album. No country, city or airplay-rank figures — the terrestrial twin has those. - get_sirius_radio_pies (/sirius/{id}/{type}/radioPies): Per-channel and per-track daily SiriusXM spin trends for an artist, track or album: each top SiriusXM channel and each top track with its own date and count series. The tracks list is empty when type is track. - get_sirius_radio_summary_stats (/sirius/{id}/{type}/radioSummaryStats): Per-track SiriusXM satellite-radio summary for an artist, track or album: track name, Chartmetric track id and ISRC with plays in the lookback window, this week versus last week, first and last played dates, and all-time total plays across SiriusXM channels. - get_sirius_radio_target_counts (/sirius/{id}/{type}/radioTargetCounts): Top SiriusXM satellite-radio channels and top tracks by spins for an artist, track or album: each channel with id, name, plays and share of total SiriusXM plays, and each track with plays, channel count, top channel and share. - get_sirius_radio_target_counts_section (/sirius/{id}/{type}/radioTargetCountsSection): One paginated, sortable and searchable slice of the SiriusXM breakdown: section accepts stations or tracks, returning rows carrying plays and share of total plus a row count. The terrestrial twin also accepts cities and countries. - get_sirius_satellite_radio_spins (/sirius/{id}/{type}/radio): Play-by-play SiriusXM satellite-radio spin log for one artist, track or album: air date, UTC and local air time, played duration, SiriusXM channel name and id, and the track id/ISRC. No city, market, country or AQH fields — SiriusXM is national satellite rather than terrestrial stations. - get_sirius_station_info (/sirius/{id}/station-info): Profile for one SiriusXM satellite-radio channel by its channel id: name, streaming name, channel number, categories, genre, artwork, description and the channel's own URLs, plus its Facebook, Twitter, Instagram, YouTube, SoundCloud and TikTok follower counts and Wikipedia pageviews. Satellite radio carries no market, city or AQH figures. - get_sirius_station_list (/sirius/station-list): Retrieves a list of Sirius XM radio stations. Returns details such as station ID, URL, name, genre, artwork, and social media follower counts for each station. - get_sirius_top_artists (/sirius/{id}/top-artists): Artists most played on one SiriusXM satellite-radio channel: spin counts all-time and over the last 7, 30 and 90 days, with each artist's Chartmetric metadata and latest release. Here {id} is the SiriusXM channel id; sort with sortCol (count_all, count_7, count_30, count_90). - get_sirius_top_tracks (/sirius/{id}/top-tracks): Tracks most played on one SiriusXM satellite-radio channel: spin counts all-time and over the last 7, 30 and 90 days, with each track's Chartmetric metadata and Chartmetric score. Here {id} is the SiriusXM channel id. - get_sirius_tracks (/sirius/{id}/{date}/tracks): Every track one SiriusXM satellite-radio channel aired on a given date: Chartmetric track id, UTC air time, formatted air time and played duration, with the track's Chartmetric metadata. Here {id} is the SiriusXM channel id. - get_station_info (/radio/{id}/stationInfo): Profile for one terrestrial (FM/AM) radio station by its numeric station id: name, genre, market, city, state, country, broadcast area, slogan, frequency, HAAT, class, platform, image and average quarter-hour audience (AQH), plus the station's URLs, its Facebook likes and followers, Instagram and Twitter followers, and Wikipedia pageviews. - get_station_list (/radio/stationList): Every terrestrial (FM/AM) radio station Chartmetric tracks, ranked by average quarter-hour audience (AQH): station id, name, genre, frequency, market, broadcast area, country, state, image, AQH and platform, plus Facebook likes and followers, Instagram and Twitter followers and Wikipedia pageviews. Filter by country with code2s. SiriusXM channels are excluded — use get_sirius_station_list for those. - get_top_artists (/radio/{id}/topArtists): Artists most played on one terrestrial (FM/AM) radio station: spin counts all-time and over the last 7, 30 and 90 days, with each artist's Chartmetric metadata. Here {id} is the station id; sort with sortCol (count_all, count_7, count_30, count_90). - get_top_tracks (/radio/{id}/topTracks): Tracks most played on one terrestrial (FM/AM) radio station: spin counts all-time and over the last 7, 30 and 90 days, with each track's Chartmetric metadata. Here {id} is the station id. - get_tracks (/radio/{id}/{date}/tracks): Every track one terrestrial (FM/AM) radio station aired on a given date: Chartmetric track id, UTC air time, station-local air time and played duration, with the track's Chartmetric metadata. Here {id} is the station id.
query_snsChartmetric sns data, one operation per API endpoint. Every operation below operates on sns. REQUIRED: operation (string) - pick one from the list below. Resolve a name to a Chartmetric id with search_chartmetric_id first, then pass it as id (if id is also present in params, the id argument wins). Query parameters go in params (a dict); any path placeholder other than {id} goes in params too (e.g. params={'streamingType': 'spotify'}). For the full parameter spec of one operation, call get_endpoint_details with its path template. Optional: user_question (string) - if this is the first tool call after a new user question, pass the exact user question here verbatim for observability; omit on subsequent calls within the same question. Optional: reasoning (string, 1-2 sentences) - briefly explain why you chose this tool. Operations: - get_aggregate_cities (/SNS/aggregateCities): Retrieves aggregated city data for specified artists. Returns a dictionary containing relevant city metrics and insights associated with the provided artist IDs. - get_audience_age_gender_trend (/SNS/deepSocialTrendRaw/{target}/{id}/{domain}): Daily raw age-and-gender split of an entity's platform audience: twelve buckets per day (13-17, 18-24, 25-34, 35-44, 45-64, 65+, each male and female), returned once per audience metric the platform supports — Instagram followers and likers, YouTube followers and commenters, TikTok followers. - get_audience_countries (/SNS/audience-countries/{source}/{id}): Country distribution of the TikTok creators who posted using a track's sound, or with byArtistId any of an artist's sounds: ISO-2 country code to creator count, all-time or over a rolling last-posted window. TikTok is the only supported source. - get_cm_artist_posts_dates (/SNS/cm_artist/{id}/posts/dates): Retrieves social media posts for a specific artist identified by their unique ID. Returns a dictionary containing the dates associated with the artist's posts. - get_content_categories (/SNS/content-categories/{source}/{id}): Retrieves content categories from a specified source using a unique identifier. Returns a structured dataset containing the relevant categories associated with the given source and ID. - get_content_categories_influencers (/SNS/content-categories/{source}/{id}/influencers/{category}): Retrieves a list of influencers within a specified content category from a given source and ID. Returns a structured response containing the influencers and the total count of results. - get_deep_social (/SNS/deepSocial/{target}/{id}/{domain}): Retrieves deep social insights for a specific target entity on a selected domain. Returns a structured object containing relevant social engagement metrics and data. - get_deep_social_aggregate_by_domain (/SNS/deepSocialAggregate/{domain}): Retrieves aggregated social media data for a specified platform. Returns structured information about social network performance and engagement metrics based on the provided identifiers. - get_deep_social_aggregate_by_target_id_domain (/SNS/deepSocialAggregate/{target}/{id}/{domain}): Retrieves aggregated social media data for a specified target on a given domain. Returns a success flag and relevant data indicating the outcome of the request. - get_deep_social_cm_artist_all_dates (/SNS/deepSocial/cm_artist/{id}/all/dates): Retrieves social media engagement data for a specific artist across various dates. Returns a list of dates along with the corresponding social media platform where the data was gathered. - get_deep_social_cm_artist_dates (/SNS/deepSocial/cm_artist/{id}/{type}/dates): Retrieves social media data for a specific artist by their ID and type. Returns a list of relevant dates along with the platform information. - get_deep_social_cm_artist_instagram_dates (/SNS/deepSocial/cm_artist/{id}/instagram/dates): Retrieves Instagram engagement metrics for a specific artist identified by their unique ID. Returns structured data containing relevant dates and associated metrics for the artist's social media performance. - get_deep_social_cm_artist_snapchat_dates (/SNS/deepSocial/cm_artist/{id}/snapchat/dates): Retrieves Snapchat date data for a specific artist identified by their ID. Returns an array of date values related to the artist's Snapchat activity. - get_deep_social_cm_track_overall_dates (/SNS/deepSocial/cm_track/{id}/overall/dates): The dates on which a track has stored audience-demographic data, newest first — the coverage index for picking a valid date for the track's demographic operations, not the demographics. - get_deep_social_tiktok (/SNS/deepSocial/tiktok/{id}): Retrieves detailed social metrics for a specific TikTok user identified by the provided ID. Returns an object containing relevant social engagement data and user insights. - get_deep_social_trend (/SNS/deepSocialTrend/{target}/{id}/{domain}): Returns time-series of derived/composite social metrics for an artist on a specific social domain (instagram, spotify, youtube, tiktok, etc.). Response is a list where each row has a metric name, value, and timestamp. For domain=instagram the available metrics include engagement_rate, average_likes_per_post, average_comments_per_post, follower_growth, and others — filter the returned series by metric to read a specific value. This is the endpoint behind the Instagram Summary Statistics card's Instagram Engagement Rate, IG ER, and engagement-trend chart (filter for metric='engagement_rate'). Supports since/until for historical lookups. - get_domain_linkings (/SNS/domainLinkings/{id}/{source}): Retrieves domain linking information for a specific entity identified by `{id}` and `{source}`. Returns a list of objects containing metadata and statistics for associated tracks. - get_geo_stat_cm_artist_trend (/SNS/geo-stat/cm_artist/{id}/{platform}/{locationType}/trend): Retrieves geographic trend data for a specific artist on the specified platform. Returns a list of trending statistics based on the given location type. - get_influencer_demographics (/SNS/influencer-demographics/{source}/{id}): Retrieves demographic insights for an influencer based on the specified source and ID. Returns detailed information about demographic types, languages, age and gender distributions, and the availability of data over specific periods. - get_influencer_demographics_influencers (/SNS/influencer-demographics/{source}/{id}/influencers/{dimension}/{value}): Retrieves influencer demographic data from a specified source using unique identifiers and filters based on dimensions and values. Returns a structured dataset along with the total count of influencers matching the criteria. - get_instagram_posts (/SNS/igMedia/{target}/{id}): Instagram posts published by an artist's account over a date range or on one exact date: post id, caption, image URL, upload time, post type, shortcode and the accounts mentioned. Metadata only — no per-post like or comment counts. - get_platform_artist_stat (/SNS/platformArtistStat/{mode}/{source}): Daily time series for a batch of artists at the platform-account level rather than the Chartmetric-artist level: Spotify followers, monthly listeners or popularity; TikTok followers, likes or engagement rate; YouTube subscribers, channel views, daily or monthly video views, monthly listeners or engagement rate. hybrid mode flags interpolated points; raw returns only observed rows. - get_social_audience_breakdown (/SNS/cityAndCountryAudienceTrends/{target}/{id}/{domain}): Daily audience breakdown for an artist on Instagram, YouTube or TikTok, for one audience segment (followers, likes or commenters) and one dimension (country, city, interest, brand, language, stat or demographic): per-day rank and weight per bucket, with lat/lng for places, and for stat or demographic the follower count, average likes/comments/views per post, Instagram engagement rate and the male/female and age-band splits. - get_social_stat_by_target_id_source (/SNS/socialStat/{target}/{id}/{source}): Retrieves social media statistics for a specified target and source. Returns an array of social engagement data related to the provided identifiers. Supports city-level filtering (city_id) for: spotify listeners, instagram followers, youtubeforartist all metrics, radio spins. Supports country-level filtering (code2) for: youtube subscribers, instagram followers, tiktok followers, youtubeforartist all metrics, radio spins. Time-series usage: {target} is the entity type (use cm_artist for a Chartmetric artist id), {source} is the platform (instagram, spotify, youtube, tiktok, applemusic, ...), and ?valueColumn selects the metric. fromDaysAgo and toDaysAgo are required and define the date range (e.g. fromDaysAgo=365&toDaysAgo=0 for the last year; toDaysAgo=0 is today). For Instagram engagement rate over time use target=cm_artist, source=instagram, valueColumn=engagement_rate. For Total Social Footprint history, fetch valueColumn=followers for each platform (instagram, spotify, youtube, tiktok) and sum them per date. - get_social_stat_by_target_source (/SNS/socialStat/{target}/{source}): Retrieves social statistics for a specified target from a given source. Returns a collection of metrics including values, timestamps, and differences over daily, weekly, and monthly periods. - get_social_urls (/SNS/socialUrls/{target}/{id}): Retrieves social media URLs associated with a specified target and ID. Returns an object indicating if a removal request has been made for the given resource. - get_spotify_top_listener_cities (/SNS/spWherePeopleListenInsights/{target}/{id}): Retrieves listener insights for a specified target entity from various platforms, providing data on audience engagement and listening trends over a defined time period. Returns a structured dictionary containing relevant insights based on the provided parameters. - get_spotify_top_listener_cities_snapshot (/SNS/spWherePeopleListenInsightsSnapshot/{target}/{id}): Retrieves insights on listener demographics for a specified target entity, such as an artist or playlist. Returns a structured object containing various analytics related to audience engagement and distribution. - get_tiktok_account_video_stats (/SNS/tiktokAccountVideoStats/{id}): Retrieves video statistics for a specific TikTok account identified by the provided ID. Returns detailed metrics related to the account's video performance. - get_top_social_tracks (/SNS/topTracks/{target}/{id}/{domain}): An artist's or album's best-performing sounds on one UGC platform — TikTok, Instagram, Instagram Reels or YouTube Shorts — ranked by post volume: track name, ISRC, Chartmetric track id, artwork, sound URL, post count with week and month deltas, first post date, plus TikTok views, likes and comments. withTrend adds the post-count trendline. - get_top_video (/SNS/topVideo/{target}/{id}): Retrieves the top video data for a specified target artist. Returns a list of relevant video information associated with the given artist ID. - get_track_trends (/SNS/trackTrends/{domain}/{id}): Retrieves trending track data from the specified domain using the provided track ID. Returns an array of trend objects relevant to the specified track. - get_youtube_geo_view_trends (/SNS/yaGeoTrends/{target}/{id}): Retrieves geolocation trend data for a specified target and ID. Returns information about the top cities and countries, along with their growth trends over one and three months. - get_youtube_view_insights (/SNS/yaInsights/{target}/{id}): Retrieves insights for a specified target and ID from the Chartmetric SNS. Returns geographical data, including information about cities and countries associated with the target. - get_youtube_view_insights_snapshot (/SNS/yaInsightsSnapshot/{target}/{id}): Retrieves insights snapshot data for a specified target entity such as an artist, album, or playlist. Returns the data in a structured dictionary format.
query_songwritersChartmetric songwriters data, one operation per API endpoint. Every operation below operates on songwriters. REQUIRED: operation (string) - pick one from the list below. Resolve a name to a Chartmetric id with search_chartmetric_id first, then pass it as id (if id is also present in params, the id argument wins). Query parameters go in params (a dict); any path placeholder other than {id} goes in params too (e.g. params={'streamingType': 'spotify'}). For the full parameter spec of one operation, call get_endpoint_details with its path template. Optional: user_question (string) - if this is the first tool call after a new user question, pass the exact user question here verbatim for observability; omit on subsequent calls within the same question. Optional: reasoning (string, 1-2 sentences) - briefly explain why you chose this tool. Operations: - get_artist_collaborators (/songwriter/{id}/artistCollaborators): Retrieves artist collaborator information for a specific songwriter. Returns a list of associated artists along with their ranking, popularity, and the number of collaborative recordings. - get_catalog_stats (/songwriter/{id}/catalog/{type}/stats): Retrieves statistics for songwriters' catalogs based on the specified type (tracks or works). Returns a dictionary containing relevant statistical data related to the songwriter's catalog. - get_catalog_tracks (/songwriter/{id}/catalog/tracks): Retrieves the catalog of tracks associated with a specific songwriter identified by the given ID. Returns a list of track data along with pagination information. - get_catalog_works (/songwriter/{id}/catalog/works): Retrieves the catalog of works for a specific songwriter identified by their ID. Returns a list of works along with pagination information, including the total count and offset. - get_chart_history (/songwriter/{id}/{platform}/charts): Chart appearances of the tracks and albums a songwriter is credited on, for one streaming platform (or all, covering Spotify, Melon, QQ, Tencent, Beatport and Circle): chart type, country, city, genre and duration, current rank with its daily change and trend, peak rank and peak date, 7-day velocity, periods on chart, and the charted title with its performing artist. - get_co_writers (/songwriter/{id}/coWriters): Retrieves co-writer information for a specific songwriter identified by the provided ID. Returns a structured dictionary containing details about the co-writers associated with that songwriter. - get_list (/songwriter/list): Retrieves a list of songwriters from the Chartmetric database. Returns information about the total number of songwriters and pagination details for navigating through the results. - get_list_stats (/songwriter/list/stats): Retrieves statistical data for songwriters, including genre counts and various performance metrics. Returns information on rankings, work counts, track counts, and engagement metrics across platforms like Spotify and YouTube. - get_network_connections (/songwriter/{id}/network-connections): Retrieves network connections for a specified songwriter. Returns information about the top co-writer, associated publisher, and recording artists ranked by frequency and popularity. - get_performance_indicators (/songwriter/{id}/performance-indicators): Retrieves performance indicators for a specific songwriter. Returns metrics including work count, track count, and social media engagement statistics. - get_playlists_spotify (/songwriter/{id}/playlists/spotify): Retrieves Spotify playlist data for a specific songwriter identified by their unique ID. Returns an object containing the total number of playlists and an array of the playlists associated with the songwriter. - get_playlists_spotify_countries (/songwriter/{id}/playlists/spotify/countries): Retrieves Spotify playlist data for a specific songwriter identified by {id}. Returns a list of countries associated with the songwriter's playlists, each represented by a two-letter country code. - get_playlists_spotify_stats (/songwriter/{id}/playlists/spotify/stats): Retrieves statistics on Spotify playlists associated with a specific songwriter. Returns data on playlist counts and total followers, segmented by various follower count buckets. - get_songwriter (/songwriter/{id}): Retrieves songwriter information based on the provided ID. Returns detailed metadata including the songwriter's name, associated genres, image, and sub-genres. - get_tracks (/songwriter/{id}/tracks): Retrieves track data for a specific songwriter based on the provided ID. Returns a dictionary containing relevant track information from a specified number of days ago. - get_work_associated_tracks (/work/{id}/associated-tracks): Retrieves associated tracks for a specific work identified by its ID. Returns metadata, including track details, artist information, and genre classification. - get_work_tracks_by_iswc (/work/{iswc}/tracks): Recordings whose own ISWC field matches one ISWC code: each track's Chartmetric id, name, ISRC, cover image, Chartmetric score, release date and genres, plus its primary artist — up to 100, highest score first. Use get_work_associated_tracks to go the other way, from a Chartmetric work id to its linked recordings. - get_youtube_videos (/songwriter/{id}/youtube/videos): Retrieves YouTube video information for a specific songwriter. Returns a structured dictionary containing video details associated with the given songwriter ID. - get_youtube_videos_stats (/songwriter/{id}/youtube/videos/stats): Retrieves statistics for YouTube videos associated with a specific songwriter. Returns the total number of views, total videos, and the corresponding Chartmetric songwriter ID.
query_tracksChartmetric tracks data, one operation per API endpoint. Every operation below operates on tracks. REQUIRED: operation (string) - pick one from the list below. Resolve a name to a Chartmetric id with search_chartmetric_id first, then pass it as id (if id is also present in params, the id argument wins). Query parameters go in params (a dict); any path placeholder other than {id} goes in params too (e.g. params={'streamingType': 'spotify'}). For the full parameter spec of one operation, call get_endpoint_details with its path template. Optional: user_question (string) - if this is the first tool call after a new user question, pass the exact user question here verbatim for observability; omit on subsequent calls within the same question. Optional: reasoning (string, 1-2 sentences) - briefly explain why you chose this tool. Operations: - get_ai_insights (/track/{id}/aiInsights): Retrieves AI insights for a specific track identified by its ID. Returns an object containing the AI-generated analysis or predictions related to the track. - get_artist_ids (/track/{id}/artistIds): Retrieves the artist IDs associated with a specific track. Returns an array of artist objects containing Chartmetric artist identifiers. - get_career (/track/{id}/career): Retrieves career statistics for a specific track identified by its ID. Returns detailed information about the track's career stage, health, and associated scores. - get_chart_history (/track/{streamingType}/{id}/charts): Chart appearances for a track on one streaming platform: chart name, country, rank, peak rank and time on chart. - get_cluster (/track/{id}/cluster): Retrieves cluster information for a specific track identified by its unique ID. Returns a list object containing relevant data about the track's clustering metrics. - get_comparable_locations (/track/comparable/locations/{metric}): Per-city and per-country values of one metric shared by a set of compared tracks. - get_comparable_metrics (/track/comparable/metrics): Retrieves comparable metrics for specified tracks across various music platforms. Returns detailed performance data, including spins, views, and play counts for each track. - get_comparable_metrics_metadata (/track/comparable/metrics/metadata): Retrieves metadata metrics for comparable tracks across various platforms. Returns information including ranks, likes, views, and scores for multiple music-related metrics. - get_flags_by_id_type (/track/{id}/flags/{type}): Timeline flag events for a track over a day window: milestone achievements, Tunefind sync placements, or playlist adds. - get_flags_by_id_type_date (/track/{id}/flags/{type}/{date}): Timeline flag events for a track on one calendar date — Apple Music / iTunes only, so in practice that day's playlist adds. - get_flags_by_type (/track/flags/{type}): Timeline flag events for several tracks at once, keyed by track id: milestone, sync or playlist-add events over a day window. - get_ids (/track/{platform}/{id}/get-ids): Retrieves unique identifiers for a specific track on the given platform. Returns an array of IDs relevant to that track. - get_label_evidence (/track/{id}/label/{labelId}/evidence): Retrieves evidence data for a specific track and label in the Chartmetric database. Returns related information in a structured format for the specified track and label combination. - get_labels (/track/{id}/labels): Retrieves label information for a specific track identified by its ID. Returns data including label names, associated dates, image URLs, confidence levels, and sources of information. - get_list (/track/list): Retrieves a list of tracks from the Chartmetric database. Returns the total number of tracks, the current offset for pagination, and a structure for the track data available. - get_list_legacy (/track/list/legacy): Retrieves a list of track information from the Chartmetric API. Returns metadata, including album details, genres, moods, scores, and artist information for various tracks. - get_list_recommended (/track/list/recommended): Retrieves recommended tracks from the Chartmetric database. Returns metadata including track IDs, names, associated artists, and audio preview links. - get_list_stats (/track/list/stats): Retrieves statistical data regarding track moods and genres. Returns counts of various moods and genres along with statistical ranges for track scores and rankings. - get_list_stats_percent_histograms (/track/list/stats/percent-histograms): Retrieves statistical data related to track performance over specified time periods. Returns histogram data reflecting percentage differences in track metrics. - get_metadata (/track/cm/{id}): Track metadata by Chartmetric track id: title, artists, album, ISRC, genres, moods and scores. - get_milestones (/track/{id}/milestones): Retrieves milestone data for a specific track identified by its ID. Returns a structured response containing key details about the track's milestones. - get_milestones_stats (/track/{id}/milestones/stats): Retrieves milestone statistics for a specific track identified by its unique ID. Returns a structured dictionary containing various statistical data related to the track's milestones. - get_playlists_position_buckets (/track/{id}/playlists/{platform}/position-buckets): Retrieves playlist position buckets for a specific track on the given platform. Returns the number of playlists in which the track appears across defined position ranges. - get_playlists_positions (/track/{id}/playlists/{platform}/positions): Retrieves playlist position data for a specified track on a given platform. Returns a list of positions along with the total count of playlists containing the track. - get_playlists_recommendation (/track/{id}/playlists/recommendation): Retrieves playlist recommendations for a specific track identified by its ID. Returns an array of recommended playlists that feature the track. - get_rich_comparison (/track/{id}/rich-comparison): Retrieves rich comparison statistics for a specific track and its comparison artist. Returns detailed performance metrics for the main artist and the comparing artist in a structured format. - get_same_tracks (/track/{id}/sameTracks): Retrieves a list of tracks that are sonically similar to the specified track ID. Returns a JSON object indicating the presence of similar tracks. - get_short_form_video_stats (/track/{id}/stats/{platform}): Short-form video performance for a track on tiktok, instagram, instagram_reels or youtube_shorts. - get_similar_tracks (/track/{id}/similar-tracks): Retrieves similar tracks for a specified track ID. Returns a list of similar tracks along with their total count and normalized scoring data. - get_similar_tracks_segmented (/track/{id}/similar-tracks/segmented): Retrieves a list of tracks similar to the specified track ID, segmented into specified sizes. Returns a structured response containing the relevant data for the similar tracks found. - get_sounds_performance (/track/{id}/soundsPerformance): Retrieves performance metrics for a specific track identified by its ID. Returns a structured list containing various sound performance data associated with the track. - get_streaming_and_social_stats (/track/{id}/cmStats): Fanbase metrics for a track: Spotify streams and popularity, YouTube views and likes, TikTok posts and views, Shazam counts, and their weekly/monthly deltas. - get_tiktok_top_videos_filter_stats (/track/{id}/tiktok/topVideos/filterStats): Retrieves statistical metrics for the top TikTok videos associated with a specific track ID. Returns data on likes, saves, views, shares, and comments, including their maximum and minimum values. - get_top_influencers_tiktok (/track/{id}/topInfluencers/tiktok): Retrieves the top TikTok influencers associated with a specified track ID. Returns detailed information, including bios, rankings, and social media account links for each influencer. - get_top_influencers_tiktok_featured_videos (/track/{id}/topInfluencers/tiktok/featuredVideos): Returns the top TikTok videos grouped by creator for influencers posting with a track, for creator preview and post drilldowns. - get_top_influencers_tiktok_stats (/track/{id}/topInfluencers/tiktok/stats): Retrieves statistics on top TikTok influencers for a specified track ID. Returns data such as total influencer count and various engagement metrics, categorized by demographics and content attributes. - get_top_sounds (/track/{id}/topSounds): Retrieves the top sounds associated with a specific track identified by its ID. Returns a list of sound data relevant to the specified track. - get_top_sounds_trends (/track/{id}/topSounds/trends): Retrieves trending sound data for a specific track identified by its unique ID. Returns a list of top sounds associated with the given track. - get_top_videos (/track/{id}/topVideos): Retrieves the top videos associated with a specific track ID from the Chartmetric API. Returns metadata about the videos, including totals and the last updated timestamp. - get_top_videos_sounds (/track/{id}/{platform}/topVideos/sounds): Retrieves the top videos associated with a specific track on a given platform. Returns data including video counts and TikTok track IDs for the top-performing videos. - get_track_by_platform_id (/track/{streamingType}/{id}): Track metadata looked up by a streaming platform's own track id rather than the Chartmetric id. - get_track_chart_insights (/track/{id}/trackChartInsights): How often a track charted, bucketed by top-N cutoff (top 10, top 50, top 100, …), with the change versus the previous period. - get_track_chart_summary (/track/{streamingType}/{id}/trackChartSummary): Retrieves summary chart data for a specific track based on the selected streaming service type. Returns information about chart events and changes in chart activity over time. - get_track_name (/track/{id}/track-name): Retrieves the name of a specific track from the Chartmetric database using its unique identifier. Returns the track's name as part of the response object. - get_tunefind (/track/{id}/tunefind): Retrieves TuneFind data for a specific track by its unique identifier. Returns a list of related metadata associated with the track. - get_tunefind_episodes (/track/{id}/tunefind/episodes): Retrieves TuneFind episode data for a specific track identified by its ID. Returns a list structure containing episode-related information linked to the track. - get_tunefind_video_games (/track/{id}/tunefind/video-games): Video-game sync placements for a track, sourced from Tunefind. - get_video_trends (/track/videoTrends): Daily view, like and comment history for one TikTok video, by TikTok account id and video id. - get_youtube (/track/{id}/youtube): Retrieves YouTube-related data for a specific track identified by its unique ID. Returns a dictionary containing relevant information about the track's performance and engagement on the YouTube platform. - get_youtube_comments (/track/{id}/youtube/comments): Retrieves YouTube comments for a specific track identified by its unique ID. Returns a structured dictionary containing the comments associated with the specified track. - get_youtube_comments_by_keyword (/track/youtube/{id}/comments/by-keyword): YouTube comments on a video, optionally filtered to those containing a keyword.
get_artistRetrieves detailed information about a specific artist using their unique identifier. Returns metadata including the artist's name, genres, ISNI, gender, debut date and ranking data. REQUIRED: id (the Chartmetric id; resolve a name with search_chartmetric_id first; if id is also present in params, the id argument wins). Calls /artist/{id}. Optional query parameters in params: topTracks. For everything else in this domain use query_artists. Optional: user_question (string) - if this is the first tool call after a new user question, pass the exact user question here verbatim for observability; omit on subsequent calls within the same question. Optional: reasoning (string, 1-2 sentences) - briefly explain why you chose this tool.
get_trackTrack metadata by Chartmetric track id: title, artists, album, ISRC, genres, moods and scores. REQUIRED: id (the Chartmetric id; resolve a name with search_chartmetric_id first; if id is also present in params, the id argument wins). Calls /track/cm/{id}. Optional query parameters in params: primary. For everything else in this domain use query_tracks. Optional: user_question (string) - if this is the first tool call after a new user question, pass the exact user question here verbatim for observability; omit on subsequent calls within the same question. Optional: reasoning (string, 1-2 sentences) - briefly explain why you chose this tool.