Get Stream Counts Of A Track

Request

GET /track/v1/analysis/{track_id}

Parameter

HEADER PARAMETER VALUE
Content-Type Required Set to application/json
Accept-Language Such as zh-CN,en-US... default en
app_id Required The app ID provided to you by Boomplay when you register your application.
Authorization Required Access Token
REQUEST PARAMETER VALUE
track_id Required integer
The Boomplay ID for the track. Example value: 123

Responses Body

Body

code (integer) required
desc (string)
data (object)

track_id (integer) The Boomplay ID for the track.
track_title (string) The Boomplay title for the track.

segments array of objects.

date (string) The Data collection date

valid_plays array of objects.

country_code (string) The Data from country
plays (integer) Number of plays

invalid_plays array of objects.

country_code (string) The Data from country
plays (integer) Number of plays

album (object)

album_id (integer) The Boomplay ID for the album.
album_title (string) The Boomplay title for the album.

segments array of objects.

date (string) The Data collection date

valid_plays array of objects.

country_code (string) The Data from country
plays (integer) Number of plays

invalid_plays array of objects.

country_code (string) The Data from country
plays (integer) Number of plays

Request Sample

GET /track/v1/analysis/123 HTTP/1.1
Authorization: ${authorization}
app_id: ${app_id}
Host: openapi.boomplay.com

Response Example

{
  "desc": null,
  "code": 0,
  "data": {
    "track_id": 872866,
    "track_title": "Down by the Bay",
    "segments": [
      {
        "date": "2022-02-22",
        "valid_plays": [
          {
            "country_code": "Global",
            "plays": 1
          },
          {
            "country_code": "TZ",
            "plays": 1
          }

        ],
        "invalid_plays": [
          {
            "country_code": "Global",
            "plays": 1
          },
          {
            "country_code": "TZ",
            "plays": 1
          }

        ]
      }
    ],
    "album": {
      "album_id": 332879,
      "album_title": "Mother Goose Club Sings Nursery Rhymes, Vol. 7: Kids Sing & Learn",
      "segments": [
        {
          "date": "2022-02-22",
          "valid_plays": [
            {
              "country_code": "Global",
              "plays": 12
            },
            {
              "country_code": "PH",
              "plays": 12
            }
          ],
          "invalid_plays": [
            {
              "country_code": "Global",
              "plays": 5
            },
            {
              "country_code": "TZ",
              "plays": 5
            }
          ]
        }
      ]
    }
  }
}

results matching ""

    No results matching ""