Probably
Start free
Docs

List trending sounds

list_trending_sounds, in Reads: Any connection or key may call these.

POST
/api/v1/tools/list_trending_sounds

TikTok's trending sounds from a market's latest charts (the US by default): top, the most used, and viral, rising fastest, or the one board names. Each sound has its ID (which save_sound takes), rank, its move since the chart before, title, artist, length, and how many posts use it. A chart's day is when it was read; stale marks an old one.

Authorization

apiKey
headerAuthorizationBearer <token>

An API key (prb_…) from Settings → Connections.

Request Body

application/json
  1. body
country?string
Default"US"
Value in"US""CA""DE""FR""BR""MX""JP"
board?string
Value in"top""viral"

Response Body

The tool's answer.

application/json
  1. response
charts*array<>
curl -X POST 'https://probably.co/api/v1/tools/list_trending_sounds' \  -H "Authorization: Bearer $PROBABLY_API_KEY" \  -H 'Content-Type: application/json' \  -d '{}'
{  "charts": [    {      "board": "top",      "country": "US",      "day": "string",      "stale": true,      "sounds": [        {          "soundId": "string",          "page": "string",          "rank": 0,          "move": {            "kind": "up",            "places": 0          },          "title": "string",          "artist": "string",          "durationMs": 0,          "uses": 0        }      ]    }  ]}