{
  "opencollection": "1.0.0",
  "info": {
    "name": "Songstats Enterprise Artists API",
    "version": "1.0.0"
  },
  "request": {
    "auth": {
      "type": "apikey",
      "key": "apikey",
      "value": "{{apikey}}",
      "placement": "header"
    }
  },
  "items": [
    {
      "info": {
        "name": "Artists",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "Get Artist Info",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.songstats.com/enterprise/v1/artists/info",
            "params": [
              {
                "name": "songstats_artist_id",
                "value": "",
                "type": "query",
                "description": "Songstats artist ID"
              },
              {
                "name": "spotify_artist_id",
                "value": "",
                "type": "query",
                "description": "Spotify artist ID"
              },
              {
                "name": "apple_music_artist_id",
                "value": "",
                "type": "query",
                "description": "Apple Music artist ID"
              }
            ]
          },
          "docs": "Returns basic information about an artist"
        },
        {
          "info": {
            "name": "Get Artist Current Stats",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.songstats.com/enterprise/v1/artists/stats",
            "params": [
              {
                "name": "songstats_artist_id",
                "value": "",
                "type": "query",
                "description": "Songstats artist ID"
              },
              {
                "name": "source",
                "value": "",
                "type": "query",
                "description": "Streaming platform source filter"
              }
            ]
          },
          "docs": "Returns current statistics for an artist filtered by source"
        },
        {
          "info": {
            "name": "Get Artist Historic Stats",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.songstats.com/enterprise/v1/artists/historic_stats",
            "params": [
              {
                "name": "songstats_artist_id",
                "value": "",
                "type": "query",
                "description": "Songstats artist ID"
              },
              {
                "name": "source",
                "value": "",
                "type": "query",
                "description": "Streaming platform source filter"
              },
              {
                "name": "start_date",
                "value": "",
                "type": "query",
                "description": "Start date for historical data"
              },
              {
                "name": "end_date",
                "value": "",
                "type": "query",
                "description": "End date for historical data"
              }
            ]
          },
          "docs": "Returns historical statistics for an artist filtered by source"
        },
        {
          "info": {
            "name": "Get Artist Audience",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.songstats.com/enterprise/v1/artists/audience",
            "params": [
              {
                "name": "songstats_artist_id",
                "value": "",
                "type": "query",
                "description": "Songstats artist ID"
              },
              {
                "name": "source",
                "value": "",
                "type": "query",
                "description": "Streaming platform source filter"
              }
            ]
          },
          "docs": "Returns audience data for an artist"
        },
        {
          "info": {
            "name": "Get Artist Audience Details",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.songstats.com/enterprise/v1/artists/audience/details",
            "params": [
              {
                "name": "songstats_artist_id",
                "value": "",
                "type": "query",
                "description": "Songstats artist ID"
              },
              {
                "name": "source",
                "value": "",
                "type": "query",
                "description": "Streaming platform source filter"
              },
              {
                "name": "country_code",
                "value": "",
                "type": "query",
                "description": "ISO 3166-1 alpha-2 country code"
              }
            ]
          },
          "docs": "Returns detailed audience insights for an artist in a specific country"
        },
        {
          "info": {
            "name": "Get Artist Catalog",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.songstats.com/enterprise/v1/artists/catalog",
            "params": [
              {
                "name": "songstats_artist_id",
                "value": "",
                "type": "query",
                "description": "Songstats artist ID"
              }
            ]
          },
          "docs": "Returns the track catalog of an artist ordered by release date"
        },
        {
          "info": {
            "name": "Search Artists",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.songstats.com/enterprise/v1/artists/search",
            "params": [
              {
                "name": "q",
                "value": "",
                "type": "query",
                "description": "Search query"
              }
            ]
          },
          "docs": "Search for artists by name"
        },
        {
          "info": {
            "name": "Get Artist Top Tracks",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.songstats.com/enterprise/v1/artists/top_tracks",
            "params": [
              {
                "name": "songstats_artist_id",
                "value": "",
                "type": "query",
                "description": "Songstats artist ID"
              },
              {
                "name": "source",
                "value": "",
                "type": "query",
                "description": "Streaming platform source filter"
              }
            ]
          },
          "docs": "Returns the top tracks of an artist sorted by rank type"
        },
        {
          "info": {
            "name": "Get Artist Top Playlists",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.songstats.com/enterprise/v1/artists/top_playlists",
            "params": [
              {
                "name": "songstats_artist_id",
                "value": "",
                "type": "query",
                "description": "Songstats artist ID"
              },
              {
                "name": "source",
                "value": "",
                "type": "query",
                "description": "Streaming platform source filter"
              }
            ]
          },
          "docs": "Returns top playlists featuring the artist"
        },
        {
          "info": {
            "name": "Get Artist Activities",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.songstats.com/enterprise/v1/artists/activities",
            "params": [
              {
                "name": "songstats_artist_id",
                "value": "",
                "type": "query",
                "description": "Songstats artist ID"
              }
            ]
          },
          "docs": "Returns recent activities for an artist"
        },
        {
          "info": {
            "name": "Add Artist Link Request",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://api.songstats.com/enterprise/v1/artists/link_request",
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Request a link to be added to an artist"
        },
        {
          "info": {
            "name": "Remove Artist Link Request",
            "type": "http"
          },
          "http": {
            "method": "DELETE",
            "url": "https://api.songstats.com/enterprise/v1/artists/link_request",
            "params": [
              {
                "name": "songstats_artist_id",
                "value": "",
                "type": "query"
              },
              {
                "name": "link",
                "value": "",
                "type": "query"
              }
            ]
          },
          "docs": "Request a link to be removed from an artist"
        },
        {
          "info": {
            "name": "Add Artist Track Request",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://api.songstats.com/enterprise/v1/artists/track_request",
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Request for a track to be added to an artist catalog"
        },
        {
          "info": {
            "name": "Remove Artist Track Request",
            "type": "http"
          },
          "http": {
            "method": "DELETE",
            "url": "https://api.songstats.com/enterprise/v1/artists/track_request",
            "params": [
              {
                "name": "songstats_artist_id",
                "value": "",
                "type": "query"
              },
              {
                "name": "songstats_track_id",
                "value": "",
                "type": "query"
              }
            ]
          },
          "docs": "Request for a track to be removed from an artist catalog"
        }
      ]
    }
  ],
  "bundled": true
}