$1.9 / 1k videos
Extract TikTok videos with their URLs, likes, country, video and music metadata, and creator data from sound URLs
Endpoint
POST /api/v1/agents/tiktok/sound/run
Parameters
array
required
List · TikTok music URLs (e.g. https://www.tiktok.com/music/Oh-No-Instrumental-…). One per line.
integer
default:100
Number · Posts to scrape per music URL. Use 0 for all.
Response columns
| Field | Display name | Type |
|---|---|---|
soundUrl | Sound URL | url |
videoUrl | Video URL | url |
caption | Caption | text |
posted | Posted | text |
soundSearched | Sound Searched | text |
soundTotalVideos | Sound Total Videos | text |
song | Song | text |
album | Album | text |
artist | Artist | text |
originalAudio | Original Audio | boolean |
plays | Plays | number |
likes | Likes | number |
comments | Comments | number |
shares | Shares | number |
saves | Saves | number |
authorUrl | Author URL | url |
authorUsername | Author Username | text |
authorName | Author Name | text |
authorFollowers | Author Followers | number |
authorVerified | Author Verified | boolean |
videoCover | Video Cover | url |
durationS | Duration (s) | number |
definition | Definition | text |
topHashtag | Top Hashtag | text |
effect | Effect | text |
mentions | Mentions | text |
isAd | Is Ad | boolean |
pinned | Pinned | boolean |
slideshow | Slideshow | boolean |
language | Language | text |
authorAvatar | Author Avatar | url |
Example
curl -X POST https://api.mindcase.co/api/v1/agents/tiktok/sound/run \
-H "Authorization: Bearer mk_live_abc123def456" \
-H "Content-Type: application/json" \
-d '{
"params": {
"musics": [
"https://www.tiktok.com/music/Oh-No-Instrumental-6889520563052645121"
],
"resultsPerPage": 10
}
}'
import requests
resp = requests.post(
"https://api.mindcase.co/api/v1/agents/tiktok/sound/run",
headers={"Authorization": "Bearer mk_live_abc123def456"},
json={"params": {
"musics": [
"https://www.tiktok.com/music/Oh-No-Instrumental-6889520563052645121"
],
"resultsPerPage": 10
}},
)
data = resp.json()
Example response
Response
{
"job_id": "job_7f3a2b1c",
"status": "completed",
"data": [
{
"soundUrl": "https://www.tiktok.com/music/Oh-No-Instrumental-6889520563052645121",
"videoUrl": "https://www.tiktok.com/@francescaspadola/video/7103242920618216710",
"caption": "#pov #sealion #animal",
"posted": "2022-05-29T19:30:23.000Z",
"soundSearched": "Oh-No-Instrumental-6889520563052645121",
"soundTotalVideos": "803200",
"song": "Oh No (Instrumental)",
"album": "Oh No (Instrumental)",
"artist": "Kreepa",
"originalAudio": false,
"plays": 56500000,
"likes": 8600000,
"comments": 56700,
"shares": 353400,
"saves": 496028,
"authorUrl": "https://www.tiktok.com/@francescaspadola",
"authorUsername": "francescaspadola",
"authorName": "Francesca Spadola",
"authorFollowers": 45200,
"authorVerified": false,
"videoCover": "https://p16-common-sign.tiktokcdn-us.com/tos-maliva-p-0068/047ffca09701434c8c1f345eb150162c~tplv-tiktokx-origin.image?dr=9636&x-expires=1777809600&x-signature=j9nqOySehopYRO3ukMivSsj0OXA%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=useast5",
"durationS": 8,
"definition": "540p",
"topHashtag": null,
"effect": null,
"mentions": [],
"isAd": false,
"pinned": false,
"slideshow": false,
"language": "un",
"authorAvatar": "https://p16-common-sign.tiktokcdn-us.com/tos-maliva-avt-0068/cbc26f60a2efffbbb55e24da5c071ef5~tplv-tiktokx-cropcenter:720:720.jpeg?dr=9640&refresh_token=e031f47f&x-expires=1777809600&x-signature=H92B9c5zaRM%2BV3bSCyQQm8SuxwU%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast5"
}
]
}