### Chartmetric API Radio Airplay Example Source: https://api.chartmetric.com/apidoc/index Example of how to use curl to fetch radio airplay information for a specific artist. It demonstrates setting the Authorization header and specifying a start date for the query. ```bash curl -H 'Authorization: Bearer [ACCESS KEY]' https://api.chartmetric.com/api/radio/artist/236/airplays?since=2020-02-20 ``` -------------------------------- ### Get All Genres or Search by Name - Example Usage Source: https://api.chartmetric.com/apidoc/index Examples of using curl to interact with the Chartmetric genres endpoint. The first command retrieves all genres, while the second searches for genres matching 'hip-hop'. Both require an 'Authorization' header. ```bash curl -H 'Authorization: Bearer [ACCESS KEY]' https://api.chartmetric.com/api/genres ``` ```bash curl -H 'Authorization: Bearer [ACCESS KEY]' https://api.chartmetric.com/api/genres?name=hip-hop ``` -------------------------------- ### Get Track Charts - Example Usage Source: https://api.chartmetric.com/apidoc/index Example of how to retrieve chart data for a specific track from various platforms like Spotify, iTunes, etc. This requires the track ID, chart type, and optionally a date range (since and until). ```bash curl -H 'Authorization: Bearer [ACCESS KEY]' https://api.chartmetric.com/api/track/22290726/spotify_top_daily/charts?since=2020-03-01&until=2020-03-04 ``` -------------------------------- ### Get Related Artists - cURL Example Source: https://api.chartmetric.com/apidoc/index This example demonstrates how to fetch related artists using a cURL command. It requires an access key for authorization and allows specifying a limit for the number of results and a date range for analysis. ```shell curl -H "Authorization: Bearer [ACCESS KEY]" https://api.chartmetric.com/api/artist/214945/relatedartists?limit=5&fromDaysAgo=7&toDaysAgo=0 ``` -------------------------------- ### Get Radio Airplay Totals (cURL Example) Source: https://api.chartmetric.com/apidoc/index This example demonstrates how to use cURL to fetch the total airplay counts for a specific artist, album, or track. It requires an authorization key and specifies a start date, with optional parameters for limiting results. ```cURL curl -H 'Authorization: Bearer [ACCESS KEY]' https://api.chartmetric.com/api/radio/artist/236/airplay-totals?limit=3&since=2023-03-01 ``` -------------------------------- ### Example API Request using cURL Source: https://api.chartmetric.com/apidoc/index This snippet demonstrates how to make a request to the Chartmetric API to get tracks for a specific artist using cURL. It includes the necessary authorization header and the endpoint URL with an example artist ID. ```bash curl -H 'Authorization: Bearer [ACCESS KEY]' https://api.chartmetric.com/api/artist/206557/tracks ``` -------------------------------- ### Get Chartmetric Genre List (Example Usage) Source: https://api.chartmetric.com/apidoc/index This snippet demonstrates how to fetch the Chartmetric genre list using cURL. It requires an authorization header with an access key. The endpoint is '/api/genre'. ```bash curl -H 'Authorization: Bearer ACCESS_KEY' https://api.chartmetric.com/api/genre ``` -------------------------------- ### Get Airplay Data for Artists (cURL) Source: https://api.chartmetric.com/apidoc/index A cURL command example for fetching daily airplay data for artists. It requires an authorization header with an access key and specifies the start date and duration for the data retrieval. ```cURL curl -H 'Authorization: Bearer [ACCESS KEY]' https://api.chartmetric.com/api/charts/airplay/artists?since=2020-09-09&duration=daily ``` -------------------------------- ### Get Genre by ID - Example Usage Source: https://api.chartmetric.com/apidoc/index Example of how to retrieve a specific Chartmetric genre by its ID using a curl command. This requires an 'Authorization' header with an access key. ```bash curl -H 'Authorization: Bearer [ACCESS KEY]' https://api.chartmetric.com/api/genres/462925 ``` -------------------------------- ### Playlist Stats Endpoint Examples Source: https://api.chartmetric.com/apidoc/index Examples of how to retrieve playlist statistics for Spotify, Deezer, and SoundCloud using the Chartmetric API. These examples demonstrate the curl command structure with authentication and platform-specific IDs. ```shell curl -H 'Authorization: Bearer [ACCESS KEY]' https://api.chartmetric.com/api/playlist/spotify/179228/stats?since=2020-01-01&until=2020-01-10 ``` ```shell curl -H 'Authorization: Bearer [ACCESS KEY]' https://api.chartmetric.com/api/playlist/deezer/53362031/stats ``` ```shell curl -H 'Authorization: Bearer [ACCESS KEY]' https://api.chartmetric.com/api/playlist/soundcloud/228667052/stats ``` -------------------------------- ### cURL Example: Get Similar Artists by Configurations Source: https://api.chartmetric.com/apidoc/index This cURL command demonstrates how to fetch similar artists for a given artist ID using the Chartmetric API. It includes an authorization header and query parameters to filter results by audience, mood, genre, and musicality, along with limit and offset for pagination. ```bash curl -H 'Authorization: Bearer [ACCESS KEY]' https://api.chartmetric.com/api/artist/:id/similar-artists/by-configurations?audience=high&mood=high&genre=high&musicality=high&limit=2&offset=10 ``` -------------------------------- ### Chartmetric API: Get Artist Albums (cURL Example) Source: https://api.chartmetric.com/apidoc/index This cURL command demonstrates how to authenticate and make a request to the Chartmetric API to retrieve albums associated with a specific artist. It requires an authorization header with an access key. ```bash curl -H 'Authorization: Bearer [ACCESS KEY]' https://api.chartmetric.com/api/artist/3380/albums ``` -------------------------------- ### Success 200 Response Example Source: https://api.chartmetric.com/apidoc/index An example of a successful HTTP 200 OK response from the Chartmetric API, detailing artist information and rank statistics. ```json HTTP/1.1 200 OK { "obj": { "length": 500, "data": [ { "id": 5381, "name": "Dua Lipa", "image_url": "https://i.scdn.co/image/552c454001ba87ea580c1f084482991502562996", "isni": "0000000464135414", "code2": "gb", "hometown_city": "London", "current_city": "London", "sp_followers": 24541621, "sp_popularity": 95, "sp_monthly_listeners": 64603939, "deezer_fans": 5777155, "tags": [ "pop", "dance pop", "post-teen pop", "uk pop" ], "spotify_artist_ids": [ "6M2wZ9GZgrQXHCFfjv46we" ], "itunes_artist_ids": [ 1031397873, 399837637 ], "deezer_artist_ids": [ "8706544" ], "cm_artist_rank": 8, "amazon_artist_ids": [ "B0143OIF9G" ], "rank": 1, "plays": 9510, "cm_artist": 5381, "added_at": "2021-05-05T07:00:00.000Z", "velocity": 0.142857142857143, "pre_rank": 2, "peak_rank": 1, "peak_date": "2020-03-08T08:00:00.000Z", "time_on_chart": "491", "rankStats": [ { "rank": 2, "plays": 5158, "timestp": "2021-04-08T07:00:00.000Z" }, { "rank": 2, "plays": 5051, "timestp": "2021-04-09T07:00:00.000Z" }, { "rank": 2, "plays": 5408, "timestp": "2021-04-10T07:00:00.000Z" }, ... ] }, ... ] } } ``` -------------------------------- ### Get Playlist Metadata (Example Usage) Source: https://api.chartmetric.com/apidoc/index This snippet shows how to retrieve playlist metadata from Chartmetric using cURL. It requires an authorization header and specifies the platform (e.g., spotify) and the playlist ID in the URL. ```bash curl -H 'Authorization: Bearer [ACCESS KEY]' https://api.chartmetric.com/api/playlist/spotify/179228/ ``` -------------------------------- ### Success Response Example Source: https://api.chartmetric.com/apidoc/index Example of a successful API response for artist statistics, containing a list of data points with scores and timestamps. ```json HTTP/1.1 200 OK { "obj": [ { "score": 0.777289463353648, "timestp": "2019-12-10T00:00:00.000Z" }, { "score": 0.812443293506014, "timestp": "2019-12-12T00:00:00.000Z" }, { "score": 0.758845785647956, "timestp": "2019-12-13T00:00:00.000Z" }, { "score": 0.793494709937929, "timestp": "2019-12-14T00:00:00.000Z" }, { "score": 0.805720732987306, "timestp": "2019-12-15T00:00:00.000Z" } ] } ``` -------------------------------- ### Get Artist YouTube Views and Market Coverage (cURL) Source: https://api.chartmetric.com/apidoc/index Example cURL command to fetch an artist's YouTube views and market coverage data. Requires an access key and specifies the artist ID and date for the query. ```shell curl -H 'Authorization: Bearer [ACCESS KEY]' https://api.chartmetric.com/api/artist/3380/market-coverage-views/youtube?date=2020-12-13 ``` -------------------------------- ### Playlist Success Response Example Source: https://api.chartmetric.com/apidoc/index An example of a successful HTTP 200 response when retrieving playlist data, showing the structure of the returned playlist object. ```json HTTP/1.1 200 OK { "obj": [ { "id": 93878425, "value": 6527755, "timestp": "Thu Oct 10 2019", "daily_diff": 0, "interpolated": false }, ... ] } ``` -------------------------------- ### Example Success Response (aggregate=false) Source: https://api.chartmetric.com/apidoc/index An example of a successful API response when requesting non-aggregated artist IDs. Each entry represents a specific platform ID for the artist. ```json HTTP/1.1 200 OK { "obj": [ { "cm_artist": 4904, "artist_name": "Hailee Steinfeld", "spotify_artist_id": "5p7f24Rk5HkUZsaS3BLG5F", "itunes_artist_id": 417571723, "deezer_artist_id": "5961630", "amazon_artist_id": "B00L4I14C0", "youtube_channel_id": "UCWfytcGFwPSMwvP5HYuXGqw", }, { "cm_artist": 4904, "artist_name": "Hailee Steinfeld", "spotify_artist_id": "5p7f24Rk5HkUZsaS3BLG5F", "itunes_artist_id": 417571723, "deezer_artist_id": "5961630", "amazon_artist_id": "B00L48A8F4", "youtube_channel_id": "UCWfytcGFwPSMwvP5HYuXGqw", }, ... ] } ``` -------------------------------- ### Chartmetric API Search Example (Beta) Source: https://api.chartmetric.com/apidoc/index This cURL command shows an example of using the beta search engine for enhanced relevance. It includes the 'beta=true' flag, specifies a platform ('spotify'), and a search type ('tracks'), alongside the query and limit. ```bash curl -H 'Authorization: Bearer [ACCESS KEY]' https://api.chartmetric.com/api/search?q=Ariana&limit=10&beta=true&platforms[]=spotify&type=tracks ``` -------------------------------- ### Get Airplay Data for Tracks (cURL) Source: https://api.chartmetric.com/apidoc/index A cURL command example for fetching daily airplay data for tracks. Similar to the artist endpoint, it requires an authorization header and specifies the start date and duration. ```cURL curl -H 'Authorization: Bearer [ACCESS KEY]' https://api.chartmetric.com/api/charts/airplay/tracks?since=2020-09-09&duration=daily ``` -------------------------------- ### Chartmetric API Search Example (Cities Beta) Source: https://api.chartmetric.com/apidoc/index This cURL command illustrates searching for cities using the beta engine. It includes 'triggerCitiesOnly=true' to exclusively return trigger cities, along with 'beta=true', a query for 'seoul', and a specified limit. ```bash curl -H 'Authorization: Bearer [ACCESS KEY]' https://api.chartmetric.com//api/search?q=seoul&limit=10&type=cities&triggerCitiesOnly=true&beta=true ``` -------------------------------- ### Chartmetric API Success Response Example Source: https://api.chartmetric.com/apidoc/index An example of a successful HTTP 200 OK response from the Chartmetric API, illustrating the structure of artist data. This includes basic artist information, career status metrics (stage, trend), and detailed engagement counts across multiple platforms like Spotify, YouTube, and Facebook. ```json HTTP/1.1 200 OK { "obj": { "obj": [ { "cm_artist": "3852", "name": "The Weeknd", "pronoun": "he/him", "band": false, "image_url": "https://i.scdn.co/image/ab6761610000e5eb214f3cf1cbe7139c1e26ffbb", "code2": "CA", "cm_tag": [ 462882, 462889, 462887 ], "career_status": { "stage": "superstar", "stage_score": 81, "trend": "steady", "trend_score": 48 }, "cm_artist_rank": 3, "rank_eg": 4, "rank_fb": 8, "amazon_ed_playlist_count": 953, "amazon_playlist_count": 1022, "boomplay_comments": null, "boomplay_favorites": null, "boomplay_plays": null, "boomplay_ranking_current": null, "boomplay_shares": null, "bs_followers": 5098140, "deezer_ed_playlist_count": 410, "deezer_ed_playlist_total_reach": 16606625, "deezer_fans": 12799696, "deezer_playlist_count": 1793, "deezer_playlist_total_reach": 29093015, "facebook_followers": 17551796, "fs_likes": 17551796, "fs_talks": 164567, "genius_pageviews": 146897583, "ins_engagement_rate": 1.8932, "ins_followers": 75278195, "itunes_ed_playlist_count": 1479, "itunes_playlist_count": 4030, "line_music_artist_likes": 39175, "line_music_likes": 121504, "line_music_mv_plays": 7610, "line_music_plays": 18834566, "melon_artist_fans": 64626, "melon_likes": 998788, "melon_video_likes": 3223, "melon_video_views": 284132, "pandora_lifetime_stations_added": 30481713, "pandora_lifetime_streams": 11089516088, "pandora_listeners_28_day": 4942003, "shazam_count": 332903895, "songkick_fans": 5810426, "soundcloud_followers": 7022834, "soundcloud_plays": 811751165, "sp_followers": 90205700, "sp_followers_to_listeners_ratio": 0.862086, "sp_listeners_to_followers_ratio": 1.159978, "sp_monthly_listeners": 104636584, "sp_popularity": 94, "spotify_ed_playlist_count": 1689, "spotify_ed_playlist_total_reach": 97141939, "spotify_playlist_count": 2646495, "spotify_playlist_total_reach": 806946810, "tiktok_followers": 9600000, "tiktok_likes": 50200000, "tiktok_top_video_views": 22291146251, "tiktok_track_posts": 10215696, "ts_followers": 17066030, "twitch_followers": 8882, "twitch_monthly_viewer_hours": null, "twitch_views": null, "twitch_weekly_viewer_hours": null, "ws_views": 7961, "ycs_subscribers": 35900000, "ycs_views": 28277468141, "youtube_daily_video_views": 16611114, "youtube_ed_playlist_count": 28, "youtube_ed_playlist_total_reach": 81551434, "youtube_monthly_video_views": 440747883, "youtube_playlist_count": 1190, "youtube_playlist_total_reach": 8116380417, "de_editorial_playlist_total_reach": 16606625, "de_playlist_total_reach": 29093015, "facebook_likes": 17551796, "facebook_talks": 164567, "num_am_editorial_playlists": 1479, "num_am_playlists": 4030, "num_az_editorial_playlists": 953, "num_az_playlists": 1022 } ] } } ``` -------------------------------- ### Get Artist Historical Rank Response (HTTP) Source: https://api.chartmetric.com/apidoc/index Example success response for the Get Artist Historical Rank endpoint, showing artist rank and associated genre information. ```http HTTP/1.1 200 OK { "obj": [ { "artist_rank": 1, "genre_id": 188, "genre": "pop" }, { "artist_rank": 1, "genre_id": 419154, "genre": "uk pop" } ] } ``` -------------------------------- ### Get Instagram Audience Data Dates Response (HTTP) Source: https://api.chartmetric.com/apidoc/index Example success response for the Get Instagram Audience Data Dates endpoint, providing an array of dates in YYYY-MM-DD format. ```http HTTP/1.1 200 OK { "obj": [ "2022-09-12", "2022-09-11", ... ] } ``` -------------------------------- ### API Success Response Example (HTTP) Source: https://api.chartmetric.com/apidoc/index An example of a successful HTTP 200 OK response from the Chartmetric API, detailing artist information and associated show data. ```json HTTP/1.1 200 OK { "obj": { "people": { "id": 64614, "name": "Ed Sheeran", "gender": 1, "image": "http://static.tvmaze.com/uploads/images/original_untouched/13/34295.jpg", "date_of_birth": "1991-02-01T08:00:00.000Z", "date_of_death": null, "country_code": "GB", "tv_maze_url": "http://www.tvmaze.com/people/64614/ed-sheeran", "cm_artist": 3648, "created_at": null, "modified_at": "2020-11-12T18:09:59.730Z" }, "shows": [ { "title": "Modern Love", "as": "Guest starring as Mick", "url": "https://www.tvmaze.com/shows/37120/modern-love", "year": "2019", "episodes": [ { "title": "Episode 1x07: Hers Was a World of One (Oct 18, 2019)", "url": "https://www.tvmaze.com/episodes/1718414/modern-love-1x07-hers-was-a-world-of-one", "date": "Oct 18, 2019" } ], "show_details": { "id": 37120, "name": "Modern Love", "genres": [ "Comedy", "Romance" ], "runtime": null, "premiered": "2019-10-18T07:00:00.000Z", "officialsite": "https://www.amazon.com/dp/B07VMF8TL9/", "rating": "7.5", "image": "http://static.tvmaze.com/uploads/images/original_untouched/216/540345.jpg", "summary": "

An unlikely friendship. A lost love resurfaced. A marriage at its turning point. A date that might not have been a date. An unconventional new family. These are unique stories about the joys and tribulations of love, each inspired by a real-life personal essay from the beloved New York Times column \"Modern Love.\"

", "tv_maze_url": "http://www.tvmaze.com/shows/37120/modern-love", "created_at": "2020-09-23T22:03:25.001Z", "modified_at": "2020-11-18T00:36:13.551Z" } }, ... ] } } ``` -------------------------------- ### Chartmetric API Search Example (Basic) Source: https://api.chartmetric.com/apidoc/index This cURL command demonstrates a basic search query to the Chartmetric API. It specifies a search term 'Ariana' and a limit of 10 results. The Authorization header is required for authentication. ```bash curl -H 'Authorization: Bearer [ACCESS KEY]' https://api.chartmetric.com/api/search?q=Ariana&limit=10 ``` -------------------------------- ### Get Hanteo Album Chart Data - Curl Example Source: https://api.chartmetric.com/apidoc/index Example of how to fetch album chart data from Hanteo using a cURL command. Requires an authorization token and specifies chart type and duration parameters. ```curl curl -H 'Authorization: Bearer [ACCESS KEY]' https://api.chartmetric.com/api/charts/hanteo/album/music?duration=daily&date=2025-06-03 ``` -------------------------------- ### Station Response Example (HTTP) Source: https://api.chartmetric.com/apidoc/index This example demonstrates the HTTP response format for a Station data request. It provides an array of radio stations, including their ID, name, geographical and location details, plays, and play trends. ```HTTP HTTP/1.1 200 OK { "obj": [ { "id": 190585, "name": "KALV-FM", "code2": "US", "city": "Phoenix", "country": "United States", "plays": 733, "plays_percent": 0.007330659759378344, "plays_trend": [ { "air_date": "2023-01-01", "count": 8 }, ... ] }, ... ] } ``` -------------------------------- ### Get Album IDs - Chartmetric Example Source: https://api.chartmetric.com/apidoc/index This cURL command demonstrates how to retrieve album IDs from Chartmetric using their specific ID. It requires an authorization header with an access key and specifies the API endpoint for getting album IDs. ```bash curl -H 'Authorization: Bearer [ACCESS KEY]' https://api.chartmetric.com/api/album/chartmetric/815685/get-ids ``` -------------------------------- ### HTTP Response Example Source: https://api.chartmetric.com/apidoc/index Demonstrates a successful HTTP response (200 OK) containing track data, likely from an API endpoint. ```http HTTP/1.1 200 OK { "obj": [ { "cm_track": 118981138, "album": [ { "id": 34612905, "label": "Island Records", "name": "Espresso", "ordering": 0, "release_date": "2024-04-12", "upc": "602465590111" } ], "artist": [ { "id": 4550, "name": "Sabrina Carpenter" } ], "explicit": true, "genre": [ "Pop" ], "image_url": "https://i.scdn.co/image/ab67616d0000b273659cd4673230913b3918e0d5", "isrc": "USUM72403305", "label": null, "name": "Espresso", "score": 3320, "songwriter": [ "Sabrina Carpenter", "Julian Bunetta", "Amy Allen", "Steph Jones" ], "moods": [ "WARM", "SEXY", "RELAXED", "BLUE", "ROMANTIC" ], "shortlists": [], "latest": { "rank": { "perc_overall": 1, "rank_overall": 12, "score_overall": 0.332044489986, "score_percentile": 1 }, "airplay_streams": 109726, "amazon_playlist_count": 186, "deezer_playlist_count": 200, "itunes_playlist_count": 334, "shazam_count": 3393775, "siriusxm_streams": 481, "soundcloud_plays": 3458859, "spotify_playlist_count": 91185, "spotify_playlist_total_reach": 285235306, "spotify_plays": 1142937103, "spotify_popularity": 98, "spotify_ed_playlist_count": 170, "spotify_ed_playlist_total_reach": 100666115, "tidal_popularity": null, "tiktok_posts": 348800, "tiktok_top_videos_likes": 235011595, "tiktok_top_videos_views": 2051778600, "youtube_likes": 3441584, "youtube_playlist_count": 64, "score": 0.332044489986 }, "monthly_diff": { "rank": { "rank_overall": 1 }, "airplay_streams": 26778, "amazon_playlist_count": 25, "deezer_playlist_count": 11, "itunes_playlist_count": 13, "shazam_count": 639928, "siriusxm_streams": 103, "soundcloud_plays": 614975, "spotify_playlist_count": 22747, "spotify_playlist_total_reach": 17668703, "spotify_plays": 175402535, "spotify_popularity": -1, "spotify_ed_playlist_count": 3, "spotify_ed_playlist_total_reach": 264678, "tidal_popularity": null, "tiktok_posts": 0, "tiktok_top_videos_likes": 223600, "tiktok_top_videos_views": 3699500, "youtube_likes": 499744, "youtube_playlist_count": 29 }, "weekly_diff": { "rank": { "rank_overall": 2 }, "airplay_streams": 5845, "amazon_playlist_count": 20, "deezer_playlist_count": 10, "itunes_playlist_count": 12, "shazam_count": 154348, "siriusxm_streams": 13, "soundcloud_plays": null, "spotify_playlist_count": 5638, "spotify_playlist_total_reach": 6933667, "spotify_plays": 52404270, "spotify_popularity": 0, "spotify_ed_playlist_count": 1, "spotify_ed_playlist_total_reach": -536256, "tidal_popularity": null } } ] } ``` -------------------------------- ### Get Pandora Track Chart Data - Curl Example Source: https://api.chartmetric.com/apidoc/index Example of how to use curl to fetch track data from Pandora Charts. Requires an authorization token and specifies the chart type, latest data flag, and a specific date. ```bash curl -H 'Authorization: Bearer [ACCESS KEY]' https://api.chartmetric.com/api/charts/pandora/track/top_spins?latest=true&date=2025-06-03 ``` -------------------------------- ### Get Track Stats (Spotify - Most History) Source: https://api.chartmetric.com/apidoc/index Retrieves the most historical data for a track on Spotify. Requires an access key and a start date. ```curl curl -H 'Authorization: Bearer [ACCESS KEY]' https://api.chartmetric.com/api/track/15611361/spotify/stats/most-history?since=2022-01-01 ``` -------------------------------- ### Get Album Metadata (cURL) Source: https://api.chartmetric.com/apidoc/index Example of how to retrieve album metadata using cURL. It requires an authorization header with an access key and the album ID in the URL. ```bash curl -H 'Authorization: Bearer [ACCESS KEY]' https://api.chartmetric.com/api/album/815685/ ``` -------------------------------- ### Chartmetric API Success Response Example Source: https://api.chartmetric.com/apidoc/index This snippet demonstrates a typical successful response (HTTP 200 OK) from the Chartmetric API, detailing various artist metrics such as top countries, audience gender distribution by age, notable followers with their geographic information, and overall engagement statistics. ```json { "obj": { "top_countries": [ { "name": "United States", "code": "US", "percent": "17.99", "subscribers": 9479043 } ], "audience_genders_per_age": [ { "code": "13-17", "male": "5.89", "female": "2.71" } ], "audience_genders": [ { "code": "male", "weight": "72.92" }, { "code": "female", "weight": "27.08" } ], "notable_followers": [ { "user_id": "UCcvSMLuj0OcAASPsTyVlzBA", "username": "DanKarChannel", "custom_name": "DanKar", "picture": "https://yt3.ggpht.com/ytc/AKedOLQ129KckPBX2XZ2Os827HlAU39UBZ5v3ImQqWfWzQ=s480-c-k-c0x00ffffff-no-rj", "fullname": "Данкар", "url": "https://www.youtube.com/channel/UCcvSMLuj0OcAASPsTyVlzBA", "geo": { "country": { "id": 60189, "name": "Russia", "code": "RU", "coords": { "lat": 55.75222, "lon": 37.61556 } } }, "is_verified": true, "engagements": 167549, "avg_likes": 167549, "avg_views": 2499180, "subscribers": 7720000 } ], "followers": 42900000, "avg_likes_per_post": 112574, "avg_commments_per_post": 5679, "engagement_rate": 0.2624 } } ``` -------------------------------- ### Curator Information Response Source: https://context7.com/context7/api_chartmetric_apidoc/llms.txt Example JSON response for getting curator information, including ID, name, platform, follower count, playlist count, and image URL. ```json { "obj": { "id": 12345, "name": "Filtr", "platform": "spotify", "follower_count": 2345678, "playlist_count": 156, "image_url": "https://..." } } ``` -------------------------------- ### Get Track Stats (Spotify - Highest Playcounts) Source: https://api.chartmetric.com/apidoc/index Fetches the highest play counts for a track on Spotify. Requires an access key and specifies a start date for the query. ```curl curl -H 'Authorization: Bearer [ACCESS KEY]' https://api.chartmetric.com/api/track/15611361/spotify/stats/highest-playcounts?since=2022-01-01 ``` -------------------------------- ### Fetch Album Playlists using cURL Source: https://api.chartmetric.com/apidoc/index Example of fetching album playlist data using cURL. This demonstrates how to authenticate with an access key and specify various platform-specific playlist parameters. ```shell curl -H 'Authorization: Bearer [ACCESS KEY]' https://api.chartmetric.com/api/album/5449730/spotify/current/playlists?editorial=true&editorialBrand=false&personalized=true&deezerPartner=false&chart=false&thisIs=false&hundredPercent=false&newMusicFriday=true&radio=false&fullyPersonalized=false&brand=true&majorCurator=true&musicBrand=false&nonMusicBrand=false&popularIndie=true&indie=true&audiobook=false ``` ```shell curl -H 'Authorization: Bearer [ACCESS KEY]' https://api.chartmetric.com/api/album/28104961/spotify/current/playlists?indie=false&editorial=false&majorCurator=false&newMusicFriday=true ``` -------------------------------- ### Get Artist TikTok Audience Stats (curl) Source: https://api.chartmetric.com/apidoc/index Example cURL command to retrieve TikTok audience statistics for a specific artist. Requires an authorization header with an access key. ```shell curl -H "Authorization: Bearer [ACCESS KEY]" https://api.chartmetric.com/api/artist/5408/tiktok-audience-stats ``` -------------------------------- ### Get Artist Airplay Totals by Track Source: https://api.chartmetric.com/apidoc/index This curl command fetches the total airplays for a specific artist aggregated by track. It requires an access key and a start date for the analysis. ```curl curl -H 'Authorization: Bearer [ACCESS KEY]' https://api.chartmetric.com/api/radio/artist/206557/airplay-totals/track?since=2023-03-16 ``` -------------------------------- ### Universal Search Results Example Source: https://context7.com/context7/api_chartmetric_apidoc/llms.txt Example JSON response for a universal search query, showing artist details including ID, name, image URL, and Spotify followers. ```json { "obj": { "artists": [ { "id": 2762, "name": "Taylor Swift", "image_url": "https://i.scdn.co/image/வதற்காக", "spotify_followers": 87654321 } ] } } ``` -------------------------------- ### Get All Genres - Success Response Source: https://api.chartmetric.com/apidoc/index Example of a successful response (HTTP 200 OK) when requesting all genres. The response includes an 'obj' array containing genre objects, each with an ID and name. ```json HTTP/1.1 200 OK { "obj": [ { "id": 462862, "name": "Devotional & Spiritual" }, { "id": 462863, "name": "Mandopop" } ] } ``` -------------------------------- ### Chartmetric API - Example Track Response Source: https://api.chartmetric.com/apidoc/index An example JSON response from the Chartmetric API detailing a track's metadata. Includes information such as track name, artist, album, genre, ranking, and historical performance data. ```json { "obj": { "length": 200, "data": [ { "id": 78333, "name": "Thriller", "isrc": "USSM19902989", "itunes_album_id": [ "269572838" ], "composer_name": null, "image_url": "http://is4.mzstatic.com/image/thumb/Features/v4/57/9a/d2/579ad2e5-e9eb-630a-dafd-1704e0fbe9cc/mza_1011095246346662165.jpg/170x170bb-85.jpg", "cm_track": 15823679, "track_genre": "R&B/Soul", "cm_artist": [ 178 ], "artist_names": [ "Michael Jackson" ], "code2s": [ "US" ], "artist_images": [ "https://i.scdn.co/image/51dad9aaabe5643818840207a9a8957c2ad91bf2" ], "artist_covers": [ null ], "itunes_artist_ids": [ 32940 ], "itunes_artist_names": [ "Michael Jackson" ], "itunes_track_ids": [ "269573303" ], "itunes_album_ids": [ "269572838" ], "storefronts": [ "US" ], "album_ids": [ 3952604 ], "album_names": [ "Thriller" ], "album_upc": [ "074643811224" ], "album_label": [ "℗ 1982 MJJProductions Inc." ], "release_dates": [ "1982-11-30T00:00:00.000Z" ], "rank": 1, "added_at": "2018-11-01T00:00:00.000Z", "code2": "US", "genre": "Pop", "itunes": 78333, "velocity": 2, "pre_rank": 1, "peak_rank": 1, "peak_date": "2020-11-01T00:00:00.000Z", "time_on_chart": "394", "rankStats": [ { "rank": 15, "timestp": "2018-10-25T00:00:00.000Z" }, { "rank": 15, "timestp": "2018-10-26T00:00:00.000Z" } ] } ] } } ``` -------------------------------- ### Spotify Charts Track Data Example Source: https://api.chartmetric.com/apidoc/index Provides an example JSON response for track data from Spotify Charts. This includes details such as track name, artist, Spotify IDs, popularity, and associated album information. ```json { "obj": [ { "id": 69975, "name": "Mad at Disney", "isrc": "QMEZE2076989", "spotify_album_id": "1xWYSg7J7pxTZ113CJVy1P", "image_url": "https://i.scdn.co/image/ab67616d0000b2731cb068e27f83975bc827586e", "spotify_popularity": null, "cm_track": 29906763, "spotify_artist_names": [ "salem ilese" ], "track_genre": null, "cm_artist": [ 728818 ], "artist_names": [ "salem ilese" ], "code2s": [ "US" ], "artist_images": [ "https://i.scdn.co/image/520167c51d8540a7cec6d4b8a41deb9712dcfe10" ], "artist_covers": [ null ], "spotify_artist_ids": [ "3QJUFtGBGL05vo0kCJZsmT" ], "spotify_track_ids": [ "7aGyRfJWtLqgJaZoG9lJhE" ], "spotify_album_ids": [ "1xWYSg7J7pxTZ113CJVy1P" ], "spotify_duration_ms": 136838, "album_ids": [ 6402940 ], "album_names": [ "Mad at Disney" ], "album_upc": [ "842812134579" ], "album_label": [ "Homemade Projects, LLC / TenThousand Projects" ], "release_dates": [ "2020-07-24T00:00:00.000Z" ], "spotify_track_id": "7aGyRfJWtLqgJaZoG9lJhE", "num_ff_playlists": "961", "fresh_finds_playlists": [ "Fresh Finds: Best of Pop 2020", "Fresh Finds" ] }, ... ] } ``` -------------------------------- ### Get Artist Airplay Totals by Country Source: https://api.chartmetric.com/apidoc/index This curl command retrieves the total airplays for a specific artist aggregated by country. It requires an access key and a start date, with optional limits. ```curl curl -H 'Authorization: Bearer [ACCESS KEY]' https://api.chartmetric.com/api/radio/artist/3079/airplay-totals/country?since=2023-01-01&limit=20 ``` -------------------------------- ### Get Artist ANR by Playlists (cURL) Source: https://api.chartmetric.com/apidoc/index Example cURL command to fetch Artist ANR by playlists from the Chartmetric API. Requires an authorization header and allows for sorting and specifying the streaming type. ```bash curl -H 'Authorization: Bearer ACCESS_KEY' https://api.chartmetric.com/api/artist/anr/by/playlists?limit=100&sortBy=followers_total_reach_diff_week&streamingType=spotify ``` -------------------------------- ### Fetch Playlist Snapshot using cURL Source: https://api.chartmetric.com/apidoc/index This example demonstrates how to retrieve playlist snapshot data from the Chartmetric API using a cURL command. It requires an authorization header with an access key and specifies the platform, playlist ID, and an optional date parameter. ```shell curl -H "Authorization: Bearer [ACCESS KEY]" https://api.chartmetric.com/api/playlist/spotify/179228/snapshot?date=2018-10-01 ``` -------------------------------- ### Get Album Statistics Response Source: https://api.chartmetric.com/apidoc/index Example of a successful HTTP 200 response when fetching album statistics. It returns an array of objects, each containing a 'value' (e.g., popularity) and a 'timestp' (timestamp) for the statistic. ```json HTTP/1.1 200 OK { "obj": [ { "value": 97, "timestp": "2020-09-20T07:00:00.000Z" }, { "value": 97, "timestp": "2020-09-21T07:00:00.000Z" }, { "value": 97, "timestp": "2020-09-22T07:00:00.000Z" }, { "value": 97, "timestp": "2020-09-23T07:00:00.000Z" } ] } ``` -------------------------------- ### Chartmetric API Success Response (200 OK) - JSON Example Source: https://api.chartmetric.com/apidoc/index Illustrates a successful response (HTTP 200 OK) from the Chartmetric API, showcasing the structure of 'top_countries' and 'top_cities' data for an artist. This provides a sample of how geographical audience data is returned. ```json HTTP/1.1 200 OK { "obj": { "top_countries": [ { "name": "United States", "code": "US", "percent": "24.79", "followers": 7661481 }, ... ], "top_cities": [ { "name": "New York City", "percent": "1.57", "followers": 486692, "state": "New York", "country": "United States" }, ... ] } } ```