Song

GET/v1/tiktok/song1 credit

Returns a TikTok sound by its id: title, author, duration, cover art, play URL and the number of videos using it.

01Query parameters

Name	Type	Description
clipIdrequired	string	The sound's numeric id (the number at the end of a `tiktok.com/music/...` URL, or `music.id` in a video).

02Request

curl "https://api.scrapesocial.ai/v1/tiktok/song?clipId=7683266637168610079" \
  -H "x-api-key: $SCRAPESOCIAL_KEY"

03Responses

Real answers from the API. Lists are shortened to 2 items.

GET /v1/tiktok/song?clipId=7683266637168610079

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "music_info": {
    "album": "",
    "audition_duration": 68,
    "author": "TikTok",
    "avatar_medium": {
      "height": 720,
      "uri": "tos-maliva-avt-0068/ba67b11de451691939223e9d978e613a",
      "url_list": [
        "https://p16-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter:720:720.jpeg?dr=10399&refresh_token=a9b611e7&x-expires=1793120400&x-signature=6yycHu5bgD7BFszNWalKV7VsnA8%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast2b"
      ],
      "url_prefix": null,
      "width": 720
    },
    "avatar_thumb": {
      "height": 720,
      "uri": "tos-maliva-avt-0068/ba67b11de451691939223e9d978e613a",
      "url_list": [
        "https://p19-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter:100:100.jpeg?dr=10399&refresh_token=115553df&x-expires=1793120400&x-signature=kkcrWhLPQrQkoVjbw4QNj8qN%2F%2BE%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast2b"
      ],
      "url_prefix": null,
      "width": 720
    },
    "cover_large": {
      "height": 720,
      "uri": "tos-maliva-avt-0068/ba67b11de451691939223e9d978e613a",
      "url_list": [
        "https://p16-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=10399&refresh_token=67cf3807&x-expires=1793120400&x-signature=ioy3Ky6exQc6Vkit%2FzBwCE3idDg%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast2b"
      ],
      "url_prefix": null,
      "width": 720
    },
    "cover_medium": {
      "height": 720,
      "uri": "tos-maliva-avt-0068/ba67b11de451691939223e9d978e613a",
      "url_list": [
        "https://p16-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter:720:720.jpeg?dr=10399&refresh_token=a9b611e7&x-expires=1793120400&x-signature=6yycHu5bgD7BFszNWalKV7VsnA8%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast2b"
      ],
      "url_prefix": null,
      "width": 720
    },
    "cover_thumb": {
      "height": 720,
      "uri": "tos-maliva-avt-0068/ba67b11de451691939223e9d978e613a",
      "url_list": [
        "https://p19-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter:100:100.jpeg?dr=10399&refresh_token=115553df&x-expires=1793120400&x-signature=kkcrWhLPQrQkoVjbw4QNj8qN%2F%2BE%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast2b"
      ],
      "url_prefix": null,
      "width": 720
    },
    "duration": 68,
    "duration_high_precision": {
      "audition_duration_precision": 68,
      "duration_precision": 68,
      "shoot_duration_precision": 68,
      "video_duration_precision": 68
    },
    "id": 7683266637168610000,
    "id_str": "7683266637168610079",
    "is_commerce_music": true,
    "is_original_sound": true,
    "mid": "7683266637168610079",
    "owner_handle": "tiktok",
    "owner_id": "107955",
    "owner_nickname": "TikTok",
    "play_url": {
      "height": 720,
      "uri": "https://v45.tiktokcdn-eu.com/b2186007ab642cfff80da2562eac70de/6adf8966/video/tos/alisg/tos-alisg-v-2370c799-sg/ooeqefmFQiGgGAaI95LkfIAJQgA6IAFQcIAUAJ/?a=1233&bti=ODszNWYuMDE6&&bt=125&ft=cD1VS7z7ThWH0waCLGZmo0P&mime_type=audio_mpeg&rc=Mzc5Nm45cm06ZDMzaTU8NEBpMzc5Nm45cm06ZDMzaTU8NEA1c2gtMmRzMWRhLS1kMTJzYSM1c2gtMmRzMWRhLS1kMTJzcw%3D%3D&vvpl=1&l=20261025170850901E6FEEE86BA1232599&btag=e00055000&sp_exp…",
      "url_list": [
        "https://v45.tiktokcdn-eu.com/b2186007ab642cfff80da2562eac70de/6adf8966/video/tos/alisg/tos-alisg-v-2370c799-sg/ooeqefmFQiGgGAaI95LkfIAJQgA6IAFQcIAUAJ/?a=1233&bti=ODszNWYuMDE6&&bt=125&ft=cD1VS7z7ThWH0waCLGZmo0P&mime_type=audio_mpeg&rc=Mzc5Nm45cm06ZDMzaTU8NEBpMzc5Nm45cm06ZDMzaTU8NEA1c2gtMmRzMWRhLS1kMTJzYSM1c2gtMmRzMWRhLS1kMTJzcw%3D%3D&vvpl=1&l=20261025170850901E6FEEE86BA1232599&btag=e00055000&sp_exp…"
      ],
      "url_prefix": null,
      "width": 720
    },
    "prevent_download": false,
    "sec_uid": "MS4wLjABAAAAv7iSuuXDJGDvJkmH_vz1qkDZYo1apxgzaxdBSeIuPiM",
    "shoot_duration": 68,
    "title": "original sound - tiktok",
    "user_count": 15,
    "video_duration": 68
  }
}

Common to every endpoint

Any route can answer these: a missing or wrong key, no credits left, the platform not answering, or a failure on our side. None of them costs credits.

GET /v1/cosmos/profile?handle=design

{
  "success": false,
  "message": "Invalid API key"
}

04Notes

The sound is in `music_info`; `user_count` is the number of videos using it. Durations are in whole seconds. A non-numeric `clipId` is a free 400; an unknown sound is a free 404.

05Errors & credits

Every error has success: false, a real HTTP status and costs no credits.

400missing_parameter
A required parameter is missing or invalid.
403private_account
The account is private or age-restricted.
404not_found
No such account.
503upstream_error
The platform did not answer; retry shortly.