Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.mindcase.co/llms.txt

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

$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

​
musics
array
required
List · TikTok music URLs (e.g. https://www.tiktok.com/music/Oh-No-Instrumental-…). One per line.
​
maxResults
integer
default:100
Number · Posts to scrape per music URL. Use 0 for all.

​
Response columns

FieldDisplay nameType
soundUrlSound URLurl
videoUrlVideo URLurl
captionCaptiontext
postedPostedtext
soundSearchedSound Searchedtext
soundTotalVideosSound Total Videostext
songSongtext
albumAlbumtext
artistArtisttext
originalAudioOriginal Audioboolean
playsPlaysnumber
likesLikesnumber
commentsCommentsnumber
sharesSharesnumber
savesSavesnumber
authorUrlAuthor URLurl
authorUsernameAuthor Usernametext
authorNameAuthor Nametext
authorFollowersAuthor Followersnumber
authorVerifiedAuthor Verifiedboolean
videoCoverVideo Coverurl
durationSDuration (s)number
definitionDefinitiontext
topHashtagTop Hashtagtext
effectEffecttext
mentionsMentionstext
isAdIs Adboolean
pinnedPinnedboolean
slideshowSlideshowboolean
languageLanguagetext
authorAvatarAuthor Avatarurl

​
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
  }
}'

​
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"
    }
  ]
}