Skip to main content
GET
/
api
/
research
/
charts
cURL
curl --request GET \
  --url https://api.recoupable.com/api/research/charts
{
  "status": "success",
  "length": 123,
  "data": [
    {}
  ]
}

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

​
platform
string
required

Chart platform: spotify, applemusic, tiktok, youtube, itunes, shazam, etc.

Pattern: ^[a-z]+$
​
country
string
default:US

Two-letter ISO country code (e.g. US, GB, DE). Defaults to US if omitted.

Required string length: 2
Pattern: ^[A-Z]{2}$
​
interval
enum<string>
default:daily

Time interval: daily or weekly. Defaults to daily.

Available options:
daily,
weekly
​
type
enum<string>
default:regional

Chart type (e.g. regional, viral). Defaults to regional.

Available options:
regional,
viral
​
latest
boolean
default:true

Return only the latest chart. Defaults to true.

Response

Chart data

​
status
enum<string>
Available options:
success,
error
Example:

"success"

​
length
integer

Number of entries returned in data (typically 50).

​
data
object[]

Chart entries for the requested platform/type/country/interval combination. Entry shape varies by platform; common fields include track/artist names, ranks, and platform-specific metrics.