Ses

GET/v1/tiktok/song1 kredi

Kimliği verilen bir TikTok sesini döndürür: başlık, sanatçı, süre, kapak görseli, dinleme URL'si ve bu sesi kullanan video sayısı.

01Sorgu parametreleri

Ad	Tür	Açıklama
clipIdzorunlu	string	Sesin sayısal kimliği (`tiktok.com/music/...` URL'sinin sonundaki sayı veya bir videodaki `music.id`).

02İstek

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

03Yanıtlar

API'nin gerçek yanıtları. Listeler 2 öğeye kısaltılmıştır.

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

Tüm uç noktalarda ortak

Her rota bunları döndürebilir: eksik ya da hatalı anahtar, biten kredi, yanıt vermeyen platform ya da bizim tarafımızdaki bir hata. Hiçbiri kredi harcamaz.

GET /v1/cosmos/profile?handle=design

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

04Notlar

Ses `music_info` içindedir; `user_count` bu sesi kullanan video sayısıdır. Süreler tam saniye cinsindendir. Sayısal olmayan bir `clipId` ücretsiz 400, bilinmeyen bir ses ücretsiz 404 döner.

05Hatalar ve krediler

Her hatada success: false ve gerçek bir HTTP durum kodu döner; kredi düşmez.

400missing_parameter
Zorunlu bir parametre eksik veya geçersiz.
403private_account
Hesap gizli ya da yaş kısıtlamalı.
404not_found
Böyle bir hesap yok.
503upstream_error
Platform şu an cevap vermiyor; tekrar deneyin.