Skip to main content
GET
/
api
/
research
/
track
cURL
curl --request GET \
  --url https://api.recoupable.com/api/research/track
{
  "status": "<string>",
  "id": 123,
  "name": "<string>",
  "isrc": "<string>",
  "image_url": "<string>",
  "duration_ms": 123,
  "release_date": "<string>",
  "album_label": "<string>",
  "score": 123,
  "explicit": true,
  "artists": [
    {
      "id": 123,
      "name": "<string>",
      "image_url": "<string>"
    }
  ],
  "albums": [
    {
      "id": 123,
      "name": "<string>",
      "upc": "<string>",
      "release_date": "<string>",
      "label": "<string>",
      "image_url": "<string>",
      "popularity": 123
    }
  ],
  "genres": [
    {
      "id": 123,
      "name": "<string>"
    }
  ],
  "cm_statistics": {},
  "tempo": 123,
  "moods": [
    {}
  ],
  "activities": [
    {}
  ]
}

Documentation Index

Fetch the complete documentation index at: https://developers.recoupable.com/llms.txt

Use this file to discover all available pages before exploring further.

Query Parameters

id
string
required

Chartmetric track ID (positive integer). Obtain via GET /api/research with type=tracks&beta=true — beta-ranked search results include the id field directly.

Pattern: ^[1-9][0-9]*$
Example:

"15194376"

Response

Track metadata

Track metadata — title, artists, albums, release date, genres, popularity, and platform IDs. Only the most commonly-used fields are enumerated here; the upstream Chartmetric response includes additional fields (e.g. cm_statistics, activities, moods) that pass through under additionalProperties.

status
string
id
integer

Chartmetric track ID

name
string

Track title

isrc
string | null
image_url
string | null
duration_ms
integer | null
release_date
string | null

ISO date string

album_label
string | null
score
integer | null

Chartmetric track score

explicit
boolean | null
artists
object[]

Credited artists. Each entry is a Chartmetric artist object; at minimum id and name are populated.

albums
object[]

Albums the track appears on.

genres
object[]
cm_statistics
object

Chartmetric's aggregated cross-platform statistics for the track — Spotify popularity/streams, TikTok video counts, YouTube views, Shazam counts, Apple/Deezer/Amazon playlist reach, weekly deltas, etc. Fields are often null for less-popular tracks. Opaque object; inspect an actual response for the full field set.

tempo
number | null

Track tempo in BPM, when available.

moods
object[] | null

Chartmetric-inferred mood tags (e.g. Happy, Melancholic).

activities
object[] | null

Chartmetric-inferred activity tags (e.g. Workout, Studying).