{ "info": { "_postman_id": "38d9702c-89f5-45ed-9a84-bf1476df54e7", "name": "Songstats API", "description": "Enterprise Access to Music Data across all DSPs\n\nEnterprise API collection generated from docs/songstats_api_openapi.yaml and live Rails Enterprise routes.\nSet the `api_key` collection variable before sending authenticated requests. The collection uses the `apikey` header for authentication.\n\nPostman exports collections as JSON. This file uses the Postman Collection v2.1 schema.", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json" }, "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "apikey", "type": "string" }, { "key": "value", "value": "{{api_key}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] }, "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "pm.test('Response status is below 500', function () {", " pm.expect(pm.response.code).to.be.below(500);", "});" ] } } ], "variable": [ { "key": "base_url", "value": "https://api.songstats.com/enterprise/v1", "type": "string", "description": "Songstats Enterprise API base URL." }, { "key": "api_key", "value": "", "type": "string", "description": "Set this to your Songstats Enterprise API key. It is sent in the apikey header." }, { "key": "accept_encoding", "value": "gzip, deflate, br", "type": "string" }, { "key": "source", "value": "all", "type": "string", "description": "Use all, overview, or a comma-separated source list such as spotify,apple_music,deezer." }, { "key": "songstats_artist_id", "value": "pod5zlug", "type": "string" }, { "key": "spotify_artist_id", "value": "28j8lBWDdDSHSSt5oPlsX2", "type": "string" }, { "key": "apple_music_artist_id", "value": "261545033", "type": "string" }, { "key": "songstats_collaborator_id", "value": "vkwh40ql", "type": "string" }, { "key": "tidal_artist_id", "value": "49475872", "type": "string" }, { "key": "songstats_label_id", "value": "7gk4yfc9", "type": "string" }, { "key": "beatport_label_id", "value": "74932", "type": "string" }, { "key": "songstats_track_id", "value": "k4bp9etx", "type": "string" }, { "key": "spotify_track_id", "value": "1YLGtZjDKyY0Qkv4QlX31b", "type": "string" }, { "key": "apple_music_track_id", "value": "1567644047", "type": "string" }, { "key": "isrc", "value": "GBAYE2100626", "type": "string" }, { "key": "country_code", "value": "US", "type": "string" }, { "key": "start_date", "value": "2021-12-31", "type": "string" }, { "key": "end_date", "value": "2022-01-16", "type": "string" }, { "key": "limit", "value": "20", "type": "string" }, { "key": "offset", "value": "0", "type": "string" }, { "key": "search_query", "value": "Disclosure", "type": "string" }, { "key": "source_link", "value": "https://soundcloud.com/dontblink/vibration", "type": "string", "description": "Example source object link used by link_request endpoints." }, { "key": "track_link", "value": "https://music.apple.com/us/album/smalltown-boy/1743410570?i=1743410576", "type": "string", "description": "Example track link used by track_request add endpoints." }, { "key": "metric", "value": "playlists", "type": "string" }, { "key": "scope", "value": "total", "type": "string" }, { "key": "tier", "value": "4", "type": "string" }, { "key": "milestones", "value": "true", "type": "string" }, { "key": "albums", "value": "true", "type": "string" }, { "key": "editorial", "value": "false", "type": "string" }, { "key": "recent", "value": "false", "type": "string" }, { "key": "comments", "value": "true", "type": "string" }, { "key": "with_links", "value": "true", "type": "string" }, { "key": "with_playlists", "value": "true", "type": "string" }, { "key": "with_charts", "value": "true", "type": "string" }, { "key": "with_videos", "value": "true", "type": "string" }, { "key": "with_stations", "value": "true", "type": "string" }, { "key": "with_aggregates", "value": "true", "type": "string" }, { "key": "only_current", "value": "true", "type": "string" }, { "key": "radio_type", "value": "radio", "type": "string" }, { "key": "station_name", "value": "Example FM", "type": "string" }, { "key": "station_website", "value": "https://example.com", "type": "string" }, { "key": "station_stream_url", "value": "https://example.com/stream", "type": "string" }, { "key": "station_city_name", "value": "Los Angeles", "type": "string" }, { "key": "station_frequency", "value": "101.1", "type": "string" }, { "key": "station_contact", "value": "programming@example.com", "type": "string" }, { "key": "station_comment", "value": "Example station request from the Postman collection.", "type": "string" }, { "key": "spotify_playlist_id", "value": "37i9dQZF1DXcBWIGoYBM5M", "type": "string" } ], "item": [ { "name": "Info", "item": [ { "name": "Get Status", "request": { "method": "GET", "header": [ { "key": "Accept-Encoding", "value": "{{accept_encoding}}", "description": "gzip, deflate, br", "type": "text" } ], "url": { "raw": "{{base_url}}/status", "host": [ "{{base_url}}" ], "path": [ "status" ], "query": [] }, "description": "Returns current status of API and quota.\nGenerated from docs/songstats_api_openapi.yaml.\n\nHeaders:\n- Accept-Encoding: gzip, deflate, br\n\nDocumented responses: 200, 400, 401, 403, 404, 429, 500, 502, 503." }, "response": [] }, { "name": "Get Definitions", "request": { "method": "GET", "header": [ { "key": "Accept-Encoding", "value": "{{accept_encoding}}", "description": "gzip, deflate, br", "type": "text" } ], "url": { "raw": "{{base_url}}/definitions", "host": [ "{{base_url}}" ], "path": [ "definitions" ], "query": [] }, "description": "Returns definitions for all data points.\nGenerated from docs/songstats_api_openapi.yaml.\n\nHeaders:\n- Accept-Encoding: gzip, deflate, br\n\nDocumented responses: 200, 400, 401, 403, 404, 429, 500, 502, 503." }, "response": [] }, { "name": "Get Sources", "request": { "method": "GET", "header": [ { "key": "Accept-Encoding", "value": "{{accept_encoding}}", "description": "gzip, deflate, br", "type": "text" } ], "url": { "raw": "{{base_url}}/sources", "host": [ "{{base_url}}" ], "path": [ "sources" ], "query": [] }, "description": "Returns currently supported data sources.\nGenerated from docs/songstats_api_openapi.yaml.\n\nHeaders:\n- Accept-Encoding: gzip, deflate, br\n\nDocumented responses: 200, 400, 401, 403, 404, 429, 500, 502, 503." }, "response": [] }, { "name": "Get Uptime Check", "request": { "method": "GET", "header": [], "url": { "raw": "{{base_url}}/uptime_check", "host": [ "{{base_url}}" ], "path": [ "uptime_check" ], "query": [] }, "description": "Returns a lightweight API uptime response. Production currently returns 401 without credentials, so send the collection apikey header like other Enterprise API requests.\nLive Rails route inferred from config/routes.rb and Enterprise controller behavior; this endpoint is not currently present in docs/songstats_api_openapi.yaml.\n\nDocumented responses: 200, 300, 400, 401, 403, 429, 500." }, "response": [] } ] }, { "name": "Artists", "item": [ { "name": "Get Artist Info", "request": { "method": "GET", "header": [ { "key": "Accept-Encoding", "value": "{{accept_encoding}}", "description": "gzip, deflate, br", "type": "text" } ], "url": { "raw": "{{base_url}}/artists/info?songstats_artist_id={{songstats_artist_id}}", "host": [ "{{base_url}}" ], "path": [ "artists", "info" ], "query": [ { "key": "songstats_artist_id", "value": "{{songstats_artist_id}}", "description": "The Songstats ID of the artist being requested *" }, { "key": "spotify_artist_id", "value": "{{spotify_artist_id}}", "description": "The Spotify ID of the artist being requested *", "disabled": true }, { "key": "apple_music_artist_id", "value": "{{apple_music_artist_id}}", "description": "The Apple Music ID of the artist being requested *", "disabled": true } ] }, "description": "Returns metadata information of an artist.\nGenerated from docs/songstats_api_openapi.yaml.\n\nQuery parameters:\n- songstats_artist_id (optional): The Songstats ID of the artist being requested * Example: pod5zlug.\n- spotify_artist_id (optional): The Spotify ID of the artist being requested * Example: 28j8lBWDdDSHSSt5oPlsX2.\n- apple_music_artist_id (optional): The Apple Music ID of the artist being requested * Example: 261545033.\n\nHeaders:\n- Accept-Encoding: gzip, deflate, br\n\nDocumented responses: 200, 400, 401, 403, 404, 429, 500, 502, 503." }, "response": [] }, { "name": "Get Artist Activities", "request": { "method": "GET", "header": [ { "key": "Accept-Encoding", "value": "{{accept_encoding}}", "description": "gzip, deflate, br", "type": "text" } ], "url": { "raw": "{{base_url}}/artists/activities?source={{source}}&songstats_artist_id={{songstats_artist_id}}", "host": [ "{{base_url}}" ], "path": [ "artists", "activities" ], "query": [ { "key": "source", "value": "{{source}}", "description": "Specifies the sources that data is being requested for. Can be a comma separated list of individual sources or be set to 'all'." }, { "key": "songstats_artist_id", "value": "{{songstats_artist_id}}", "description": "The Songstats ID of the artist being requested *" }, { "key": "spotify_artist_id", "value": "{{spotify_artist_id}}", "description": "The Spotify ID of the artist being requested *", "disabled": true }, { "key": "apple_music_artist_id", "value": "{{apple_music_artist_id}}", "description": "The Apple Music ID of the artist being requested *", "disabled": true }, { "key": "limit", "value": "{{limit}}", "description": "Specifies the limit of results being returned.", "disabled": true }, { "key": "offset", "value": "{{offset}}", "description": "Specifies the offset of the limited results being returned.", "disabled": true }, { "key": "milestones", "value": "{{milestones}}", "description": "Include Milestone Activities.", "disabled": true }, { "key": "albums", "value": "{{albums}}", "description": "Include Album Activities.", "disabled": true }, { "key": "editorial", "value": "{{editorial}}", "description": "Only include Editorial Activities.", "disabled": true }, { "key": "recent", "value": "{{recent}}", "description": "Only include Activities for recent tracks (released in past 3 months).", "disabled": true }, { "key": "tier", "value": "{{tier}}", "description": "Filter Activities by importance. Tier 4 is the lowest tier that returns all activities. Tier 1 is the highest tier that returns only the most significant activities.", "disabled": true }, { "key": "comments", "value": "{{comments}}", "description": "Include Comment Activities.", "disabled": true } ] }, "description": "Returns the latest activities of an artist filtered by source.\nGenerated from docs/songstats_api_openapi.yaml.\n\nQuery parameters:\n- source (required): Specifies the sources that data is being requested for. Can be a comma separated list of individual sources or be set to 'all'. Example: spotify,apple_music,deezer.\n- songstats_artist_id (optional): The Songstats ID of the artist being requested * Example: pod5zlug.\n- spotify_artist_id (optional): The Spotify ID of the artist being requested * Example: 28j8lBWDdDSHSSt5oPlsX2.\n- apple_music_artist_id (optional): The Apple Music ID of the artist being requested * Example: 261545033.\n- limit (optional): Specifies the limit of results being returned. Example: 20.\n- offset (optional): Specifies the offset of the limited results being returned. Example: 20.\n- milestones (optional): Include Milestone Activities. Example: true.\n- albums (optional): Include Album Activities. Example: true.\n- editorial (optional): Only include Editorial Activities. Example: false.\n- recent (optional): Only include Activities for recent tracks (released in past 3 months). Example: false.\n- tier (optional): Filter Activities by importance. Tier 4 is the lowest tier that returns all activities. Tier 1 is the highest tier that returns only the most significant activities. Example: 4.\n- comments (optional): Include Comment Activities. Example: true.\n\nHeaders:\n- Accept-Encoding: gzip, deflate, br\n\nDocumented responses: 200, 400, 401, 403, 404, 429, 500, 502, 503." }, "response": [] }, { "name": "Get Artist Current Stats", "request": { "method": "GET", "header": [ { "key": "Accept-Encoding", "value": "{{accept_encoding}}", "description": "gzip, deflate, br", "type": "text" } ], "url": { "raw": "{{base_url}}/artists/stats?source={{source}}&songstats_artist_id={{songstats_artist_id}}", "host": [ "{{base_url}}" ], "path": [ "artists", "stats" ], "query": [ { "key": "source", "value": "{{source}}", "description": "Specifies the sources that data is being requested for. Can be a comma separated list of individual sources or be set to 'all'." }, { "key": "songstats_artist_id", "value": "{{songstats_artist_id}}", "description": "The Songstats ID of the artist being requested *" }, { "key": "spotify_artist_id", "value": "{{spotify_artist_id}}", "description": "The Spotify ID of the artist being requested *", "disabled": true }, { "key": "apple_music_artist_id", "value": "{{apple_music_artist_id}}", "description": "The Apple Music ID of the artist being requested *", "disabled": true } ] }, "description": "Returns summary and detailed information of an artist filtered by source.\nGenerated from docs/songstats_api_openapi.yaml.\n\nQuery parameters:\n- source (required): Specifies the sources that data is being requested for. Can be a comma separated list of individual sources or be set to 'all'. Example: spotify,apple_music,deezer.\n- songstats_artist_id (optional): The Songstats ID of the artist being requested * Example: pod5zlug.\n- spotify_artist_id (optional): The Spotify ID of the artist being requested * Example: 28j8lBWDdDSHSSt5oPlsX2.\n- apple_music_artist_id (optional): The Apple Music ID of the artist being requested * Example: 261545033.\n\nHeaders:\n- Accept-Encoding: gzip, deflate, br\n\nDocumented responses: 200, 400, 401, 403, 404, 429, 500, 502, 503." }, "response": [] }, { "name": "Get Artist Historic Stats", "request": { "method": "GET", "header": [ { "key": "Accept-Encoding", "value": "{{accept_encoding}}", "description": "gzip, deflate, br", "type": "text" } ], "url": { "raw": "{{base_url}}/artists/historic_stats?source={{source}}&songstats_artist_id={{songstats_artist_id}}", "host": [ "{{base_url}}" ], "path": [ "artists", "historic_stats" ], "query": [ { "key": "source", "value": "{{source}}", "description": "Specifies the sources that data is being requested for. Can be a comma separated list of individual sources or be set to 'all'." }, { "key": "songstats_artist_id", "value": "{{songstats_artist_id}}", "description": "The Songstats ID of the artist being requested *" }, { "key": "spotify_artist_id", "value": "{{spotify_artist_id}}", "description": "The Spotify ID of the artist being requested *", "disabled": true }, { "key": "apple_music_artist_id", "value": "{{apple_music_artist_id}}", "description": "The Apple Music ID of the artist being requested *", "disabled": true }, { "key": "start_date", "value": "{{start_date}}", "description": "Specifies the start_date of the historic data that is being requested.", "disabled": true }, { "key": "end_date", "value": "{{end_date}}", "description": "Specifies the end_date of the historic data that is being requested.", "disabled": true }, { "key": "with_aggregates", "value": "{{with_aggregates}}", "description": "Includes data points aggregated by Songstats like playlists_current, playlists_reach_current, charts_current, etc.", "disabled": true } ] }, "description": "Returns historic information of an artist filtered by source.\nGenerated from docs/songstats_api_openapi.yaml.\n\nQuery parameters:\n- source (required): Specifies the sources that data is being requested for. Can be a comma separated list of individual sources or be set to 'all'. Example: spotify,apple_music,deezer.\n- songstats_artist_id (optional): The Songstats ID of the artist being requested * Example: pod5zlug.\n- spotify_artist_id (optional): The Spotify ID of the artist being requested * Example: 28j8lBWDdDSHSSt5oPlsX2.\n- apple_music_artist_id (optional): The Apple Music ID of the artist being requested * Example: 261545033.\n- start_date (optional): Specifies the start_date of the historic data that is being requested. Example: 2021-12-31.\n- end_date (optional): Specifies the end_date of the historic data that is being requested. Example: 2022-01-16.\n- with_aggregates (optional): Includes data points aggregated by Songstats like playlists_current, playlists_reach_current, charts_current, etc. Example: true.\n\nHeaders:\n- Accept-Encoding: gzip, deflate, br\n\nDocumented responses: 200, 400, 401, 403, 404, 429, 500, 502, 503." }, "response": [] }, { "name": "Get Artist Audience", "request": { "method": "GET", "header": [ { "key": "Accept-Encoding", "value": "{{accept_encoding}}", "description": "gzip, deflate, br", "type": "text" } ], "url": { "raw": "{{base_url}}/artists/audience?source={{source}}&songstats_artist_id={{songstats_artist_id}}", "host": [ "{{base_url}}" ], "path": [ "artists", "audience" ], "query": [ { "key": "source", "value": "{{source}}", "description": "Specifies the sources that data is being requested for. Can be a comma separated list of individual sources or be set to 'all'." }, { "key": "songstats_artist_id", "value": "{{songstats_artist_id}}", "description": "The Songstats ID of the artist being requested *" }, { "key": "spotify_artist_id", "value": "{{spotify_artist_id}}", "description": "The Spotify ID of the artist being requested *", "disabled": true }, { "key": "apple_music_artist_id", "value": "{{apple_music_artist_id}}", "description": "The Apple Music ID of the artist being requested *", "disabled": true } ] }, "description": "Returns audience information of an artist filtered by source.\nGenerated from docs/songstats_api_openapi.yaml.\n\nQuery parameters:\n- source (required): Specifies the sources that data is being requested for. Can be a comma separated list of individual sources or be set to 'all'. Example: spotify,apple_music,deezer.\n- songstats_artist_id (optional): The Songstats ID of the artist being requested * Example: pod5zlug.\n- spotify_artist_id (optional): The Spotify ID of the artist being requested * Example: 28j8lBWDdDSHSSt5oPlsX2.\n- apple_music_artist_id (optional): The Apple Music ID of the artist being requested * Example: 261545033.\n\nHeaders:\n- Accept-Encoding: gzip, deflate, br\n\nDocumented responses: 200, 400, 401, 403, 404, 429, 500, 502, 503." }, "response": [] }, { "name": "Get Artist Audience Details", "request": { "method": "GET", "header": [ { "key": "Accept-Encoding", "value": "{{accept_encoding}}", "description": "gzip, deflate, br", "type": "text" } ], "url": { "raw": "{{base_url}}/artists/audience/details?source={{source}}&songstats_artist_id={{songstats_artist_id}}&country_code={{country_code}}", "host": [ "{{base_url}}" ], "path": [ "artists", "audience", "details" ], "query": [ { "key": "source", "value": "{{source}}", "description": "Specifies the sources that data is being requested for. Can be a comma separated list of individual sources or be set to 'all'." }, { "key": "songstats_artist_id", "value": "{{songstats_artist_id}}", "description": "The Songstats ID of the artist being requested *" }, { "key": "spotify_artist_id", "value": "{{spotify_artist_id}}", "description": "The Spotify ID of the artist being requested *", "disabled": true }, { "key": "apple_music_artist_id", "value": "{{apple_music_artist_id}}", "description": "The Apple Music ID of the artist being requested *", "disabled": true }, { "key": "country_code", "value": "{{country_code}}", "description": "A two-letter country code" } ] }, "description": "Returns detailed audience information of an artist for a specific country filtered by source.\nGenerated from docs/songstats_api_openapi.yaml.\n\nQuery parameters:\n- source (required): Specifies the sources that data is being requested for. Can be a comma separated list of individual sources or be set to 'all'. Example: spotify,apple_music,deezer.\n- songstats_artist_id (optional): The Songstats ID of the artist being requested * Example: pod5zlug.\n- spotify_artist_id (optional): The Spotify ID of the artist being requested * Example: 28j8lBWDdDSHSSt5oPlsX2.\n- apple_music_artist_id (optional): The Apple Music ID of the artist being requested * Example: 261545033.\n- country_code (required): A two-letter country code Example: US.\n\nHeaders:\n- Accept-Encoding: gzip, deflate, br\n\nDocumented responses: 200, 400, 401, 403, 404, 429, 500, 502, 503." }, "response": [] }, { "name": "Get Artist Catalog", "request": { "method": "GET", "header": [ { "key": "Accept-Encoding", "value": "{{accept_encoding}}", "description": "gzip, deflate, br", "type": "text" } ], "url": { "raw": "{{base_url}}/artists/catalog?songstats_artist_id={{songstats_artist_id}}", "host": [ "{{base_url}}" ], "path": [ "artists", "catalog" ], "query": [ { "key": "songstats_artist_id", "value": "{{songstats_artist_id}}", "description": "The Songstats ID of the artist being requested *" }, { "key": "spotify_artist_id", "value": "{{spotify_artist_id}}", "description": "The Spotify ID of the artist being requested *", "disabled": true }, { "key": "apple_music_artist_id", "value": "{{apple_music_artist_id}}", "description": "The Apple Music ID of the artist being requested *", "disabled": true }, { "key": "limit", "value": "{{limit}}", "description": "Specifies the limit of results being returned.", "disabled": true }, { "key": "offset", "value": "{{offset}}", "description": "Specifies the offset of the limited results being returned.", "disabled": true }, { "key": "with_links", "value": "{{with_links}}", "description": "Includes an array of all of the source links associated with the requested objected.", "disabled": true } ] }, "description": "Returns the track catalog of an artist ordered by release date.\nGenerated from docs/songstats_api_openapi.yaml.\n\nQuery parameters:\n- songstats_artist_id (optional): The Songstats ID of the artist being requested * Example: pod5zlug.\n- spotify_artist_id (optional): The Spotify ID of the artist being requested * Example: 28j8lBWDdDSHSSt5oPlsX2.\n- apple_music_artist_id (optional): The Apple Music ID of the artist being requested * Example: 261545033.\n- limit (optional): Specifies the limit of results being returned. Example: 20.\n- offset (optional): Specifies the offset of the limited results being returned. Example: 20.\n- with_links (optional): Includes an array of all of the source links associated with the requested objected. Example: true.\n\nHeaders:\n- Accept-Encoding: gzip, deflate, br\n\nDocumented responses: 200, 400, 401, 403, 404, 429, 500, 502, 503." }, "response": [] }, { "name": "Get Artist Top Tracks", "request": { "method": "GET", "header": [ { "key": "Accept-Encoding", "value": "{{accept_encoding}}", "description": "gzip, deflate, br", "type": "text" } ], "url": { "raw": "{{base_url}}/artists/top_tracks?source={{source}}&songstats_artist_id={{songstats_artist_id}}&metric={{metric}}&scope={{scope}}", "host": [ "{{base_url}}" ], "path": [ "artists", "top_tracks" ], "query": [ { "key": "source", "value": "{{source}}", "description": "Specifies the sources that data is being requested for. Can be a comma separated list of individual sources or be set to 'all'." }, { "key": "songstats_artist_id", "value": "{{songstats_artist_id}}", "description": "The Songstats ID of the artist being requested *" }, { "key": "spotify_artist_id", "value": "{{spotify_artist_id}}", "description": "The Spotify ID of the artist being requested *", "disabled": true }, { "key": "apple_music_artist_id", "value": "{{apple_music_artist_id}}", "description": "The Apple Music ID of the artist being requested *", "disabled": true }, { "key": "limit", "value": "{{limit}}", "description": "Specifies the limit of results being returned.", "disabled": true }, { "key": "metric", "value": "{{metric}}", "description": "The metric to sort the top results by." }, { "key": "scope", "value": "{{scope}}", "description": "The time scope for the returned top results." } ] }, "description": "Returns the top tracks of an artist sorted rank type.\nGenerated from docs/songstats_api_openapi.yaml.\n\nQuery parameters:\n- source (required): Specifies the sources that data is being requested for. Can be a comma separated list of individual sources or be set to 'all'. Example: spotify,apple_music,deezer.\n- songstats_artist_id (optional): The Songstats ID of the artist being requested * Example: pod5zlug.\n- spotify_artist_id (optional): The Spotify ID of the artist being requested * Example: 28j8lBWDdDSHSSt5oPlsX2.\n- apple_music_artist_id (optional): The Apple Music ID of the artist being requested * Example: 261545033.\n- limit (optional): Specifies the limit of results being returned. Example: 20.\n- metric (required): The metric to sort the top results by. Example: playlists.\n- scope (required): The time scope for the returned top results. Example: total.\n\nHeaders:\n- Accept-Encoding: gzip, deflate, br\n\nDocumented responses: 200, 400, 401, 403, 404, 429, 500, 502, 503." }, "response": [] }, { "name": "Get Artist Top Playlists", "request": { "method": "GET", "header": [ { "key": "Accept-Encoding", "value": "{{accept_encoding}}", "description": "gzip, deflate, br", "type": "text" } ], "url": { "raw": "{{base_url}}/artists/top_playlists?songstats_artist_id={{songstats_artist_id}}&scope={{scope}}&source={{source}}", "host": [ "{{base_url}}" ], "path": [ "artists", "top_playlists" ], "query": [ { "key": "songstats_artist_id", "value": "{{songstats_artist_id}}", "description": "The Songstats ID of the artist being requested *" }, { "key": "spotify_artist_id", "value": "{{spotify_artist_id}}", "description": "The Spotify ID of the artist being requested *", "disabled": true }, { "key": "apple_music_artist_id", "value": "{{apple_music_artist_id}}", "description": "The Apple Music ID of the artist being requested *", "disabled": true }, { "key": "scope", "value": "{{scope}}", "description": "The time scope for the returned top results." }, { "key": "source", "value": "{{source}}", "description": "Specifies the sources that data is being requested for. Can be a comma separated list of individual sources or be set to 'all'." }, { "key": "limit", "value": "{{limit}}", "description": "Specifies the limit of results being returned.", "disabled": true } ] }, "description": "Returns the top playlists of an artist.\nGenerated from docs/songstats_api_openapi.yaml.\n\nQuery parameters:\n- songstats_artist_id (optional): The Songstats ID of the artist being requested * Example: pod5zlug.\n- spotify_artist_id (optional): The Spotify ID of the artist being requested * Example: 28j8lBWDdDSHSSt5oPlsX2.\n- apple_music_artist_id (optional): The Apple Music ID of the artist being requested * Example: 261545033.\n- scope (required): The time scope for the returned top results. Example: total.\n- source (required): Specifies the sources that data is being requested for. Can be a comma separated list of individual sources or be set to 'all'. Example: spotify,apple_music,deezer.\n- limit (optional): Specifies the limit of results being returned. Example: 20.\n\nHeaders:\n- Accept-Encoding: gzip, deflate, br\n\nDocumented responses: 200, 400, 401, 403, 404, 429, 500, 502, 503." }, "response": [] }, { "name": "Get Artist Top Curators", "request": { "method": "GET", "header": [ { "key": "Accept-Encoding", "value": "{{accept_encoding}}", "description": "gzip, deflate, br", "type": "text" } ], "url": { "raw": "{{base_url}}/artists/top_curators?songstats_artist_id={{songstats_artist_id}}&scope={{scope}}&source={{source}}", "host": [ "{{base_url}}" ], "path": [ "artists", "top_curators" ], "query": [ { "key": "songstats_artist_id", "value": "{{songstats_artist_id}}", "description": "The Songstats ID of the artist being requested *" }, { "key": "spotify_artist_id", "value": "{{spotify_artist_id}}", "description": "The Spotify ID of the artist being requested *", "disabled": true }, { "key": "apple_music_artist_id", "value": "{{apple_music_artist_id}}", "description": "The Apple Music ID of the artist being requested *", "disabled": true }, { "key": "scope", "value": "{{scope}}", "description": "The time scope for the returned top results." }, { "key": "source", "value": "{{source}}", "description": "Specifies the sources that data is being requested for. Can be a comma separated list of individual sources or be set to 'all'." }, { "key": "limit", "value": "{{limit}}", "description": "Specifies the limit of results being returned.", "disabled": true } ] }, "description": "Returns the top curators supporting an artist.\nGenerated from docs/songstats_api_openapi.yaml.\n\nQuery parameters:\n- songstats_artist_id (optional): The Songstats ID of the artist being requested * Example: pod5zlug.\n- spotify_artist_id (optional): The Spotify ID of the artist being requested * Example: 28j8lBWDdDSHSSt5oPlsX2.\n- apple_music_artist_id (optional): The Apple Music ID of the artist being requested * Example: 261545033.\n- scope (required): The time scope for the returned top results. Example: total.\n- source (required): Specifies the sources that data is being requested for. Can be a comma separated list of individual sources or be set to 'all'. Example: spotify,apple_music,deezer.\n- limit (optional): Specifies the limit of results being returned. Example: 20.\n\nHeaders:\n- Accept-Encoding: gzip, deflate, br\n\nDocumented responses: 200, 400, 401, 403, 404, 429, 500, 502, 503." }, "response": [] }, { "name": "Get Artist Top Commentors", "request": { "method": "GET", "header": [ { "key": "Accept-Encoding", "value": "{{accept_encoding}}", "description": "gzip, deflate, br", "type": "text" } ], "url": { "raw": "{{base_url}}/artists/top_commentors?songstats_artist_id={{songstats_artist_id}}&scope={{scope}}&source={{source}}", "host": [ "{{base_url}}" ], "path": [ "artists", "top_commentors" ], "query": [ { "key": "songstats_artist_id", "value": "{{songstats_artist_id}}", "description": "The Songstats ID of the artist being requested *" }, { "key": "spotify_artist_id", "value": "{{spotify_artist_id}}", "description": "The Spotify ID of the artist being requested *", "disabled": true }, { "key": "apple_music_artist_id", "value": "{{apple_music_artist_id}}", "description": "The Apple Music ID of the artist being requested *", "disabled": true }, { "key": "scope", "value": "{{scope}}", "description": "The time scope for the returned top results." }, { "key": "source", "value": "{{source}}", "description": "Specifies the sources that data is being requested for. Can be a comma separated list of individual sources or be set to 'all'." }, { "key": "limit", "value": "{{limit}}", "description": "Specifies the limit of results being returned.", "disabled": true } ] }, "description": "Returns the top commentors supporting an artist.\nGenerated from docs/songstats_api_openapi.yaml.\n\nQuery parameters:\n- songstats_artist_id (optional): The Songstats ID of the artist being requested * Example: pod5zlug.\n- spotify_artist_id (optional): The Spotify ID of the artist being requested * Example: 28j8lBWDdDSHSSt5oPlsX2.\n- apple_music_artist_id (optional): The Apple Music ID of the artist being requested * Example: 261545033.\n- scope (required): The time scope for the returned top results. Example: total.\n- source (required): Specifies the sources that data is being requested for. Can be a comma separated list of individual sources or be set to 'all'. Example: youtube,soundcloud.\n- limit (optional): Specifies the limit of results being returned. Example: 20.\n\nHeaders:\n- Accept-Encoding: gzip, deflate, br\n\nDocumented responses: 200, 400, 401, 403, 404, 429, 500, 502, 503." }, "response": [] }, { "name": "Get Artist Songshare", "request": { "method": "GET", "header": [ { "key": "Accept-Encoding", "value": "{{accept_encoding}}", "description": "gzip, deflate, br", "type": "text" } ], "url": { "raw": "{{base_url}}/artists/songshare?songstats_artist_id={{songstats_artist_id}}", "host": [ "{{base_url}}" ], "path": [ "artists", "songshare" ], "query": [ { "key": "songstats_artist_id", "value": "{{songstats_artist_id}}", "description": "The Songstats ID of the artist being requested *" }, { "key": "spotify_artist_id", "value": "{{spotify_artist_id}}", "description": "The Spotify ID of the artist being requested *", "disabled": true }, { "key": "apple_music_artist_id", "value": "{{apple_music_artist_id}}", "description": "The Apple Music ID of the artist being requested *", "disabled": true } ] }, "description": "Returns Songshare smart link information of an artist.\nGenerated from docs/songstats_api_openapi.yaml.\n\nQuery parameters:\n- songstats_artist_id (optional): The Songstats ID of the artist being requested * Example: pod5zlug.\n- spotify_artist_id (optional): The Spotify ID of the artist being requested * Example: 28j8lBWDdDSHSSt5oPlsX2.\n- apple_music_artist_id (optional): The Apple Music ID of the artist being requested * Example: 261545033.\n\nHeaders:\n- Accept-Encoding: gzip, deflate, br\n\nDocumented responses: 200, 400, 401, 403, 404, 429, 500, 502, 503." }, "response": [] }, { "name": "Search Artist", "request": { "method": "GET", "header": [ { "key": "Accept-Encoding", "value": "{{accept_encoding}}", "description": "gzip, deflate, br", "type": "text" } ], "url": { "raw": "{{base_url}}/artists/search?q={{search_query}}", "host": [ "{{base_url}}" ], "path": [ "artists", "search" ], "query": [ { "key": "q", "value": "{{search_query}}", "description": "Search Query" }, { "key": "limit", "value": "{{limit}}", "description": "Specifies the limit of results being returned.", "disabled": true }, { "key": "offset", "value": "{{offset}}", "description": "Specifies the offset of the limited results being returned.", "disabled": true } ] }, "description": "Search for an artist.\nGenerated from docs/songstats_api_openapi.yaml.\n\nQuery parameters:\n- q (required): Search Query\n- limit (optional): Specifies the limit of results being returned. Example: 20.\n- offset (optional): Specifies the offset of the limited results being returned. Example: 20.\n\nHeaders:\n- Accept-Encoding: gzip, deflate, br\n\nDocumented responses: 200, 400, 401, 403, 404, 429, 500, 502, 503." }, "response": [] }, { "name": "Add Artist Link", "request": { "method": "POST", "header": [ { "key": "Accept-Encoding", "value": "{{accept_encoding}}", "description": "gzip, deflate, br", "type": "text" } ], "url": { "raw": "{{base_url}}/artists/link_request?songstats_artist_id={{songstats_artist_id}}&link={{source_link}}", "host": [ "{{base_url}}" ], "path": [ "artists", "link_request" ], "query": [ { "key": "songstats_artist_id", "value": "{{songstats_artist_id}}", "description": "The Songstats ID of the artist being requested *" }, { "key": "spotify_artist_id", "value": "{{spotify_artist_id}}", "description": "The Spotify ID of the artist being requested *", "disabled": true }, { "key": "apple_music_artist_id", "value": "{{apple_music_artist_id}}", "description": "The Apple Music ID of the artist being requested *", "disabled": true }, { "key": "link", "value": "{{source_link}}", "description": "Link to be added." } ] }, "description": "Request for link to be added to an artist.\nGenerated from docs/songstats_api_openapi.yaml.\n\nQuery parameters:\n- songstats_artist_id (optional): The Songstats ID of the artist being requested * Example: pod5zlug.\n- spotify_artist_id (optional): The Spotify ID of the artist being requested * Example: 28j8lBWDdDSHSSt5oPlsX2.\n- apple_music_artist_id (optional): The Apple Music ID of the artist being requested * Example: 261545033.\n- link (required): Link to be added. Example: https://soundcloud.com/dontblink/vibration.\n\nHeaders:\n- Accept-Encoding: gzip, deflate, br\n\nDocumented responses: 200, 400, 401, 403, 404, 429, 500, 502, 503." }, "response": [] }, { "name": "Remove Artist Link", "request": { "method": "DELETE", "header": [], "url": { "raw": "{{base_url}}/artists/link_request?songstats_artist_id={{songstats_artist_id}}&link={{source_link}}", "host": [ "{{base_url}}" ], "path": [ "artists", "link_request" ], "query": [ { "key": "songstats_artist_id", "value": "{{songstats_artist_id}}", "description": "The Songstats ID of the artist being requested *" }, { "key": "spotify_artist_id", "value": "{{spotify_artist_id}}", "description": "The Spotify ID of the artist being requested *", "disabled": true }, { "key": "apple_music_artist_id", "value": "{{apple_music_artist_id}}", "description": "The Apple Music ID of the artist being requested *", "disabled": true }, { "key": "link", "value": "{{source_link}}", "description": "Link to be deleted." } ] }, "description": "Request for link to be removed from an artist.\nGenerated from docs/songstats_api_openapi.yaml.\n\nQuery parameters:\n- songstats_artist_id (optional): The Songstats ID of the artist being requested * Example: pod5zlug.\n- spotify_artist_id (optional): The Spotify ID of the artist being requested * Example: 28j8lBWDdDSHSSt5oPlsX2.\n- apple_music_artist_id (optional): The Apple Music ID of the artist being requested * Example: 261545033.\n- link (required): Link to be deleted. Example: https://soundcloud.com/dontblink/vibration.\n\nDocumented responses: 200, 400, 401, 403, 404, 429, 500, 502, 503." }, "response": [] }, { "name": "Add Artist Track", "request": { "method": "POST", "header": [ { "key": "Accept-Encoding", "value": "{{accept_encoding}}", "description": "gzip, deflate, br", "type": "text" } ], "url": { "raw": "{{base_url}}/artists/track_request?songstats_artist_id={{songstats_artist_id}}&spotify_track_id={{spotify_track_id}}", "host": [ "{{base_url}}" ], "path": [ "artists", "track_request" ], "query": [ { "key": "songstats_artist_id", "value": "{{songstats_artist_id}}", "description": "The Songstats ID of the artist being requested *" }, { "key": "spotify_artist_id", "value": "{{spotify_artist_id}}", "description": "The Spotify ID of the artist being requested *", "disabled": true }, { "key": "apple_music_artist_id", "value": "{{apple_music_artist_id}}", "description": "The Apple Music ID of the artist being requested *", "disabled": true }, { "key": "link", "value": "{{track_link}}", "description": "Link to the track to be added from Spotify, Apple Music, Amazon, Deezer, 1001Tracklists, Beatport, Traxsource or TIDAL.", "disabled": true }, { "key": "isrc", "value": "{{isrc}}", "description": "ISRC of the track to be added.", "disabled": true }, { "key": "spotify_track_id", "value": "{{spotify_track_id}}", "description": "Spotify ID of the track to be added." } ] }, "description": "Request for track to be added to an artist catalog.\nGenerated from docs/songstats_api_openapi.yaml.\n\nQuery parameters:\n- songstats_artist_id (optional): The Songstats ID of the artist being requested * Example: pod5zlug.\n- spotify_artist_id (optional): The Spotify ID of the artist being requested * Example: 28j8lBWDdDSHSSt5oPlsX2.\n- apple_music_artist_id (optional): The Apple Music ID of the artist being requested * Example: 261545033.\n- link (optional): Link to the track to be added from Spotify, Apple Music, Amazon, Deezer, 1001Tracklists, Beatport, Traxsource or TIDAL. Example: https://music.apple.com/us/album/smalltown-boy/1743410570?i=1743410576.\n- isrc (optional): ISRC of the track to be added. Example: UKKGA2000013.\n- spotify_track_id (optional): Spotify ID of the track to be added. Example: 3yYqfGNpGlIyZJvWEcXgnF.\n\nHeaders:\n- Accept-Encoding: gzip, deflate, br\n\nDocumented responses: 200, 400, 401, 403, 404, 429, 500, 502, 503." }, "response": [] }, { "name": "Remove Artist Track", "request": { "method": "DELETE", "header": [], "url": { "raw": "{{base_url}}/artists/track_request?songstats_artist_id={{songstats_artist_id}}&songstats_track_id={{songstats_track_id}}", "host": [ "{{base_url}}" ], "path": [ "artists", "track_request" ], "query": [ { "key": "songstats_artist_id", "value": "{{songstats_artist_id}}", "description": "The Songstats ID of the artist being requested *" }, { "key": "spotify_artist_id", "value": "{{spotify_artist_id}}", "description": "The Spotify ID of the artist being requested *", "disabled": true }, { "key": "apple_music_artist_id", "value": "{{apple_music_artist_id}}", "description": "The Apple Music ID of the artist being requested *", "disabled": true }, { "key": "spotify_track_id", "value": "{{spotify_track_id}}", "description": "Spotify ID of the track to be removed.", "disabled": true }, { "key": "songstats_track_id", "value": "{{songstats_track_id}}", "description": "Songstats ID of the track to be removed." } ] }, "description": "Request for track to be removed from an artist catalog.\nGenerated from docs/songstats_api_openapi.yaml.\n\nQuery parameters:\n- songstats_artist_id (optional): The Songstats ID of the artist being requested * Example: pod5zlug.\n- spotify_artist_id (optional): The Spotify ID of the artist being requested * Example: 28j8lBWDdDSHSSt5oPlsX2.\n- apple_music_artist_id (optional): The Apple Music ID of the artist being requested * Example: 261545033.\n- spotify_track_id (optional): Spotify ID of the track to be removed. Example: 4wAQSi076CxYXc0y37IRRH.\n- songstats_track_id (optional): Songstats ID of the track to be removed. Example: sv1aqxtp.\n\nDocumented responses: 200, 400, 401, 403, 404, 429, 500, 502, 503." }, "response": [] }, { "name": "Add Artist To Member Relevant List", "request": { "method": "POST", "header": [], "url": { "raw": "{{base_url}}/artists/add_to_member_relevant_list?songstats_artist_id={{songstats_artist_id}}", "host": [ "{{base_url}}" ], "path": [ "artists", "add_to_member_relevant_list" ], "query": [ { "key": "songstats_artist_id", "value": "{{songstats_artist_id}}", "description": "Songstats artist ID." } ] }, "description": "Adds the requested artist source object to the Enterprise member relevant list.\nLive Rails route inferred from config/routes.rb and Enterprise controller behavior; this endpoint is not currently present in docs/songstats_api_openapi.yaml.\n\nQuery parameters:\n- songstats_artist_id (required): Songstats artist ID. Example: pod5zlug.\n\nDocumented responses: 200, 300, 400, 401, 403, 429, 500." }, "response": [] }, { "name": "Remove Artist From Member Relevant List", "request": { "method": "DELETE", "header": [], "url": { "raw": "{{base_url}}/artists/remove_from_member_relevant_list?songstats_artist_id={{songstats_artist_id}}", "host": [ "{{base_url}}" ], "path": [ "artists", "remove_from_member_relevant_list" ], "query": [ { "key": "songstats_artist_id", "value": "{{songstats_artist_id}}", "description": "Songstats artist ID." } ] }, "description": "Removes the requested artist source objects from the Enterprise member relevant list.\nLive Rails route inferred from config/routes.rb and Enterprise controller behavior; this endpoint is not currently present in docs/songstats_api_openapi.yaml.\n\nQuery parameters:\n- songstats_artist_id (required): Songstats artist ID. Example: pod5zlug.\n\nDocumented responses: 200, 300, 400, 401, 403, 429, 500." }, "response": [] } ] }, { "name": "Collaborators", "item": [ { "name": "Get Collaborator Info", "request": { "method": "GET", "header": [ { "key": "Accept-Encoding", "value": "{{accept_encoding}}", "description": "gzip, deflate, br", "type": "text" } ], "url": { "raw": "{{base_url}}/collaborators/info?songstats_collaborator_id={{songstats_collaborator_id}}", "host": [ "{{base_url}}" ], "path": [ "collaborators", "info" ], "query": [ { "key": "songstats_collaborator_id", "value": "{{songstats_collaborator_id}}", "description": "The Songstats ID of the collaborator being requested *" }, { "key": "tidal_artist_id", "value": "{{tidal_artist_id}}", "description": "The TIDAL ID of the collaborator being requested *", "disabled": true } ] }, "description": "Returns Songshare smart link information of a collaborator.\nGenerated from docs/songstats_api_openapi.yaml.\n\nQuery parameters:\n- songstats_collaborator_id (optional): The Songstats ID of the collaborator being requested * Example: vkwh40ql.\n- tidal_artist_id (optional): The TIDAL ID of the collaborator being requested * Example: 49475872.\n\nHeaders:\n- Accept-Encoding: gzip, deflate, br\n\nDocumented responses: 200, 400, 401, 403, 404, 429, 500, 502, 503." }, "response": [] }, { "name": "Get Collaborator Activities", "request": { "method": "GET", "header": [ { "key": "Accept-Encoding", "value": "{{accept_encoding}}", "description": "gzip, deflate, br", "type": "text" } ], "url": { "raw": "{{base_url}}/collaborators/activities?source={{source}}&songstats_collaborator_id={{songstats_collaborator_id}}", "host": [ "{{base_url}}" ], "path": [ "collaborators", "activities" ], "query": [ { "key": "source", "value": "{{source}}", "description": "Specifies the sources that data is being requested for. Can be a comma separated list of individual sources or be set to 'all'." }, { "key": "songstats_collaborator_id", "value": "{{songstats_collaborator_id}}", "description": "The Songstats ID of the collaborator being requested *" }, { "key": "tidal_artist_id", "value": "{{tidal_artist_id}}", "description": "The TIDAL ID of the collaborator being requested *", "disabled": true }, { "key": "limit", "value": "{{limit}}", "description": "Specifies the limit of results being returned.", "disabled": true }, { "key": "offset", "value": "{{offset}}", "description": "Specifies the offset of the limited results being returned.", "disabled": true }, { "key": "milestones", "value": "{{milestones}}", "description": "Include Milestone Activities.", "disabled": true }, { "key": "albums", "value": "{{albums}}", "description": "Include Album Activities.", "disabled": true }, { "key": "editorial", "value": "{{editorial}}", "description": "Only include Editorial Activities.", "disabled": true }, { "key": "recent", "value": "{{recent}}", "description": "Only include Activities for recent tracks (released in past 3 months).", "disabled": true }, { "key": "tier", "value": "{{tier}}", "description": "Filter Activities by importance. Tier 4 is the lowest tier that returns all activities. Tier 1 is the highest tier that returns only the most significant activities.", "disabled": true }, { "key": "comments", "value": "{{comments}}", "description": "Include Comment Activities.", "disabled": true } ] }, "description": "Returns the latest activities of a collaborator filtered by source.\nGenerated from docs/songstats_api_openapi.yaml.\n\nQuery parameters:\n- source (required): Specifies the sources that data is being requested for. Can be a comma separated list of individual sources or be set to 'all'. Example: spotify,apple_music,deezer.\n- songstats_collaborator_id (optional): The Songstats ID of the collaborator being requested * Example: vkwh40ql.\n- tidal_artist_id (optional): The TIDAL ID of the collaborator being requested * Example: 49475872.\n- limit (optional): Specifies the limit of results being returned. Example: 20.\n- offset (optional): Specifies the offset of the limited results being returned. Example: 20.\n- milestones (optional): Include Milestone Activities. Example: true.\n- albums (optional): Include Album Activities. Example: true.\n- editorial (optional): Only include Editorial Activities. Example: false.\n- recent (optional): Only include Activities for recent tracks (released in past 3 months). Example: false.\n- tier (optional): Filter Activities by importance. Tier 4 is the lowest tier that returns all activities. Tier 1 is the highest tier that returns only the most significant activities. Example: 4.\n- comments (optional): Include Comment Activities. Example: true.\n\nHeaders:\n- Accept-Encoding: gzip, deflate, br\n\nDocumented responses: 200, 400, 401, 403, 404, 429, 500, 502, 503." }, "response": [] }, { "name": "Get Collaborator Current Stats", "request": { "method": "GET", "header": [ { "key": "Accept-Encoding", "value": "{{accept_encoding}}", "description": "gzip, deflate, br", "type": "text" } ], "url": { "raw": "{{base_url}}/collaborators/stats?source={{source}}&songstats_collaborator_id={{songstats_collaborator_id}}", "host": [ "{{base_url}}" ], "path": [ "collaborators", "stats" ], "query": [ { "key": "source", "value": "{{source}}", "description": "Specifies the sources that data is being requested for. Can be a comma separated list of individual sources or be set to 'all'." }, { "key": "songstats_collaborator_id", "value": "{{songstats_collaborator_id}}", "description": "The Songstats ID of the collaborator being requested *" }, { "key": "tidal_artist_id", "value": "{{tidal_artist_id}}", "description": "The TIDAL ID of the collaborator being requested *", "disabled": true } ] }, "description": "Returns summary and detailed information of a collaborator filtered by source.\nGenerated from docs/songstats_api_openapi.yaml.\n\nQuery parameters:\n- source (required): Specifies the sources that data is being requested for. Can be a comma separated list of individual sources or be set to 'all'. Example: spotify,apple_music,deezer.\n- songstats_collaborator_id (optional): The Songstats ID of the collaborator being requested * Example: vkwh40ql.\n- tidal_artist_id (optional): The TIDAL ID of the collaborator being requested * Example: 49475872.\n\nHeaders:\n- Accept-Encoding: gzip, deflate, br\n\nDocumented responses: 200, 400, 401, 403, 404, 429, 500, 502, 503." }, "response": [] }, { "name": "Get Collaborator Historic Stats", "request": { "method": "GET", "header": [ { "key": "Accept-Encoding", "value": "{{accept_encoding}}", "description": "gzip, deflate, br", "type": "text" } ], "url": { "raw": "{{base_url}}/collaborators/historic_stats?source={{source}}&songstats_collaborator_id={{songstats_collaborator_id}}", "host": [ "{{base_url}}" ], "path": [ "collaborators", "historic_stats" ], "query": [ { "key": "source", "value": "{{source}}", "description": "Specifies the sources that data is being requested for. Can be a comma separated list of individual sources or be set to 'all'." }, { "key": "songstats_collaborator_id", "value": "{{songstats_collaborator_id}}", "description": "The Songstats ID of the collaborator being requested *" }, { "key": "tidal_artist_id", "value": "{{tidal_artist_id}}", "description": "The TIDAL ID of the collaborator being requested *", "disabled": true }, { "key": "start_date", "value": "{{start_date}}", "description": "Specifies the start_date of the historic data that is being requested.", "disabled": true }, { "key": "end_date", "value": "{{end_date}}", "description": "Specifies the end_date of the historic data that is being requested.", "disabled": true }, { "key": "with_aggregates", "value": "{{with_aggregates}}", "description": "Includes data points aggregated by Songstats like playlists_current, playlists_reach_current, charts_current, etc.", "disabled": true } ] }, "description": "Returns historic information of a collaborator filtered by source.\nGenerated from docs/songstats_api_openapi.yaml.\n\nQuery parameters:\n- source (required): Specifies the sources that data is being requested for. Can be a comma separated list of individual sources or be set to 'all'. Example: spotify,apple_music,deezer.\n- songstats_collaborator_id (optional): The Songstats ID of the collaborator being requested * Example: vkwh40ql.\n- tidal_artist_id (optional): The TIDAL ID of the collaborator being requested * Example: 49475872.\n- start_date (optional): Specifies the start_date of the historic data that is being requested. Example: 2021-12-31.\n- end_date (optional): Specifies the end_date of the historic data that is being requested. Example: 2022-01-16.\n- with_aggregates (optional): Includes data points aggregated by Songstats like playlists_current, playlists_reach_current, charts_current, etc. Example: true.\n\nHeaders:\n- Accept-Encoding: gzip, deflate, br\n\nDocumented responses: 200, 400, 401, 403, 404, 429, 500, 502, 503." }, "response": [] }, { "name": "Get Collaborator Audience", "request": { "method": "GET", "header": [ { "key": "Accept-Encoding", "value": "{{accept_encoding}}", "description": "gzip, deflate, br", "type": "text" } ], "url": { "raw": "{{base_url}}/collaborators/audience?source={{source}}&songstats_collaborator_id={{songstats_collaborator_id}}", "host": [ "{{base_url}}" ], "path": [ "collaborators", "audience" ], "query": [ { "key": "source", "value": "{{source}}", "description": "Specifies the sources that data is being requested for. Can be a comma separated list of individual sources or be set to 'all'." }, { "key": "songstats_collaborator_id", "value": "{{songstats_collaborator_id}}", "description": "The Songstats ID of the collaborator being requested *" }, { "key": "tidal_artist_id", "value": "{{tidal_artist_id}}", "description": "The TIDAL ID of the collaborator being requested *", "disabled": true } ] }, "description": "Returns audience information of a collaborator filtered by source.\nGenerated from docs/songstats_api_openapi.yaml.\n\nQuery parameters:\n- source (required): Specifies the sources that data is being requested for. Can be a comma separated list of individual sources or be set to 'all'. Example: spotify,apple_music,deezer.\n- songstats_collaborator_id (optional): The Songstats ID of the collaborator being requested * Example: vkwh40ql.\n- tidal_artist_id (optional): The TIDAL ID of the collaborator being requested * Example: 49475872.\n\nHeaders:\n- Accept-Encoding: gzip, deflate, br\n\nDocumented responses: 200, 400, 401, 403, 404, 429, 500, 502, 503." }, "response": [] }, { "name": "Get Collaborator Audience Details", "request": { "method": "GET", "header": [ { "key": "Accept-Encoding", "value": "{{accept_encoding}}", "description": "gzip, deflate, br", "type": "text" } ], "url": { "raw": "{{base_url}}/collaborators/audience/details?source={{source}}&songstats_collaborator_id={{songstats_collaborator_id}}&country_code={{country_code}}", "host": [ "{{base_url}}" ], "path": [ "collaborators", "audience", "details" ], "query": [ { "key": "source", "value": "{{source}}", "description": "Specifies the sources that data is being requested for. Can be a comma separated list of individual sources or be set to 'all'." }, { "key": "songstats_collaborator_id", "value": "{{songstats_collaborator_id}}", "description": "The Songstats ID of the collaborator being requested *" }, { "key": "tidal_artist_id", "value": "{{tidal_artist_id}}", "description": "The TIDAL ID of the collaborator being requested *", "disabled": true }, { "key": "country_code", "value": "{{country_code}}", "description": "A two-letter country code" } ] }, "description": "Returns detailed audience information of a collaborator for a specific country filtered by source.\nGenerated from docs/songstats_api_openapi.yaml.\n\nQuery parameters:\n- source (required): Specifies the sources that data is being requested for. Can be a comma separated list of individual sources or be set to 'all'. Example: spotify,apple_music,deezer.\n- songstats_collaborator_id (optional): The Songstats ID of the collaborator being requested * Example: vkwh40ql.\n- tidal_artist_id (optional): The TIDAL ID of the collaborator being requested * Example: 49475872.\n- country_code (required): A two-letter country code Example: US.\n\nHeaders:\n- Accept-Encoding: gzip, deflate, br\n\nDocumented responses: 200, 400, 401, 403, 404, 429, 500, 502, 503." }, "response": [] }, { "name": "Get Collaborator Catalog", "request": { "method": "GET", "header": [ { "key": "Accept-Encoding", "value": "{{accept_encoding}}", "description": "gzip, deflate, br", "type": "text" } ], "url": { "raw": "{{base_url}}/collaborators/catalog?songstats_collaborator_id={{songstats_collaborator_id}}", "host": [ "{{base_url}}" ], "path": [ "collaborators", "catalog" ], "query": [ { "key": "songstats_collaborator_id", "value": "{{songstats_collaborator_id}}", "description": "The Songstats ID of the collaborator being requested *" }, { "key": "tidal_artist_id", "value": "{{tidal_artist_id}}", "description": "The TIDAL ID of the collaborator being requested *", "disabled": true }, { "key": "limit", "value": "{{limit}}", "description": "Specifies the limit of results being returned.", "disabled": true }, { "key": "offset", "value": "{{offset}}", "description": "Specifies the offset of the limited results being returned.", "disabled": true }, { "key": "with_links", "value": "{{with_links}}", "description": "Includes an array of all of the source links associated with the requested objected.", "disabled": true } ] }, "description": "Returns the track catalog of a collaborator ordered by release date.\nGenerated from docs/songstats_api_openapi.yaml.\n\nQuery parameters:\n- songstats_collaborator_id (optional): The Songstats ID of the collaborator being requested * Example: vkwh40ql.\n- tidal_artist_id (optional): The TIDAL ID of the collaborator being requested * Example: 49475872.\n- limit (optional): Specifies the limit of results being returned. Example: 20.\n- offset (optional): Specifies the offset of the limited results being returned. Example: 20.\n- with_links (optional): Includes an array of all of the source links associated with the requested objected. Example: true.\n\nHeaders:\n- Accept-Encoding: gzip, deflate, br\n\nDocumented responses: 200, 400, 401, 403, 404, 429, 500, 502, 503." }, "response": [] }, { "name": "Get Collaborator Top Tracks", "request": { "method": "GET", "header": [ { "key": "Accept-Encoding", "value": "{{accept_encoding}}", "description": "gzip, deflate, br", "type": "text" } ], "url": { "raw": "{{base_url}}/collaborators/top_tracks?source={{source}}&songstats_collaborator_id={{songstats_collaborator_id}}&metric={{metric}}&scope={{scope}}", "host": [ "{{base_url}}" ], "path": [ "collaborators", "top_tracks" ], "query": [ { "key": "source", "value": "{{source}}", "description": "Specifies the sources that data is being requested for. Can be a comma separated list of individual sources or be set to 'all'." }, { "key": "songstats_collaborator_id", "value": "{{songstats_collaborator_id}}", "description": "The Songstats ID of the collaborator being requested *" }, { "key": "tidal_artist_id", "value": "{{tidal_artist_id}}", "description": "The TIDAL ID of the collaborator being requested *", "disabled": true }, { "key": "limit", "value": "{{limit}}", "description": "Specifies the limit of results being returned.", "disabled": true }, { "key": "metric", "value": "{{metric}}", "description": "The metric to sort the top results by." }, { "key": "scope", "value": "{{scope}}", "description": "The time scope for the returned top results." } ] }, "description": "Returns the top tracks of a collaborator sorted rank type.\nGenerated from docs/songstats_api_openapi.yaml.\n\nQuery parameters:\n- source (required): Specifies the sources that data is being requested for. Can be a comma separated list of individual sources or be set to 'all'. Example: spotify,apple_music,deezer.\n- songstats_collaborator_id (optional): The Songstats ID of the collaborator being requested * Example: vkwh40ql.\n- tidal_artist_id (optional): The TIDAL ID of the collaborator being requested * Example: 49475872.\n- limit (optional): Specifies the limit of results being returned. Example: 20.\n- metric (required): The metric to sort the top results by. Example: playlists.\n- scope (required): The time scope for the returned top results. Example: total.\n\nHeaders:\n- Accept-Encoding: gzip, deflate, br\n\nDocumented responses: 200, 400, 401, 403, 404, 429, 500, 502, 503." }, "response": [] }, { "name": "Get Collaborator Top Playlists", "request": { "method": "GET", "header": [ { "key": "Accept-Encoding", "value": "{{accept_encoding}}", "description": "gzip, deflate, br", "type": "text" } ], "url": { "raw": "{{base_url}}/collaborators/top_playlists?songstats_collaborator_id={{songstats_collaborator_id}}&scope={{scope}}&source={{source}}", "host": [ "{{base_url}}" ], "path": [ "collaborators", "top_playlists" ], "query": [ { "key": "songstats_collaborator_id", "value": "{{songstats_collaborator_id}}", "description": "The Songstats ID of the collaborator being requested *" }, { "key": "tidal_artist_id", "value": "{{tidal_artist_id}}", "description": "The TIDAL ID of the collaborator being requested *", "disabled": true }, { "key": "scope", "value": "{{scope}}", "description": "The time scope for the returned top results." }, { "key": "source", "value": "{{source}}", "description": "Specifies the sources that data is being requested for. Can be a comma separated list of individual sources or be set to 'all'." }, { "key": "limit", "value": "{{limit}}", "description": "Specifies the limit of results being returned.", "disabled": true } ] }, "description": "Returns the top playlists of a collaborator.\nGenerated from docs/songstats_api_openapi.yaml.\n\nQuery parameters:\n- songstats_collaborator_id (optional): The Songstats ID of the collaborator being requested * Example: vkwh40ql.\n- tidal_artist_id (optional): The TIDAL ID of the collaborator being requested * Example: 49475872.\n- scope (required): The time scope for the returned top results. Example: total.\n- source (required): Specifies the sources that data is being requested for. Can be a comma separated list of individual sources or be set to 'all'. Example: spotify,apple_music,deezer.\n- limit (optional): Specifies the limit of results being returned. Example: 20.\n\nHeaders:\n- Accept-Encoding: gzip, deflate, br\n\nDocumented responses: 200, 400, 401, 403, 404, 429, 500, 502, 503." }, "response": [] }, { "name": "Get Collaborator Top Curators", "request": { "method": "GET", "header": [ { "key": "Accept-Encoding", "value": "{{accept_encoding}}", "description": "gzip, deflate, br", "type": "text" } ], "url": { "raw": "{{base_url}}/collaborators/top_curators?songstats_collaborator_id={{songstats_collaborator_id}}&scope={{scope}}&source={{source}}", "host": [ "{{base_url}}" ], "path": [ "collaborators", "top_curators" ], "query": [ { "key": "songstats_collaborator_id", "value": "{{songstats_collaborator_id}}", "description": "The Songstats ID of the collaborator being requested *" }, { "key": "tidal_artist_id", "value": "{{tidal_artist_id}}", "description": "The TIDAL ID of the collaborator being requested *", "disabled": true }, { "key": "scope", "value": "{{scope}}", "description": "The time scope for the returned top results." }, { "key": "source", "value": "{{source}}", "description": "Specifies the sources that data is being requested for. Can be a comma separated list of individual sources or be set to 'all'." }, { "key": "limit", "value": "{{limit}}", "description": "Specifies the limit of results being returned.", "disabled": true } ] }, "description": "Returns the top curators supporting a collaborator.\nGenerated from docs/songstats_api_openapi.yaml.\n\nQuery parameters:\n- songstats_collaborator_id (optional): The Songstats ID of the collaborator being requested * Example: vkwh40ql.\n- tidal_artist_id (optional): The TIDAL ID of the collaborator being requested * Example: 49475872.\n- scope (required): The time scope for the returned top results. Example: total.\n- source (required): Specifies the sources that data is being requested for. Can be a comma separated list of individual sources or be set to 'all'. Example: spotify,apple_music,deezer.\n- limit (optional): Specifies the limit of results being returned. Example: 20.\n\nHeaders:\n- Accept-Encoding: gzip, deflate, br\n\nDocumented responses: 200, 400, 401, 403, 404, 429, 500, 502, 503." }, "response": [] }, { "name": "Get Collaborator Top Commentors", "request": { "method": "GET", "header": [ { "key": "Accept-Encoding", "value": "{{accept_encoding}}", "description": "gzip, deflate, br", "type": "text" } ], "url": { "raw": "{{base_url}}/collaborators/top_commentors?songstats_collaborator_id={{songstats_collaborator_id}}&scope={{scope}}&source={{source}}", "host": [ "{{base_url}}" ], "path": [ "collaborators", "top_commentors" ], "query": [ { "key": "songstats_collaborator_id", "value": "{{songstats_collaborator_id}}", "description": "The Songstats ID of the collaborator being requested *" }, { "key": "tidal_artist_id", "value": "{{tidal_artist_id}}", "description": "The TIDAL ID of the collaborator being requested *", "disabled": true }, { "key": "scope", "value": "{{scope}}", "description": "The time scope for the returned top results." }, { "key": "source", "value": "{{source}}", "description": "Specifies the sources that data is being requested for. Can be a comma separated list of individual sources or be set to 'all'." }, { "key": "limit", "value": "{{limit}}", "description": "Specifies the limit of results being returned.", "disabled": true } ] }, "description": "Returns the top commentors supporting a collaborator.\nGenerated from docs/songstats_api_openapi.yaml.\n\nQuery parameters:\n- songstats_collaborator_id (optional): The Songstats ID of the collaborator being requested * Example: vkwh40ql.\n- tidal_artist_id (optional): The TIDAL ID of the collaborator being requested * Example: 49475872.\n- scope (required): The time scope for the returned top results. Example: total.\n- source (required): Specifies the sources that data is being requested for. Can be a comma separated list of individual sources or be set to 'all'. Example: youtube,soundcloud.\n- limit (optional): Specifies the limit of results being returned. Example: 20.\n\nHeaders:\n- Accept-Encoding: gzip, deflate, br\n\nDocumented responses: 200, 400, 401, 403, 404, 429, 500, 502, 503." }, "response": [] }, { "name": "Get Collaborator Songshare", "request": { "method": "GET", "header": [ { "key": "Accept-Encoding", "value": "{{accept_encoding}}", "description": "gzip, deflate, br", "type": "text" } ], "url": { "raw": "{{base_url}}/collaborators/songshare?songstats_collaborator_id={{songstats_collaborator_id}}", "host": [ "{{base_url}}" ], "path": [ "collaborators", "songshare" ], "query": [ { "key": "songstats_collaborator_id", "value": "{{songstats_collaborator_id}}", "description": "The Songstats ID of the collaborator being requested *" }, { "key": "tidal_artist_id", "value": "{{tidal_artist_id}}", "description": "The TIDAL ID of the collaborator being requested *", "disabled": true } ] }, "description": "Returns Songshare smart link information of a collaborator.\nGenerated from docs/songstats_api_openapi.yaml.\n\nQuery parameters:\n- songstats_collaborator_id (optional): The Songstats ID of the collaborator being requested * Example: vkwh40ql.\n- tidal_artist_id (optional): The TIDAL ID of the collaborator being requested * Example: 49475872.\n\nHeaders:\n- Accept-Encoding: gzip, deflate, br\n\nDocumented responses: 200, 400, 401, 403, 404, 429, 500, 502, 503." }, "response": [] }, { "name": "Search Collaborator", "request": { "method": "GET", "header": [ { "key": "Accept-Encoding", "value": "{{accept_encoding}}", "description": "gzip, deflate, br", "type": "text" } ], "url": { "raw": "{{base_url}}/collaborators/search?q={{search_query}}", "host": [ "{{base_url}}" ], "path": [ "collaborators", "search" ], "query": [ { "key": "q", "value": "{{search_query}}", "description": "Search Query" }, { "key": "limit", "value": "{{limit}}", "description": "Specifies the limit of results being returned.", "disabled": true }, { "key": "offset", "value": "{{offset}}", "description": "Specifies the offset of the limited results being returned.", "disabled": true } ] }, "description": "Search for a collaborator.\nGenerated from docs/songstats_api_openapi.yaml.\n\nQuery parameters:\n- q (required): Search Query\n- limit (optional): Specifies the limit of results being returned. Example: 20.\n- offset (optional): Specifies the offset of the limited results being returned. Example: 20.\n\nHeaders:\n- Accept-Encoding: gzip, deflate, br\n\nDocumented responses: 200, 400, 401, 403, 404, 429, 500, 502, 503." }, "response": [] }, { "name": "Add Collaborator Link", "request": { "method": "POST", "header": [ { "key": "Accept-Encoding", "value": "{{accept_encoding}}", "description": "gzip, deflate, br", "type": "text" } ], "url": { "raw": "{{base_url}}/collaborators/link_request?songstats_collaborator_id={{songstats_collaborator_id}}&link={{source_link}}", "host": [ "{{base_url}}" ], "path": [ "collaborators", "link_request" ], "query": [ { "key": "songstats_collaborator_id", "value": "{{songstats_collaborator_id}}", "description": "The Songstats ID of the collaborator being requested *" }, { "key": "tidal_artist_id", "value": "{{tidal_artist_id}}", "description": "The TIDAL ID of the collaborator being requested *", "disabled": true }, { "key": "link", "value": "{{source_link}}", "description": "Link to be added." } ] }, "description": "Request for link to be added to a collaborator.\nGenerated from docs/songstats_api_openapi.yaml.\n\nQuery parameters:\n- songstats_collaborator_id (optional): The Songstats ID of the collaborator being requested * Example: vkwh40ql.\n- tidal_artist_id (optional): The TIDAL ID of the collaborator being requested * Example: 49475872.\n- link (required): Link to be added. Example: https://soundcloud.com/dontblink/vibration.\n\nHeaders:\n- Accept-Encoding: gzip, deflate, br\n\nDocumented responses: 200, 400, 401, 403, 404, 429, 500, 502, 503." }, "response": [] }, { "name": "Remove Collaborator Link", "request": { "method": "DELETE", "header": [], "url": { "raw": "{{base_url}}/collaborators/link_request?songstats_collaborator_id={{songstats_collaborator_id}}&link={{source_link}}", "host": [ "{{base_url}}" ], "path": [ "collaborators", "link_request" ], "query": [ { "key": "songstats_collaborator_id", "value": "{{songstats_collaborator_id}}", "description": "The Songstats ID of the collaborator being requested *" }, { "key": "tidal_artist_id", "value": "{{tidal_artist_id}}", "description": "The TIDAL ID of the collaborator being requested *", "disabled": true }, { "key": "link", "value": "{{source_link}}", "description": "Link to be deleted." } ] }, "description": "Request for link to be removed from a collaborator.\nGenerated from docs/songstats_api_openapi.yaml.\n\nQuery parameters:\n- songstats_collaborator_id (optional): The Songstats ID of the collaborator being requested * Example: vkwh40ql.\n- tidal_artist_id (optional): The TIDAL ID of the collaborator being requested * Example: 49475872.\n- link (required): Link to be deleted. Example: https://soundcloud.com/dontblink/vibration.\n\nDocumented responses: 200, 400, 401, 403, 404, 429, 500, 502, 503." }, "response": [] }, { "name": "Add Collaborator Track", "request": { "method": "POST", "header": [ { "key": "Accept-Encoding", "value": "{{accept_encoding}}", "description": "gzip, deflate, br", "type": "text" } ], "url": { "raw": "{{base_url}}/collaborators/track_request?songstats_collaborator_id={{songstats_collaborator_id}}&spotify_track_id={{spotify_track_id}}", "host": [ "{{base_url}}" ], "path": [ "collaborators", "track_request" ], "query": [ { "key": "songstats_collaborator_id", "value": "{{songstats_collaborator_id}}", "description": "The Songstats ID of the collaborator being requested *" }, { "key": "tidal_artist_id", "value": "{{tidal_artist_id}}", "description": "The TIDAL ID of the collaborator being requested *", "disabled": true }, { "key": "link", "value": "{{track_link}}", "description": "Link to the track to be added from Spotify, Apple Music, Amazon, Deezer, 1001Tracklists, Beatport, Traxsource or TIDAL.", "disabled": true }, { "key": "isrc", "value": "{{isrc}}", "description": "ISRC of the track to be added.", "disabled": true }, { "key": "spotify_track_id", "value": "{{spotify_track_id}}", "description": "Spotify ID of the track to be added." } ] }, "description": "Request for track to be added to a collaborator catalog.\nGenerated from docs/songstats_api_openapi.yaml.\n\nQuery parameters:\n- songstats_collaborator_id (optional): The Songstats ID of the collaborator being requested * Example: vkwh40ql.\n- tidal_artist_id (optional): The TIDAL ID of the collaborator being requested * Example: 49475872.\n- link (optional): Link to the track to be added from Spotify, Apple Music, Amazon, Deezer, 1001Tracklists, Beatport, Traxsource or TIDAL. Example: https://music.apple.com/us/album/smalltown-boy/1743410570?i=1743410576.\n- isrc (optional): ISRC of the track to be added. Example: UKKGA2000013.\n- spotify_track_id (optional): Spotify ID of the track to be added. Example: 3yYqfGNpGlIyZJvWEcXgnF.\n\nHeaders:\n- Accept-Encoding: gzip, deflate, br\n\nDocumented responses: 200, 400, 401, 403, 404, 429, 500, 502, 503." }, "response": [] }, { "name": "Remove Collaborator Track", "request": { "method": "DELETE", "header": [], "url": { "raw": "{{base_url}}/collaborators/track_request?songstats_collaborator_id={{songstats_collaborator_id}}&songstats_track_id={{songstats_track_id}}", "host": [ "{{base_url}}" ], "path": [ "collaborators", "track_request" ], "query": [ { "key": "songstats_collaborator_id", "value": "{{songstats_collaborator_id}}", "description": "The Songstats ID of the collaborator being requested *" }, { "key": "tidal_artist_id", "value": "{{tidal_artist_id}}", "description": "The TIDAL ID of the collaborator being requested *", "disabled": true }, { "key": "spotify_track_id", "value": "{{spotify_track_id}}", "description": "Spotify ID of the track to be removed.", "disabled": true }, { "key": "songstats_track_id", "value": "{{songstats_track_id}}", "description": "Songstats ID of the track to be removed." } ] }, "description": "Request for track to be removed from a collaborator catalog.\nGenerated from docs/songstats_api_openapi.yaml.\n\nQuery parameters:\n- songstats_collaborator_id (optional): The Songstats ID of the collaborator being requested * Example: vkwh40ql.\n- tidal_artist_id (optional): The TIDAL ID of the collaborator being requested * Example: 49475872.\n- spotify_track_id (optional): Spotify ID of the track to be removed. Example: 4wAQSi076CxYXc0y37IRRH.\n- songstats_track_id (optional): Songstats ID of the track to be removed. Example: sv1aqxtp.\n\nDocumented responses: 200, 400, 401, 403, 404, 429, 500, 502, 503." }, "response": [] }, { "name": "Add Collaborator To Member Relevant List", "request": { "method": "POST", "header": [], "url": { "raw": "{{base_url}}/collaborators/add_to_member_relevant_list?songstats_collaborator_id={{songstats_collaborator_id}}", "host": [ "{{base_url}}" ], "path": [ "collaborators", "add_to_member_relevant_list" ], "query": [ { "key": "songstats_collaborator_id", "value": "{{songstats_collaborator_id}}", "description": "Songstats collaborator ID." } ] }, "description": "Adds the requested collaborator source object to the Enterprise member relevant list.\nLive Rails route inferred from config/routes.rb and Enterprise controller behavior; this endpoint is not currently present in docs/songstats_api_openapi.yaml.\n\nQuery parameters:\n- songstats_collaborator_id (required): Songstats collaborator ID. Example: vkwh40ql.\n\nDocumented responses: 200, 300, 400, 401, 403, 429, 500." }, "response": [] }, { "name": "Remove Collaborator From Member Relevant List", "request": { "method": "DELETE", "header": [], "url": { "raw": "{{base_url}}/collaborators/remove_from_member_relevant_list?songstats_collaborator_id={{songstats_collaborator_id}}", "host": [ "{{base_url}}" ], "path": [ "collaborators", "remove_from_member_relevant_list" ], "query": [ { "key": "songstats_collaborator_id", "value": "{{songstats_collaborator_id}}", "description": "Songstats collaborator ID." } ] }, "description": "Removes the requested collaborator source objects from the Enterprise member relevant list.\nLive Rails route inferred from config/routes.rb and Enterprise controller behavior; this endpoint is not currently present in docs/songstats_api_openapi.yaml.\n\nQuery parameters:\n- songstats_collaborator_id (required): Songstats collaborator ID. Example: vkwh40ql.\n\nDocumented responses: 200, 300, 400, 401, 403, 429, 500." }, "response": [] } ] }, { "name": "Labels", "item": [ { "name": "Get Label Info", "request": { "method": "GET", "header": [ { "key": "Accept-Encoding", "value": "{{accept_encoding}}", "description": "gzip, deflate, br", "type": "text" } ], "url": { "raw": "{{base_url}}/labels/info?songstats_label_id={{songstats_label_id}}", "host": [ "{{base_url}}" ], "path": [ "labels", "info" ], "query": [ { "key": "songstats_label_id", "value": "{{songstats_label_id}}", "description": "The Songstats ID of the label being requested *" }, { "key": "beatport_label_id", "value": "{{beatport_label_id}}", "description": "The Beatport ID of the label being requested *", "disabled": true } ] }, "description": "Returns metadata information of a record label.\nGenerated from docs/songstats_api_openapi.yaml.\n\nQuery parameters:\n- songstats_label_id (optional): The Songstats ID of the label being requested * Example: 7gk4yfc9.\n- beatport_label_id (optional): The Beatport ID of the label being requested * Example: 74932.\n\nHeaders:\n- Accept-Encoding: gzip, deflate, br\n\nDocumented responses: 200, 400, 401, 403, 404, 429, 500, 502, 503." }, "response": [] }, { "name": "Get Label Activities", "request": { "method": "GET", "header": [ { "key": "Accept-Encoding", "value": "{{accept_encoding}}", "description": "gzip, deflate, br", "type": "text" } ], "url": { "raw": "{{base_url}}/labels/activities?source={{source}}&songstats_label_id={{songstats_label_id}}", "host": [ "{{base_url}}" ], "path": [ "labels", "activities" ], "query": [ { "key": "source", "value": "{{source}}", "description": "Specifies the sources that data is being requested for. Can be a comma separated list of individual sources or be set to 'all'." }, { "key": "songstats_label_id", "value": "{{songstats_label_id}}", "description": "The Songstats ID of the label being requested *" }, { "key": "beatport_label_id", "value": "{{beatport_label_id}}", "description": "The Beatport ID of the label being requested *", "disabled": true }, { "key": "limit", "value": "{{limit}}", "description": "Specifies the limit of results being returned.", "disabled": true }, { "key": "offset", "value": "{{offset}}", "description": "Specifies the offset of the limited results being returned.", "disabled": true }, { "key": "milestones", "value": "{{milestones}}", "description": "Include Milestone Activities.", "disabled": true }, { "key": "albums", "value": "{{albums}}", "description": "Include Album Activities.", "disabled": true }, { "key": "editorial", "value": "{{editorial}}", "description": "Only include Editorial Activities.", "disabled": true }, { "key": "recent", "value": "{{recent}}", "description": "Only include Activities for recent tracks (released in past 3 months).", "disabled": true }, { "key": "tier", "value": "{{tier}}", "description": "Filter Activities by importance. Tier 4 is the lowest tier that returns all activities. Tier 1 is the highest tier that returns only the most significant activities.", "disabled": true }, { "key": "comments", "value": "{{comments}}", "description": "Include Comment Activities.", "disabled": true } ] }, "description": "Returns the latest activities of a label filtered by source.\nGenerated from docs/songstats_api_openapi.yaml.\n\nQuery parameters:\n- source (required): Specifies the sources that data is being requested for. Can be a comma separated list of individual sources or be set to 'all'. Example: spotify,apple_music,deezer.\n- songstats_label_id (optional): The Songstats ID of the label being requested * Example: 7gk4yfc9.\n- beatport_label_id (optional): The Beatport ID of the label being requested * Example: 74932.\n- limit (optional): Specifies the limit of results being returned. Example: 20.\n- offset (optional): Specifies the offset of the limited results being returned. Example: 20.\n- milestones (optional): Include Milestone Activities. Example: true.\n- albums (optional): Include Album Activities. Example: true.\n- editorial (optional): Only include Editorial Activities. Example: false.\n- recent (optional): Only include Activities for recent tracks (released in past 3 months). Example: false.\n- tier (optional): Filter Activities by importance. Tier 4 is the lowest tier that returns all activities. Tier 1 is the highest tier that returns only the most significant activities. Example: 4.\n- comments (optional): Include Comment Activities. Example: true.\n\nHeaders:\n- Accept-Encoding: gzip, deflate, br\n\nDocumented responses: 200, 400, 401, 403, 404, 429, 500, 502, 503." }, "response": [] }, { "name": "Get Label Current Stats", "request": { "method": "GET", "header": [ { "key": "Accept-Encoding", "value": "{{accept_encoding}}", "description": "gzip, deflate, br", "type": "text" } ], "url": { "raw": "{{base_url}}/labels/stats?source={{source}}&songstats_label_id={{songstats_label_id}}", "host": [ "{{base_url}}" ], "path": [ "labels", "stats" ], "query": [ { "key": "source", "value": "{{source}}", "description": "Specifies the sources that data is being requested for. Can be a comma separated list of individual sources or be set to 'all'." }, { "key": "songstats_label_id", "value": "{{songstats_label_id}}", "description": "The Songstats ID of the label being requested *" }, { "key": "beatport_label_id", "value": "{{beatport_label_id}}", "description": "The Beatport ID of the label being requested *", "disabled": true } ] }, "description": "Returns summary and detailed information of a record label filtered by source.\nGenerated from docs/songstats_api_openapi.yaml.\n\nQuery parameters:\n- source (required): Specifies the sources that data is being requested for. Can be a comma separated list of individual sources or be set to 'all'. Example: spotify,apple_music,deezer.\n- songstats_label_id (optional): The Songstats ID of the label being requested * Example: 7gk4yfc9.\n- beatport_label_id (optional): The Beatport ID of the label being requested * Example: 74932.\n\nHeaders:\n- Accept-Encoding: gzip, deflate, br\n\nDocumented responses: 200, 400, 401, 403, 404, 429, 500, 502, 503." }, "response": [] }, { "name": "Get Label Historic Stats", "request": { "method": "GET", "header": [ { "key": "Accept-Encoding", "value": "{{accept_encoding}}", "description": "gzip, deflate, br", "type": "text" } ], "url": { "raw": "{{base_url}}/labels/historic_stats?source={{source}}&songstats_label_id={{songstats_label_id}}", "host": [ "{{base_url}}" ], "path": [ "labels", "historic_stats" ], "query": [ { "key": "source", "value": "{{source}}", "description": "Specifies the sources that data is being requested for. Can be a comma separated list of individual sources or be set to 'all'." }, { "key": "songstats_label_id", "value": "{{songstats_label_id}}", "description": "The Songstats ID of the label being requested *" }, { "key": "beatport_label_id", "value": "{{beatport_label_id}}", "description": "The Beatport ID of the label being requested *", "disabled": true }, { "key": "start_date", "value": "{{start_date}}", "description": "Specifies the start_date of the historic data that is being requested.", "disabled": true }, { "key": "end_date", "value": "{{end_date}}", "description": "Specifies the end_date of the historic data that is being requested.", "disabled": true }, { "key": "with_aggregates", "value": "{{with_aggregates}}", "description": "Includes data points aggregated by Songstats like playlists_current, playlists_reach_current, charts_current, etc.", "disabled": true } ] }, "description": "Returns historic information of a record label filtered by source.\nGenerated from docs/songstats_api_openapi.yaml.\n\nQuery parameters:\n- source (required): Specifies the sources that data is being requested for. Can be a comma separated list of individual sources or be set to 'all'. Example: spotify,apple_music,deezer.\n- songstats_label_id (optional): The Songstats ID of the label being requested * Example: 7gk4yfc9.\n- beatport_label_id (optional): The Beatport ID of the label being requested * Example: 74932.\n- start_date (optional): Specifies the start_date of the historic data that is being requested. Example: 2021-12-31.\n- end_date (optional): Specifies the end_date of the historic data that is being requested. Example: 2022-01-16.\n- with_aggregates (optional): Includes data points aggregated by Songstats like playlists_current, playlists_reach_current, charts_current, etc. Example: true.\n\nHeaders:\n- Accept-Encoding: gzip, deflate, br\n\nDocumented responses: 200, 400, 401, 403, 404, 429, 500, 502, 503." }, "response": [] }, { "name": "Get Label Audience", "request": { "method": "GET", "header": [ { "key": "Accept-Encoding", "value": "{{accept_encoding}}", "description": "gzip, deflate, br", "type": "text" } ], "url": { "raw": "{{base_url}}/labels/audience?source={{source}}&songstats_label_id={{songstats_label_id}}", "host": [ "{{base_url}}" ], "path": [ "labels", "audience" ], "query": [ { "key": "source", "value": "{{source}}", "description": "Specifies the sources that data is being requested for. Can be a comma separated list of individual sources or be set to 'all'." }, { "key": "songstats_label_id", "value": "{{songstats_label_id}}", "description": "The Songstats ID of the label being requested *" }, { "key": "beatport_label_id", "value": "{{beatport_label_id}}", "description": "The Beatport ID of the label being requested *", "disabled": true } ] }, "description": "Returns audience information of a record label filtered by source.\nGenerated from docs/songstats_api_openapi.yaml.\n\nQuery parameters:\n- source (required): Specifies the sources that data is being requested for. Can be a comma separated list of individual sources or be set to 'all'. Example: spotify,apple_music,deezer.\n- songstats_label_id (optional): The Songstats ID of the label being requested * Example: 7gk4yfc9.\n- beatport_label_id (optional): The Beatport ID of the label being requested * Example: 74932.\n\nHeaders:\n- Accept-Encoding: gzip, deflate, br\n\nDocumented responses: 200, 400, 401, 403, 404, 429, 500, 502, 503." }, "response": [] }, { "name": "Get Label Audience Details", "request": { "method": "GET", "header": [ { "key": "Accept-Encoding", "value": "{{accept_encoding}}", "description": "gzip, deflate, br", "type": "text" } ], "url": { "raw": "{{base_url}}/labels/audience/details?source={{source}}&songstats_label_id={{songstats_label_id}}&country_code={{country_code}}", "host": [ "{{base_url}}" ], "path": [ "labels", "audience", "details" ], "query": [ { "key": "source", "value": "{{source}}", "description": "Specifies the sources that data is being requested for. Can be a comma separated list of individual sources or be set to 'all'." }, { "key": "songstats_label_id", "value": "{{songstats_label_id}}", "description": "The Songstats ID of the label being requested *" }, { "key": "beatport_label_id", "value": "{{beatport_label_id}}", "description": "The Beatport ID of the label being requested *", "disabled": true }, { "key": "country_code", "value": "{{country_code}}", "description": "A two-letter country code" } ] }, "description": "Returns detailed audience information of a record label for a specific country filtered by source.\nGenerated from docs/songstats_api_openapi.yaml.\n\nQuery parameters:\n- source (required): Specifies the sources that data is being requested for. Can be a comma separated list of individual sources or be set to 'all'. Example: spotify,apple_music,deezer.\n- songstats_label_id (optional): The Songstats ID of the label being requested * Example: 7gk4yfc9.\n- beatport_label_id (optional): The Beatport ID of the label being requested * Example: 74932.\n- country_code (required): A two-letter country code Example: US.\n\nHeaders:\n- Accept-Encoding: gzip, deflate, br\n\nDocumented responses: 200, 400, 401, 403, 404, 429, 500, 502, 503." }, "response": [] }, { "name": "Get Label Catalog", "request": { "method": "GET", "header": [ { "key": "Accept-Encoding", "value": "{{accept_encoding}}", "description": "gzip, deflate, br", "type": "text" } ], "url": { "raw": "{{base_url}}/labels/catalog?songstats_label_id={{songstats_label_id}}", "host": [ "{{base_url}}" ], "path": [ "labels", "catalog" ], "query": [ { "key": "songstats_label_id", "value": "{{songstats_label_id}}", "description": "The Songstats ID of the label being requested *" }, { "key": "beatport_label_id", "value": "{{beatport_label_id}}", "description": "The Beatport ID of the label being requested *", "disabled": true }, { "key": "limit", "value": "{{limit}}", "description": "Specifies the limit of results being returned.", "disabled": true }, { "key": "offset", "value": "{{offset}}", "description": "Specifies the offset of the limited results being returned.", "disabled": true }, { "key": "with_links", "value": "{{with_links}}", "description": "Includes an array of all of the source links associated with the requested objected.", "disabled": true } ] }, "description": "Returns the track catalog of a record label ordered by release date.\nGenerated from docs/songstats_api_openapi.yaml.\n\nQuery parameters:\n- songstats_label_id (optional): The Songstats ID of the label being requested * Example: 7gk4yfc9.\n- beatport_label_id (optional): The Beatport ID of the label being requested * Example: 74932.\n- limit (optional): Specifies the limit of results being returned. Example: 20.\n- offset (optional): Specifies the offset of the limited results being returned. Example: 20.\n- with_links (optional): Includes an array of all of the source links associated with the requested objected. Example: true.\n\nHeaders:\n- Accept-Encoding: gzip, deflate, br\n\nDocumented responses: 200, 400, 401, 403, 404, 429, 500, 502, 503." }, "response": [] }, { "name": "Get Label Top Tracks", "request": { "method": "GET", "header": [ { "key": "Accept-Encoding", "value": "{{accept_encoding}}", "description": "gzip, deflate, br", "type": "text" } ], "url": { "raw": "{{base_url}}/labels/top_tracks?source={{source}}&songstats_label_id={{songstats_label_id}}&metric={{metric}}&scope={{scope}}", "host": [ "{{base_url}}" ], "path": [ "labels", "top_tracks" ], "query": [ { "key": "source", "value": "{{source}}", "description": "Specifies the sources that data is being requested for. Can be a comma separated list of individual sources or be set to 'all'." }, { "key": "songstats_label_id", "value": "{{songstats_label_id}}", "description": "The Songstats ID of the label being requested *" }, { "key": "beatport_label_id", "value": "{{beatport_label_id}}", "description": "The Beatport ID of the label being requested *", "disabled": true }, { "key": "limit", "value": "{{limit}}", "description": "Specifies the limit of results being returned.", "disabled": true }, { "key": "metric", "value": "{{metric}}", "description": "The metric to sort the top results by." }, { "key": "scope", "value": "{{scope}}", "description": "The time scope for the returned top results." } ] }, "description": "Returns the top tracks of a label sorted by rank type.\nGenerated from docs/songstats_api_openapi.yaml.\n\nQuery parameters:\n- source (required): Specifies the sources that data is being requested for. Can be a comma separated list of individual sources or be set to 'all'. Example: spotify,apple_music,deezer.\n- songstats_label_id (optional): The Songstats ID of the label being requested * Example: 7gk4yfc9.\n- beatport_label_id (optional): The Beatport ID of the label being requested * Example: 74932.\n- limit (optional): Specifies the limit of results being returned. Example: 20.\n- metric (required): The metric to sort the top results by. Example: playlists.\n- scope (required): The time scope for the returned top results. Example: total.\n\nHeaders:\n- Accept-Encoding: gzip, deflate, br\n\nDocumented responses: 200, 400, 401, 403, 404, 429, 500, 502, 503." }, "response": [] }, { "name": "Get Label Top Playlists", "request": { "method": "GET", "header": [ { "key": "Accept-Encoding", "value": "{{accept_encoding}}", "description": "gzip, deflate, br", "type": "text" } ], "url": { "raw": "{{base_url}}/labels/top_playlists?songstats_label_id={{songstats_label_id}}&scope={{scope}}&source={{source}}", "host": [ "{{base_url}}" ], "path": [ "labels", "top_playlists" ], "query": [ { "key": "songstats_label_id", "value": "{{songstats_label_id}}", "description": "The Songstats ID of the label being requested *" }, { "key": "beatport_label_id", "value": "{{beatport_label_id}}", "description": "The Beatport ID of the label being requested *", "disabled": true }, { "key": "scope", "value": "{{scope}}", "description": "The time scope for the returned top results." }, { "key": "source", "value": "{{source}}", "description": "Specifies the sources that data is being requested for. Can be a comma separated list of individual sources or be set to 'all'." }, { "key": "limit", "value": "{{limit}}", "description": "Specifies the limit of results being returned.", "disabled": true } ] }, "description": "Returns the top playlists of a label.\nGenerated from docs/songstats_api_openapi.yaml.\n\nQuery parameters:\n- songstats_label_id (optional): The Songstats ID of the label being requested * Example: 7gk4yfc9.\n- beatport_label_id (optional): The Beatport ID of the label being requested * Example: 74932.\n- scope (required): The time scope for the returned top results. Example: total.\n- source (required): Specifies the sources that data is being requested for. Can be a comma separated list of individual sources or be set to 'all'. Example: spotify,apple_music,deezer.\n- limit (optional): Specifies the limit of results being returned. Example: 20.\n\nHeaders:\n- Accept-Encoding: gzip, deflate, br\n\nDocumented responses: 200, 400, 401, 403, 404, 429, 500, 502, 503." }, "response": [] }, { "name": "Get Label Top Curators", "request": { "method": "GET", "header": [ { "key": "Accept-Encoding", "value": "{{accept_encoding}}", "description": "gzip, deflate, br", "type": "text" } ], "url": { "raw": "{{base_url}}/labels/top_curators?songstats_label_id={{songstats_label_id}}&scope={{scope}}&source={{source}}", "host": [ "{{base_url}}" ], "path": [ "labels", "top_curators" ], "query": [ { "key": "songstats_label_id", "value": "{{songstats_label_id}}", "description": "The Songstats ID of the label being requested *" }, { "key": "beatport_label_id", "value": "{{beatport_label_id}}", "description": "The Beatport ID of the label being requested *", "disabled": true }, { "key": "scope", "value": "{{scope}}", "description": "The time scope for the returned top results." }, { "key": "source", "value": "{{source}}", "description": "Specifies the sources that data is being requested for. Can be a comma separated list of individual sources or be set to 'all'." }, { "key": "limit", "value": "{{limit}}", "description": "Specifies the limit of results being returned.", "disabled": true } ] }, "description": "Returns the top curators supporting a label.\nGenerated from docs/songstats_api_openapi.yaml.\n\nQuery parameters:\n- songstats_label_id (optional): The Songstats ID of the label being requested * Example: 7gk4yfc9.\n- beatport_label_id (optional): The Beatport ID of the label being requested * Example: 74932.\n- scope (required): The time scope for the returned top results. Example: total.\n- source (required): Specifies the sources that data is being requested for. Can be a comma separated list of individual sources or be set to 'all'. Example: spotify,apple_music,deezer.\n- limit (optional): Specifies the limit of results being returned. Example: 20.\n\nHeaders:\n- Accept-Encoding: gzip, deflate, br\n\nDocumented responses: 200, 400, 401, 403, 404, 429, 500, 502, 503." }, "response": [] }, { "name": "Get Label Top Commentors", "request": { "method": "GET", "header": [ { "key": "Accept-Encoding", "value": "{{accept_encoding}}", "description": "gzip, deflate, br", "type": "text" } ], "url": { "raw": "{{base_url}}/labels/top_commentors?songstats_label_id={{songstats_label_id}}&scope={{scope}}&source={{source}}", "host": [ "{{base_url}}" ], "path": [ "labels", "top_commentors" ], "query": [ { "key": "songstats_label_id", "value": "{{songstats_label_id}}", "description": "The Songstats ID of the label being requested *" }, { "key": "beatport_label_id", "value": "{{beatport_label_id}}", "description": "The Beatport ID of the label being requested *", "disabled": true }, { "key": "scope", "value": "{{scope}}", "description": "The time scope for the returned top results." }, { "key": "source", "value": "{{source}}", "description": "Specifies the sources that data is being requested for. Can be a comma separated list of individual sources or be set to 'all'." }, { "key": "limit", "value": "{{limit}}", "description": "Specifies the limit of results being returned.", "disabled": true } ] }, "description": "Returns the top commentors supporting a label.\nGenerated from docs/songstats_api_openapi.yaml.\n\nQuery parameters:\n- songstats_label_id (optional): The Songstats ID of the label being requested * Example: 7gk4yfc9.\n- beatport_label_id (optional): The Beatport ID of the label being requested * Example: 74932.\n- scope (required): The time scope for the returned top results. Example: total.\n- source (required): Specifies the sources that data is being requested for. Can be a comma separated list of individual sources or be set to 'all'. Example: youtube,soundcloud.\n- limit (optional): Specifies the limit of results being returned. Example: 20.\n\nHeaders:\n- Accept-Encoding: gzip, deflate, br\n\nDocumented responses: 200, 400, 401, 403, 404, 429, 500, 502, 503." }, "response": [] }, { "name": "Get Label Songshare", "request": { "method": "GET", "header": [ { "key": "Accept-Encoding", "value": "{{accept_encoding}}", "description": "gzip, deflate, br", "type": "text" } ], "url": { "raw": "{{base_url}}/labels/songshare?songstats_label_id={{songstats_label_id}}", "host": [ "{{base_url}}" ], "path": [ "labels", "songshare" ], "query": [ { "key": "songstats_label_id", "value": "{{songstats_label_id}}", "description": "The Songstats ID of the label being requested *" }, { "key": "beatport_label_id", "value": "{{beatport_label_id}}", "description": "The Beatport ID of the label being requested *", "disabled": true } ] }, "description": "Returns Songshare smart link information of a record label.\nGenerated from docs/songstats_api_openapi.yaml.\n\nQuery parameters:\n- songstats_label_id (optional): The Songstats ID of the label being requested * Example: 7gk4yfc9.\n- beatport_label_id (optional): The Beatport ID of the label being requested * Example: 74932.\n\nHeaders:\n- Accept-Encoding: gzip, deflate, br\n\nDocumented responses: 200, 400, 401, 403, 404, 429, 500, 502, 503." }, "response": [] }, { "name": "Search Label", "request": { "method": "GET", "header": [ { "key": "Accept-Encoding", "value": "{{accept_encoding}}", "description": "gzip, deflate, br", "type": "text" } ], "url": { "raw": "{{base_url}}/labels/search?q={{search_query}}", "host": [ "{{base_url}}" ], "path": [ "labels", "search" ], "query": [ { "key": "q", "value": "{{search_query}}", "description": "Search Query" }, { "key": "limit", "value": "{{limit}}", "description": "Specifies the limit of results being returned.", "disabled": true }, { "key": "offset", "value": "{{offset}}", "description": "Specifies the offset of the limited results being returned.", "disabled": true } ] }, "description": "Search for a record label.\nGenerated from docs/songstats_api_openapi.yaml.\n\nQuery parameters:\n- q (required): Search Query\n- limit (optional): Specifies the limit of results being returned. Example: 20.\n- offset (optional): Specifies the offset of the limited results being returned. Example: 20.\n\nHeaders:\n- Accept-Encoding: gzip, deflate, br\n\nDocumented responses: 200, 400, 401, 403, 404, 429, 500, 502, 503." }, "response": [] }, { "name": "Add Label Link", "request": { "method": "POST", "header": [ { "key": "Accept-Encoding", "value": "{{accept_encoding}}", "description": "gzip, deflate, br", "type": "text" } ], "url": { "raw": "{{base_url}}/labels/link_request?songstats_label_id={{songstats_label_id}}&link={{source_link}}", "host": [ "{{base_url}}" ], "path": [ "labels", "link_request" ], "query": [ { "key": "songstats_label_id", "value": "{{songstats_label_id}}", "description": "The Songstats ID of the label being requested *" }, { "key": "beatport_label_id", "value": "{{beatport_label_id}}", "description": "The Beatport ID of the label being requested *", "disabled": true }, { "key": "link", "value": "{{source_link}}", "description": "Link to be added." } ] }, "description": "Request for link to be added to a record label.\nGenerated from docs/songstats_api_openapi.yaml.\n\nQuery parameters:\n- songstats_label_id (optional): The Songstats ID of the label being requested * Example: 7gk4yfc9.\n- beatport_label_id (optional): The Beatport ID of the label being requested * Example: 74932.\n- link (required): Link to be added. Example: https://soundcloud.com/dontblink/vibration.\n\nHeaders:\n- Accept-Encoding: gzip, deflate, br\n\nDocumented responses: 200, 400, 401, 403, 404, 429, 500, 502, 503." }, "response": [] }, { "name": "Remove Label Link", "request": { "method": "DELETE", "header": [], "url": { "raw": "{{base_url}}/labels/link_request?songstats_label_id={{songstats_label_id}}&link={{source_link}}", "host": [ "{{base_url}}" ], "path": [ "labels", "link_request" ], "query": [ { "key": "songstats_label_id", "value": "{{songstats_label_id}}", "description": "The Songstats ID of the label being requested *" }, { "key": "beatport_label_id", "value": "{{beatport_label_id}}", "description": "The Beatport ID of the label being requested *", "disabled": true }, { "key": "link", "value": "{{source_link}}", "description": "Link to be deleted." } ] }, "description": "Request for link to be removed from a record label.\nGenerated from docs/songstats_api_openapi.yaml.\n\nQuery parameters:\n- songstats_label_id (optional): The Songstats ID of the label being requested * Example: 7gk4yfc9.\n- beatport_label_id (optional): The Beatport ID of the label being requested * Example: 74932.\n- link (required): Link to be deleted. Example: https://soundcloud.com/dontblink/vibration.\n\nDocumented responses: 200, 400, 401, 403, 404, 429, 500, 502, 503." }, "response": [] }, { "name": "Add Label Track", "request": { "method": "POST", "header": [ { "key": "Accept-Encoding", "value": "{{accept_encoding}}", "description": "gzip, deflate, br", "type": "text" } ], "url": { "raw": "{{base_url}}/labels/track_request?songstats_label_id={{songstats_label_id}}&spotify_track_id={{spotify_track_id}}", "host": [ "{{base_url}}" ], "path": [ "labels", "track_request" ], "query": [ { "key": "songstats_label_id", "value": "{{songstats_label_id}}", "description": "The Songstats ID of the label being requested *" }, { "key": "beatport_label_id", "value": "{{beatport_label_id}}", "description": "The Beatport ID of the label being requested *", "disabled": true }, { "key": "link", "value": "{{track_link}}", "description": "Link to the track to be added from Spotify, Apple Music, Amazon, Deezer, 1001Tracklists, Beatport, Traxsource or TIDAL.", "disabled": true }, { "key": "isrc", "value": "{{isrc}}", "description": "ISRC of the track to be added.", "disabled": true }, { "key": "spotify_track_id", "value": "{{spotify_track_id}}", "description": "Spotify ID of the track to be added." } ] }, "description": "Request for track to be added to a record label catalog.\nGenerated from docs/songstats_api_openapi.yaml.\n\nQuery parameters:\n- songstats_label_id (optional): The Songstats ID of the label being requested * Example: 7gk4yfc9.\n- beatport_label_id (optional): The Beatport ID of the label being requested * Example: 74932.\n- link (optional): Link to the track to be added from Spotify, Apple Music, Amazon, Deezer, 1001Tracklists, Beatport, Traxsource or TIDAL. Example: https://music.apple.com/us/album/smalltown-boy/1743410570?i=1743410576.\n- isrc (optional): ISRC of the track to be added. Example: UKKGA2000013.\n- spotify_track_id (optional): Spotify ID of the track to be added. Example: 3yYqfGNpGlIyZJvWEcXgnF.\n\nHeaders:\n- Accept-Encoding: gzip, deflate, br\n\nDocumented responses: 200, 400, 401, 403, 404, 429, 500, 502, 503." }, "response": [] }, { "name": "Remove Label Link", "request": { "method": "DELETE", "header": [], "url": { "raw": "{{base_url}}/labels/track_request?songstats_label_id={{songstats_label_id}}&songstats_track_id={{songstats_track_id}}", "host": [ "{{base_url}}" ], "path": [ "labels", "track_request" ], "query": [ { "key": "songstats_label_id", "value": "{{songstats_label_id}}", "description": "The Songstats ID of the label being requested *" }, { "key": "beatport_label_id", "value": "{{beatport_label_id}}", "description": "The Beatport ID of the label being requested *", "disabled": true }, { "key": "spotify_track_id", "value": "{{spotify_track_id}}", "description": "Spotify ID of the track to be removed.", "disabled": true }, { "key": "songstats_track_id", "value": "{{songstats_track_id}}", "description": "Songstats ID of the track to be removed." } ] }, "description": "Request for track to be removed from a record label catalog.\nGenerated from docs/songstats_api_openapi.yaml.\n\nQuery parameters:\n- songstats_label_id (optional): The Songstats ID of the label being requested * Example: 7gk4yfc9.\n- beatport_label_id (optional): The Beatport ID of the label being requested * Example: 74932.\n- spotify_track_id (optional): Spotify ID of the track to be removed. Example: 4wAQSi076CxYXc0y37IRRH.\n- songstats_track_id (optional): Songstats ID of the track to be removed. Example: sv1aqxtp.\n\nDocumented responses: 200, 400, 401, 403, 404, 429, 500, 502, 503." }, "response": [] }, { "name": "Add Label To Member Relevant List", "request": { "method": "POST", "header": [], "url": { "raw": "{{base_url}}/labels/add_to_member_relevant_list?songstats_label_id={{songstats_label_id}}", "host": [ "{{base_url}}" ], "path": [ "labels", "add_to_member_relevant_list" ], "query": [ { "key": "songstats_label_id", "value": "{{songstats_label_id}}", "description": "Songstats label ID." } ] }, "description": "Adds the requested label source object to the Enterprise member relevant list.\nLive Rails route inferred from config/routes.rb and Enterprise controller behavior; this endpoint is not currently present in docs/songstats_api_openapi.yaml.\n\nQuery parameters:\n- songstats_label_id (required): Songstats label ID. Example: 7gk4yfc9.\n\nDocumented responses: 200, 300, 400, 401, 403, 429, 500." }, "response": [] }, { "name": "Remove Label From Member Relevant List", "request": { "method": "DELETE", "header": [], "url": { "raw": "{{base_url}}/labels/remove_from_member_relevant_list?songstats_label_id={{songstats_label_id}}", "host": [ "{{base_url}}" ], "path": [ "labels", "remove_from_member_relevant_list" ], "query": [ { "key": "songstats_label_id", "value": "{{songstats_label_id}}", "description": "Songstats label ID." } ] }, "description": "Removes the requested label source objects from the Enterprise member relevant list.\nLive Rails route inferred from config/routes.rb and Enterprise controller behavior; this endpoint is not currently present in docs/songstats_api_openapi.yaml.\n\nQuery parameters:\n- songstats_label_id (required): Songstats label ID. Example: 7gk4yfc9.\n\nDocumented responses: 200, 300, 400, 401, 403, 429, 500." }, "response": [] } ] }, { "name": "Tracks", "item": [ { "name": "Get Track Info", "request": { "method": "GET", "header": [ { "key": "Accept-Encoding", "value": "{{accept_encoding}}", "description": "gzip, deflate, br", "type": "text" } ], "url": { "raw": "{{base_url}}/tracks/info?songstats_track_id={{songstats_track_id}}", "host": [ "{{base_url}}" ], "path": [ "tracks", "info" ], "query": [ { "key": "isrc", "value": "{{isrc}}", "description": "The ISRC of the track being requested *", "disabled": true }, { "key": "songstats_track_id", "value": "{{songstats_track_id}}", "description": "The Songstats ID of the track being requested *" }, { "key": "spotify_track_id", "value": "{{spotify_track_id}}", "description": "The Spotify ID of the track being requested *", "disabled": true }, { "key": "apple_music_track_id", "value": "{{apple_music_track_id}}", "description": "The Apple Music ID of the track being requested *", "disabled": true } ] }, "description": "Returns metadata information of a track.\nGenerated from docs/songstats_api_openapi.yaml.\n\nQuery parameters:\n- isrc (optional): The ISRC of the track being requested * Example: GBAYE2100626.\n- songstats_track_id (optional): The Songstats ID of the track being requested * Example: k4bp9etx.\n- spotify_track_id (optional): The Spotify ID of the track being requested * Example: 1YLGtZjDKyY0Qkv4QlX31b.\n- apple_music_track_id (optional): The Apple Music ID of the track being requested * Example: 1567644047.\n\nHeaders:\n- Accept-Encoding: gzip, deflate, br\n\nDocumented responses: 200, 400, 401, 403, 404, 429, 500, 502, 503." }, "response": [] }, { "name": "Get Track Activities", "request": { "method": "GET", "header": [ { "key": "Accept-Encoding", "value": "{{accept_encoding}}", "description": "gzip, deflate, br", "type": "text" } ], "url": { "raw": "{{base_url}}/tracks/activities?songstats_track_id={{songstats_track_id}}&source={{source}}", "host": [ "{{base_url}}" ], "path": [ "tracks", "activities" ], "query": [ { "key": "songstats_track_id", "value": "{{songstats_track_id}}", "description": "The Songstats ID of the track being requested *" }, { "key": "spotify_track_id", "value": "{{spotify_track_id}}", "description": "The Spotify ID of the track being requested *", "disabled": true }, { "key": "isrc", "value": "{{isrc}}", "description": "The ISRC of the track being requested *", "disabled": true }, { "key": "source", "value": "{{source}}", "description": "Specifies the sources that data is being requested for. Can be a comma separated list of individual sources or be set to 'all'." }, { "key": "songstats_artist_id", "value": "{{songstats_artist_id}}", "description": "The Songstats ID of the artist being requested *", "disabled": true }, { "key": "spotify_artist_id", "value": "{{spotify_artist_id}}", "description": "The Spotify ID of the artist being requested *", "disabled": true }, { "key": "apple_music_artist_id", "value": "{{apple_music_artist_id}}", "description": "The Apple Music ID of the artist being requested *", "disabled": true }, { "key": "limit", "value": "{{limit}}", "description": "Specifies the limit of results being returned.", "disabled": true }, { "key": "offset", "value": "{{offset}}", "description": "Specifies the offset of the limited results being returned.", "disabled": true }, { "key": "milestones", "value": "{{milestones}}", "description": "Include Milestone Activities.", "disabled": true }, { "key": "albums", "value": "{{albums}}", "description": "Include Album Activities.", "disabled": true }, { "key": "editorial", "value": "{{editorial}}", "description": "Only include Editorial Activities.", "disabled": true }, { "key": "tier", "value": "{{tier}}", "description": "Filter Activities by importance. Tier 4 is the lowest tier that returns all activities. Tier 1 is the highest tier that returns only the most significant activities.", "disabled": true }, { "key": "comments", "value": "{{comments}}", "description": "Include Comment Activities.", "disabled": true }, { "key": "apple_music_track_id", "value": "{{apple_music_track_id}}", "description": "The Apple Music ID of the track being requested *", "disabled": true } ] }, "description": "Returns the latest activities of a track filtered by source.\nGenerated from docs/songstats_api_openapi.yaml.\n\nQuery parameters:\n- songstats_track_id (optional): The Songstats ID of the track being requested * Example: k4bp9etx.\n- spotify_track_id (optional): The Spotify ID of the track being requested * Example: 1YLGtZjDKyY0Qkv4QlX31b.\n- isrc (optional): The ISRC of the track being requested * Example: GBAYE2100626.\n- source (required): Specifies the sources that data is being requested for. Can be a comma separated list of individual sources or be set to 'all'. Example: spotify,apple_music,deezer.\n- songstats_artist_id (optional): The Songstats ID of the artist being requested * Example: pod5zlug.\n- spotify_artist_id (optional): The Spotify ID of the artist being requested * Example: 28j8lBWDdDSHSSt5oPlsX2.\n- apple_music_artist_id (optional): The Apple Music ID of the artist being requested * Example: 261545033.\n- limit (optional): Specifies the limit of results being returned. Example: 20.\n- offset (optional): Specifies the offset of the limited results being returned. Example: 20.\n- milestones (optional): Include Milestone Activities. Example: true.\n- albums (optional): Include Album Activities. Example: true.\n- editorial (optional): Only include Editorial Activities. Example: false.\n- tier (optional): Filter Activities by importance. Tier 4 is the lowest tier that returns all activities. Tier 1 is the highest tier that returns only the most significant activities. Example: 4.\n- comments (optional): Include Comment Activities. Example: true.\n- apple_music_track_id (optional): The Apple Music ID of the track being requested * Example: 1567644047.\n\nHeaders:\n- Accept-Encoding: gzip, deflate, br\n\nDocumented responses: 200, 400, 401, 403, 404, 429, 500, 502, 503." }, "response": [] }, { "name": "Get Track Current Stats", "request": { "method": "GET", "header": [ { "key": "Accept-Encoding", "value": "{{accept_encoding}}", "description": "gzip, deflate, br", "type": "text" } ], "url": { "raw": "{{base_url}}/tracks/stats?source={{source}}&songstats_track_id={{songstats_track_id}}", "host": [ "{{base_url}}" ], "path": [ "tracks", "stats" ], "query": [ { "key": "source", "value": "{{source}}", "description": "Specifies the sources that data is being requested for. Can be a comma separated list of individual sources or be set to 'all'." }, { "key": "isrc", "value": "{{isrc}}", "description": "The ISRC of the track being requested *", "disabled": true }, { "key": "songstats_track_id", "value": "{{songstats_track_id}}", "description": "The Songstats ID of the track being requested *" }, { "key": "spotify_track_id", "value": "{{spotify_track_id}}", "description": "The Spotify ID of the track being requested *", "disabled": true }, { "key": "with_links", "value": "{{with_links}}", "description": "Includes an array of all of the source links associated with the requested objected.", "disabled": true }, { "key": "with_playlists", "value": "{{with_playlists}}", "description": "Includes an array of all of the playlists associated to the track.", "disabled": true }, { "key": "with_charts", "value": "{{with_charts}}", "description": "Includes an array of all of the charts associated to the track.", "disabled": true }, { "key": "with_videos", "value": "{{with_videos}}", "description": "Includes an array of all of the videos currently associated to the track.", "disabled": true }, { "key": "spotify_artist_id", "value": "{{spotify_artist_id}}", "description": "The Spotify ID of the artist being requested *", "disabled": true }, { "key": "apple_music_artist_id", "value": "{{apple_music_artist_id}}", "description": "The Apple Music ID of the artist being requested *", "disabled": true }, { "key": "songstats_artist_id", "value": "{{songstats_artist_id}}", "description": "The Songstats ID of the artist being requested *", "disabled": true }, { "key": "with_stations", "value": "{{with_stations}}", "description": "Includes an array of all of the radio stations currently associated to the track.", "disabled": true }, { "key": "limit", "value": "{{limit}}", "description": "Specifies the limit of results being returned.", "disabled": true }, { "key": "offset", "value": "{{offset}}", "description": "Specifies the offset of the limited results being returned.", "disabled": true }, { "key": "apple_music_track_id", "value": "{{apple_music_track_id}}", "description": "The Apple Music ID of the track being requested *", "disabled": true }, { "key": "only_current", "value": "{{only_current}}", "description": "Only return the playlists and charts the track is currently positioned in.", "disabled": true } ] }, "description": "Returns summary and detailed information of a track filtered by source.\n\n-----------\n\nNOTE: For Artist/Label API Keys, please make sure to always include either the `songstats_artist_id` or `spotify_artist_id` parameter.\nGenerated from docs/songstats_api_openapi.yaml.\n\nQuery parameters:\n- source (required): Specifies the sources that data is being requested for. Can be a comma separated list of individual sources or be set to 'all'. Example: spotify,apple_music,deezer.\n- isrc (optional): The ISRC of the track being requested * Example: GBAYE2100626.\n- songstats_track_id (optional): The Songstats ID of the track being requested * Example: k4bp9etx.\n- spotify_track_id (optional): The Spotify ID of the track being requested * Example: 1YLGtZjDKyY0Qkv4QlX31b.\n- with_links (optional): Includes an array of all of the source links associated with the requested objected. Example: true.\n- with_playlists (optional): Includes an array of all of the playlists associated to the track. Example: true.\n- with_charts (optional): Includes an array of all of the charts associated to the track. Example: true.\n- with_videos (optional): Includes an array of all of the videos currently associated to the track. Example: true.\n- spotify_artist_id (optional): The Spotify ID of the artist being requested * Example: 28j8lBWDdDSHSSt5oPlsX2.\n- apple_music_artist_id (optional): The Apple Music ID of the artist being requested * Example: 261545033.\n- songstats_artist_id (optional): The Songstats ID of the artist being requested * Example: pod5zlug.\n- with_stations (optional): Includes an array of all of the radio stations currently associated to the track. Example: true.\n- limit (optional): Specifies the limit of results being returned. Example: 20.\n- offset (optional): Specifies the offset of the limited results being returned. Example: 20.\n- apple_music_track_id (optional): The Apple Music ID of the track being requested * Example: 1567644047.\n- only_current (optional): Only return the playlists and charts the track is currently positioned in. Example: true.\n\nHeaders:\n- Accept-Encoding: gzip, deflate, br\n\nDocumented responses: 200, 400, 401, 403, 404, 429, 500, 502, 503." }, "response": [] }, { "name": "Get Track Historic Stats", "request": { "method": "GET", "header": [ { "key": "Accept-Encoding", "value": "{{accept_encoding}}", "description": "gzip, deflate, br", "type": "text" } ], "url": { "raw": "{{base_url}}/tracks/historic_stats?source={{source}}&songstats_track_id={{songstats_track_id}}", "host": [ "{{base_url}}" ], "path": [ "tracks", "historic_stats" ], "query": [ { "key": "source", "value": "{{source}}", "description": "Specifies the sources that data is being requested for. Can be a comma separated list of individual sources or be set to 'all'." }, { "key": "isrc", "value": "{{isrc}}", "description": "The ISRC of the track being requested *", "disabled": true }, { "key": "songstats_track_id", "value": "{{songstats_track_id}}", "description": "The Songstats ID of the track being requested *" }, { "key": "spotify_track_id", "value": "{{spotify_track_id}}", "description": "The Spotify ID of the track being requested *", "disabled": true }, { "key": "start_date", "value": "{{start_date}}", "description": "Specifies the start_date of the historic data that is being requested.", "disabled": true }, { "key": "end_date", "value": "{{end_date}}", "description": "Specifies the end_date of the historic data that is being requested.", "disabled": true }, { "key": "with_aggregates", "value": "{{with_aggregates}}", "description": "Includes data points aggregated by Songstats like playlists_current, playlists_reach_current, charts_current, etc.", "disabled": true }, { "key": "spotify_artist_id", "value": "{{spotify_artist_id}}", "description": "The Spotify ID of the artist being requested *", "disabled": true }, { "key": "apple_music_artist_id", "value": "{{apple_music_artist_id}}", "description": "The Apple Music ID of the artist being requested *", "disabled": true }, { "key": "songstats_artist_id", "value": "{{songstats_artist_id}}", "description": "The Songstats ID of the artist being requested *", "disabled": true }, { "key": "apple_music_track_id", "value": "{{apple_music_track_id}}", "description": "The Apple Music ID of the track being requested *", "disabled": true } ] }, "description": "Returns historic information of a track filtered by source.\n\n-----------\n\nNOTE: For Artist/Label API Keys, please make sure to always include either the `songstats_artist_id` or `spotify_artist_id` parameter.\nGenerated from docs/songstats_api_openapi.yaml.\n\nQuery parameters:\n- source (required): Specifies the sources that data is being requested for. Can be a comma separated list of individual sources or be set to 'all'. Example: spotify,apple_music,deezer.\n- isrc (optional): The ISRC of the track being requested * Example: GBAYE2100626.\n- songstats_track_id (optional): The Songstats ID of the track being requested * Example: k4bp9etx.\n- spotify_track_id (optional): The Spotify ID of the track being requested * Example: 1YLGtZjDKyY0Qkv4QlX31b.\n- start_date (optional): Specifies the start_date of the historic data that is being requested. Example: 2021-12-31.\n- end_date (optional): Specifies the end_date of the historic data that is being requested. Example: 2022-01-16.\n- with_aggregates (optional): Includes data points aggregated by Songstats like playlists_current, playlists_reach_current, charts_current, etc. Example: true.\n- spotify_artist_id (optional): The Spotify ID of the artist being requested * Example: 28j8lBWDdDSHSSt5oPlsX2.\n- apple_music_artist_id (optional): The Apple Music ID of the artist being requested * Example: 261545033.\n- songstats_artist_id (optional): The Songstats ID of the artist being requested * Example: pod5zlug.\n- apple_music_track_id (optional): The Apple Music ID of the track being requested * Example: 1567644047.\n\nHeaders:\n- Accept-Encoding: gzip, deflate, br\n\nDocumented responses: 200, 400, 401, 403, 404, 429, 500, 502, 503." }, "response": [] }, { "name": "Get Track Locations", "request": { "method": "GET", "header": [ { "key": "Accept-Encoding", "value": "{{accept_encoding}}", "description": "gzip, deflate, br", "type": "text" } ], "url": { "raw": "{{base_url}}/tracks/locations?source={{source}}&songstats_track_id={{songstats_track_id}}", "host": [ "{{base_url}}" ], "path": [ "tracks", "locations" ], "query": [ { "key": "source", "value": "{{source}}", "description": "Specifies the sources that data is being requested for. Can be a comma separated list of individual sources or be set to 'all'." }, { "key": "isrc", "value": "{{isrc}}", "description": "The ISRC of the track being requested *", "disabled": true }, { "key": "songstats_track_id", "value": "{{songstats_track_id}}", "description": "The Songstats ID of the track being requested *" }, { "key": "spotify_track_id", "value": "{{spotify_track_id}}", "description": "The Spotify ID of the track being requested *", "disabled": true }, { "key": "spotify_artist_id", "value": "{{spotify_artist_id}}", "description": "The Spotify ID of the artist being requested *", "disabled": true }, { "key": "apple_music_artist_id", "value": "{{apple_music_artist_id}}", "description": "The Apple Music ID of the artist being requested *", "disabled": true }, { "key": "songstats_artist_id", "value": "{{songstats_artist_id}}", "description": "The Songstats ID of the artist being requested *", "disabled": true }, { "key": "apple_music_track_id", "value": "{{apple_music_track_id}}", "description": "The Apple Music ID of the track being requested *", "disabled": true } ] }, "description": "Returns country / city based location information of a track filtered by source.\n\n-----------\n\nNOTE: For Artist/Label API Keys, please make sure to always include either the `songstats_artist_id` or `spotify_artist_id` parameter.\nGenerated from docs/songstats_api_openapi.yaml.\n\nQuery parameters:\n- source (required): Specifies the sources that data is being requested for. Can be a comma separated list of individual sources or be set to 'all'. Example: spotify,apple_music,deezer.\n- isrc (optional): The ISRC of the track being requested * Example: GBAYE2100626.\n- songstats_track_id (optional): The Songstats ID of the track being requested * Example: k4bp9etx.\n- spotify_track_id (optional): The Spotify ID of the track being requested * Example: 1YLGtZjDKyY0Qkv4QlX31b.\n- spotify_artist_id (optional): The Spotify ID of the artist being requested * Example: 28j8lBWDdDSHSSt5oPlsX2.\n- apple_music_artist_id (optional): The Apple Music ID of the artist being requested * Example: 261545033.\n- songstats_artist_id (optional): The Songstats ID of the artist being requested * Example: pod5zlug.\n- apple_music_track_id (optional): The Apple Music ID of the track being requested * Example: 1567644047.\n\nHeaders:\n- Accept-Encoding: gzip, deflate, br\n\nDocumented responses: 200, 400, 401, 403, 404, 429, 500, 502, 503." }, "response": [] }, { "name": "Get Track Comments", "request": { "method": "GET", "header": [ { "key": "Accept-Encoding", "value": "{{accept_encoding}}", "description": "gzip, deflate, br", "type": "text" } ], "url": { "raw": "{{base_url}}/tracks/comments?songstats_track_id={{songstats_track_id}}&source={{source}}", "host": [ "{{base_url}}" ], "path": [ "tracks", "comments" ], "query": [ { "key": "isrc", "value": "{{isrc}}", "description": "The ISRC of the track being requested *", "disabled": true }, { "key": "songstats_track_id", "value": "{{songstats_track_id}}", "description": "The Songstats ID of the track being requested *" }, { "key": "spotify_track_id", "value": "{{spotify_track_id}}", "description": "The Spotify ID of the track being requested *", "disabled": true }, { "key": "source", "value": "{{source}}", "description": "Specifies the sources that data is being requested for. Can be a comma separated list of individual sources or be set to 'all'." }, { "key": "apple_music_track_id", "value": "{{apple_music_track_id}}", "description": "The Apple Music ID of the track being requested *", "disabled": true } ] }, "description": "Returns sentiment, keywords and comments of a track.\nGenerated from docs/songstats_api_openapi.yaml.\n\nQuery parameters:\n- isrc (optional): The ISRC of the track being requested * Example: GBAYE2100626.\n- songstats_track_id (optional): The Songstats ID of the track being requested * Example: k4bp9etx.\n- spotify_track_id (optional): The Spotify ID of the track being requested * Example: 1YLGtZjDKyY0Qkv4QlX31b.\n- source (required): Specifies the sources that data is being requested for. Can be a comma separated list of individual sources or be set to 'all'. Example: youtube,soundcloud.\n- apple_music_track_id (optional): The Apple Music ID of the track being requested * Example: 1567644047.\n\nHeaders:\n- Accept-Encoding: gzip, deflate, br\n\nDocumented responses: 200, 400, 401, 403, 404, 429, 500, 502, 503." }, "response": [] }, { "name": "Get Track Songshare", "request": { "method": "GET", "header": [ { "key": "Accept-Encoding", "value": "{{accept_encoding}}", "description": "gzip, deflate, br", "type": "text" } ], "url": { "raw": "{{base_url}}/tracks/songshare?songstats_track_id={{songstats_track_id}}", "host": [ "{{base_url}}" ], "path": [ "tracks", "songshare" ], "query": [ { "key": "isrc", "value": "{{isrc}}", "description": "The ISRC of the track being requested *", "disabled": true }, { "key": "songstats_track_id", "value": "{{songstats_track_id}}", "description": "The Songstats ID of the track being requested *" }, { "key": "spotify_track_id", "value": "{{spotify_track_id}}", "description": "The Spotify ID of the track being requested *", "disabled": true }, { "key": "apple_music_track_id", "value": "{{apple_music_track_id}}", "description": "The Apple Music ID of the track being requested *", "disabled": true } ] }, "description": "Returns Songshare smart link information of a track.\nGenerated from docs/songstats_api_openapi.yaml.\n\nQuery parameters:\n- isrc (optional): The ISRC of the track being requested * Example: GBAYE2100626.\n- songstats_track_id (optional): The Songstats ID of the track being requested * Example: k4bp9etx.\n- spotify_track_id (optional): The Spotify ID of the track being requested * Example: 1YLGtZjDKyY0Qkv4QlX31b.\n- apple_music_track_id (optional): The Apple Music ID of the track being requested * Example: 1567644047.\n\nHeaders:\n- Accept-Encoding: gzip, deflate, br\n\nDocumented responses: 200, 400, 401, 403, 404, 429, 500, 502, 503." }, "response": [] }, { "name": "Search Track", "request": { "method": "GET", "header": [ { "key": "Accept-Encoding", "value": "{{accept_encoding}}", "description": "gzip, deflate, br", "type": "text" } ], "url": { "raw": "{{base_url}}/tracks/search?q={{search_query}}", "host": [ "{{base_url}}" ], "path": [ "tracks", "search" ], "query": [ { "key": "q", "value": "{{search_query}}", "description": "Search Query" }, { "key": "limit", "value": "{{limit}}", "description": "Specifies the limit of results being returned.", "disabled": true }, { "key": "offset", "value": "{{offset}}", "description": "Specifies the offset of the limited results being returned.", "disabled": true } ] }, "description": "Search for a track.\nGenerated from docs/songstats_api_openapi.yaml.\n\nQuery parameters:\n- q (required): Search Query\n- limit (optional): Specifies the limit of results being returned. Example: 20.\n- offset (optional): Specifies the offset of the limited results being returned. Example: 20.\n\nHeaders:\n- Accept-Encoding: gzip, deflate, br\n\nDocumented responses: 200, 400, 401, 403, 404, 429, 500, 502, 503." }, "response": [] }, { "name": "Add Track Link", "request": { "method": "POST", "header": [ { "key": "Accept-Encoding", "value": "{{accept_encoding}}", "description": "gzip, deflate, br", "type": "text" } ], "url": { "raw": "{{base_url}}/tracks/link_request?songstats_track_id={{songstats_track_id}}&link={{source_link}}", "host": [ "{{base_url}}" ], "path": [ "tracks", "link_request" ], "query": [ { "key": "isrc", "value": "{{isrc}}", "description": "The ISRC of the track being requested *", "disabled": true }, { "key": "songstats_track_id", "value": "{{songstats_track_id}}", "description": "The Songstats ID of the track being requested *" }, { "key": "spotify_track_id", "value": "{{spotify_track_id}}", "description": "The Spotify ID of the track being requested *", "disabled": true }, { "key": "link", "value": "{{source_link}}", "description": "Link to be added." }, { "key": "apple_music_track_id", "value": "{{apple_music_track_id}}", "description": "The Apple Music ID of the track being requested *", "disabled": true } ] }, "description": "Request for link to be added to a track.\nGenerated from docs/songstats_api_openapi.yaml.\n\nQuery parameters:\n- isrc (optional): The ISRC of the track being requested * Example: GBAYE2100626.\n- songstats_track_id (optional): The Songstats ID of the track being requested * Example: k4bp9etx.\n- spotify_track_id (optional): The Spotify ID of the track being requested * Example: 1YLGtZjDKyY0Qkv4QlX31b.\n- link (required): Link to be added. Example: https://soundcloud.com/dontblink/vibration.\n- apple_music_track_id (optional): The Apple Music ID of the track being requested * Example: 1567644047.\n\nHeaders:\n- Accept-Encoding: gzip, deflate, br\n\nDocumented responses: 200, 400, 401, 403, 404, 429, 500, 502, 503." }, "response": [] }, { "name": "Remove Track Link", "request": { "method": "DELETE", "header": [], "url": { "raw": "{{base_url}}/tracks/link_request?songstats_track_id={{songstats_track_id}}&link={{source_link}}", "host": [ "{{base_url}}" ], "path": [ "tracks", "link_request" ], "query": [ { "key": "isrc", "value": "{{isrc}}", "description": "The ISRC of the track being requested *", "disabled": true }, { "key": "songstats_track_id", "value": "{{songstats_track_id}}", "description": "The Songstats ID of the track being requested *" }, { "key": "spotify_track_id", "value": "{{spotify_track_id}}", "description": "The Spotify ID of the track being requested *", "disabled": true }, { "key": "link", "value": "{{source_link}}", "description": "Link to be deleted." }, { "key": "apple_music_track_id", "value": "{{apple_music_track_id}}", "description": "The Apple Music ID of the track being requested *", "disabled": true } ] }, "description": "Request for link to be removed from track.\nGenerated from docs/songstats_api_openapi.yaml.\n\nQuery parameters:\n- isrc (optional): The ISRC of the track being requested * Example: GBAYE2100626.\n- songstats_track_id (optional): The Songstats ID of the track being requested * Example: k4bp9etx.\n- spotify_track_id (optional): The Spotify ID of the track being requested * Example: 1YLGtZjDKyY0Qkv4QlX31b.\n- link (required): Link to be deleted. Example: https://soundcloud.com/dontblink/vibration.\n- apple_music_track_id (optional): The Apple Music ID of the track being requested * Example: 1567644047.\n\nDocumented responses: 200, 400, 401, 403, 404, 429, 500, 502, 503." }, "response": [] }, { "name": "Add Track To Member Relevant List", "request": { "method": "POST", "header": [], "url": { "raw": "{{base_url}}/tracks/add_to_member_relevant_list?songstats_track_id={{songstats_track_id}}", "host": [ "{{base_url}}" ], "path": [ "tracks", "add_to_member_relevant_list" ], "query": [ { "key": "songstats_track_id", "value": "{{songstats_track_id}}", "description": "Songstats track ID." } ] }, "description": "Adds the requested track source object to the Enterprise member relevant list.\nLive Rails route inferred from config/routes.rb and Enterprise controller behavior; this endpoint is not currently present in docs/songstats_api_openapi.yaml.\n\nQuery parameters:\n- songstats_track_id (required): Songstats track ID. Example: k4bp9etx.\n\nDocumented responses: 200, 300, 400, 401, 403, 429, 500." }, "response": [] }, { "name": "Remove Track From Member Relevant List", "request": { "method": "DELETE", "header": [], "url": { "raw": "{{base_url}}/tracks/remove_from_member_relevant_list?songstats_track_id={{songstats_track_id}}", "host": [ "{{base_url}}" ], "path": [ "tracks", "remove_from_member_relevant_list" ], "query": [ { "key": "songstats_track_id", "value": "{{songstats_track_id}}", "description": "Songstats track ID." } ] }, "description": "Removes the requested track source objects from the Enterprise member relevant list.\nLive Rails route inferred from config/routes.rb and Enterprise controller behavior; this endpoint is not currently present in docs/songstats_api_openapi.yaml.\n\nQuery parameters:\n- songstats_track_id (required): Songstats track ID. Example: k4bp9etx.\n\nDocumented responses: 200, 300, 400, 401, 403, 429, 500." }, "response": [] } ] }, { "name": "Stations", "item": [ { "name": "Add Station Request", "request": { "method": "POST", "header": [], "url": { "raw": "{{base_url}}/stations/station_request?radio_type={{radio_type}}&name={{station_name}}&country_code={{country_code}}&website={{station_website}}", "host": [ "{{base_url}}" ], "path": [ "stations", "station_request" ], "query": [ { "key": "radio_type", "value": "{{radio_type}}", "description": "Station type. Allowed values: radio, digital, sat_radio, tv." }, { "key": "name", "value": "{{station_name}}", "description": "Station name." }, { "key": "country_code", "value": "{{country_code}}", "description": "Two-letter country code." }, { "key": "website", "value": "{{station_website}}", "description": "Station website." }, { "key": "stream_url", "value": "{{station_stream_url}}", "description": "Optional stream URL.", "disabled": true }, { "key": "city_name", "value": "{{station_city_name}}", "description": "Optional station city.", "disabled": true }, { "key": "frequency", "value": "{{station_frequency}}", "description": "Optional broadcast frequency.", "disabled": true }, { "key": "contact", "value": "{{station_contact}}", "description": "Optional station contact.", "disabled": true }, { "key": "comment", "value": "{{station_comment}}", "description": "Optional request comment.", "disabled": true } ] }, "description": "Requests that Songstats add or monitor a radio, digital, satellite radio, or TV station.\nLive Rails route inferred from config/routes.rb and Enterprise controller behavior; this endpoint is not currently present in docs/songstats_api_openapi.yaml.\n\nQuery parameters:\n- radio_type (required): Station type. Allowed values: radio, digital, sat_radio, tv. Example: radio.\n- name (required): Station name. Example: Example FM.\n- country_code (required): Two-letter country code. Example: US.\n- website (required): Station website. Example: https://example.com.\n- stream_url (optional): Optional stream URL. Example: https://example.com/stream.\n- city_name (optional): Optional station city. Example: Los Angeles.\n- frequency (optional): Optional broadcast frequency. Example: 101.1.\n- contact (optional): Optional station contact. Example: programming@example.com.\n- comment (optional): Optional request comment. Example: Please add this station..\n\nDocumented responses: 200, 300, 400, 401, 403, 429, 500." }, "response": [] } ] } ] }