Songstats

opencollection: 1.0.0
info:
  name: Songstats Enterprise API
  version: 1.0.0
request:
  auth:
    type: apikey
    key: apikey
    value: '{{apikey}}'
    placement: header
items:
- info:
    name: Info
    type: folder
  items:
  - info:
      name: Get Available Sources
      type: http
    http:
      method: GET
      url: https://api.songstats.com/enterprise/v1/info/sources
    docs: Returns list of available streaming platform sources
  - info:
      name: Get API Status
      type: http
    http:
      method: GET
      url: https://api.songstats.com/enterprise/v1/info/status
    docs: Returns current API status
  - info:
      name: Get Field Definitions
      type: http
    http:
      method: GET
      url: https://api.songstats.com/enterprise/v1/info/definitions
    docs: Returns definitions for all data fields returned by the API
- 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
- info:
    name: Tracks
    type: folder
  items:
  - info:
      name: Get Track Info
      type: http
    http:
      method: GET
      url: https://api.songstats.com/enterprise/v1/tracks/info
      params:
      - name: songstats_track_id
        value: ''
        type: query
        description: Songstats track ID
      - name: isrc
        value: ''
        type: query
        description: International Standard Recording Code
      - name: spotify_track_id
        value: ''
        type: query
        description: Spotify track ID
    docs: Returns basic information about a track
  - info:
      name: Get Track Current Stats
      type: http
    http:
      method: GET
      url: https://api.songstats.com/enterprise/v1/tracks/stats
      params:
      - name: songstats_track_id
        value: ''
        type: query
        description: Songstats track ID
      - name: source
        value: ''
        type: query
        description: Streaming platform source filter
    docs: Returns summary and detailed information of a track filtered by source
  - info:
      name: Get Track Historic Stats
      type: http
    http:
      method: GET
      url: https://api.songstats.com/enterprise/v1/tracks/historic_stats
      params:
      - name: songstats_track_id
        value: ''
        type: query
        description: Songstats track 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 historic information of a track filtered by source
  - info:
      name: Search Tracks
      type: http
    http:
      method: GET
      url: https://api.songstats.com/enterprise/v1/tracks/search
      params:
      - name: q
        value: ''
        type: query
        description: Search query
    docs: Search for tracks by title or artist
  - info:
      name: Get Track Activities
      type: http
    http:
      method: GET
      url: https://api.songstats.com/enterprise/v1/tracks/activities
      params:
      - name: songstats_track_id
        value: ''
        type: query
        description: Songstats track ID
    docs: Returns recent activities for a track
  - info:
      name: Get Track Locations
      type: http
    http:
      method: GET
      url: https://api.songstats.com/enterprise/v1/tracks/locations
      params:
      - name: songstats_track_id
        value: ''
        type: query
        description: Songstats track ID
      - name: source
        value: ''
        type: query
        description: Streaming platform source filter
    docs: Returns geographic streaming location data for a track
  - info:
      name: Add Track Link Request
      type: http
    http:
      method: POST
      url: https://api.songstats.com/enterprise/v1/tracks/link_request
      body:
        type: json
        data: '{}'
    docs: Request a link to be added to a track
  - info:
      name: Remove Track Link Request
      type: http
    http:
      method: DELETE
      url: https://api.songstats.com/enterprise/v1/tracks/link_request
      params:
      - name: songstats_track_id
        value: ''
        type: query
      - name: link
        value: ''
        type: query
    docs: Request a link to be removed from a track
- info:
    name: Labels
    type: folder
  items:
  - info:
      name: Get Label Info
      type: http
    http:
      method: GET
      url: https://api.songstats.com/enterprise/v1/labels/info
      params:
      - name: songstats_label_id
        value: ''
        type: query
        description: Songstats label ID
      - name: label_name
        value: ''
        type: query
        description: Label name search
    docs: Returns basic information about a record label
  - info:
      name: Get Label Current Stats
      type: http
    http:
      method: GET
      url: https://api.songstats.com/enterprise/v1/labels/stats
      params:
      - name: songstats_label_id
        value: ''
        type: query
        description: Songstats label ID
      - name: source
        value: ''
        type: query
        description: Streaming platform source filter
    docs: Returns current statistics for a record label across streaming platforms
  - info:
      name: Get Label Historic Stats
      type: http
    http:
      method: GET
      url: https://api.songstats.com/enterprise/v1/labels/historic_stats
      params:
      - name: songstats_label_id
        value: ''
        type: query
        description: Songstats label ID
      - name: source
        value: ''
        type: query
        description: Streaming platform source filter
      - name: start_date
        value: ''
        type: query
        description: Start date
      - name: end_date
        value: ''
        type: query
        description: End date
    docs: Returns historical statistics for a record label
  - info:
      name: Get Label Audience
      type: http
    http:
      method: GET
      url: https://api.songstats.com/enterprise/v1/labels/audience
      params:
      - name: songstats_label_id
        value: ''
        type: query
        description: Songstats label ID
      - name: source
        value: ''
        type: query
        description: Streaming platform source filter
    docs: Returns audience data for a record label
  - info:
      name: Get Label Catalog
      type: http
    http:
      method: GET
      url: https://api.songstats.com/enterprise/v1/labels/catalog
      params:
      - name: songstats_label_id
        value: ''
        type: query
        description: Songstats label ID
    docs: Returns the track catalog of a record label
  - info:
      name: Search Labels
      type: http
    http:
      method: GET
      url: https://api.songstats.com/enterprise/v1/labels/search
      params:
      - name: q
        value: ''
        type: query
        description: Search query
    docs: Search for record labels by name
  - info:
      name: Get Label Top Tracks
      type: http
    http:
      method: GET
      url: https://api.songstats.com/enterprise/v1/labels/top_tracks
      params:
      - name: songstats_label_id
        value: ''
        type: query
        description: Songstats label ID
      - name: source
        value: ''
        type: query
        description: Streaming platform source filter
    docs: Returns top tracks for a record label
  - info:
      name: Add Label Track Request
      type: http
    http:
      method: POST
      url: https://api.songstats.com/enterprise/v1/labels/track_request
      body:
        type: json
        data: '{}'
    docs: Request for a track to be added to a label catalog
  - info:
      name: Remove Label Track Request
      type: http
    http:
      method: DELETE
      url: https://api.songstats.com/enterprise/v1/labels/track_request
      params:
      - name: songstats_label_id
        value: ''
        type: query
      - name: songstats_track_id
        value: ''
        type: query
    docs: Request for a track to be removed from a label catalog
  - info:
      name: Add Label Link Request
      type: http
    http:
      method: POST
      url: https://api.songstats.com/enterprise/v1/labels/link_request
      body:
        type: json
        data: '{}'
    docs: Request a link to be added to a record label
  - info:
      name: Remove Label Link Request
      type: http
    http:
      method: DELETE
      url: https://api.songstats.com/enterprise/v1/labels/link_request
      params:
      - name: songstats_label_id
        value: ''
        type: query
      - name: link
        value: ''
        type: query
    docs: Request a link to be removed from a record label
- info:
    name: Collaborators
    type: folder
  items:
  - info:
      name: Get Collaborator Info
      type: http
    http:
      method: GET
      url: https://api.songstats.com/enterprise/v1/collaborators/info
      params:
      - name: songstats_collaborator_id
        value: ''
        type: query
        description: Songstats collaborator ID
    docs: Returns basic information about a music collaborator (producer, songwriter, etc.)
  - info:
      name: Get Collaborator Current Stats
      type: http
    http:
      method: GET
      url: https://api.songstats.com/enterprise/v1/collaborators/stats
      params:
      - name: songstats_collaborator_id
        value: ''
        type: query
        description: Songstats collaborator ID
      - name: source
        value: ''
        type: query
        description: Streaming platform source filter
    docs: Returns current statistics for a music collaborator
  - info:
      name: Get Collaborator Catalog
      type: http
    http:
      method: GET
      url: https://api.songstats.com/enterprise/v1/collaborators/catalog
      params:
      - name: songstats_collaborator_id
        value: ''
        type: query
        description: Songstats collaborator ID
    docs: Returns the track catalog of a collaborator
  - info:
      name: Search Collaborators
      type: http
    http:
      method: GET
      url: https://api.songstats.com/enterprise/v1/collaborators/search
      params:
      - name: q
        value: ''
        type: query
        description: Search query
    docs: Search for music collaborators by name
  - info:
      name: Get Collaborator Top Tracks
      type: http
    http:
      method: GET
      url: https://api.songstats.com/enterprise/v1/collaborators/top_tracks
      params:
      - name: songstats_collaborator_id
        value: ''
        type: query
        description: Songstats collaborator ID
      - name: source
        value: ''
        type: query
        description: Streaming platform source filter
    docs: Returns top tracks for a collaborator
bundled: true