Video

GET/v2/tiktok/video1 kredi

Tek bir TikTok videosunun veya fotoğraf gönderisinin ayrıntılarını döndürür: açıklama, yazar, müzik, istatistikler ve video bilgileri; istenirse altyazısıyla birlikte.

01Sorgu parametreleri

Ad	Tür	Açıklama
urlzorunlu	string	Videonun URL'si (`tiktok.com/@kullanici/video/<id>`, bir fotoğraf gönderisi URL'si veya kısa paylaşım bağlantısı).
get_transcriptisteğe bağlı	boolean	Videonun kendi altyazısını da WebVTT olarak `transcript` alanında döndürür (videonun altyazısı yoksa null).Varsayılan: `false`
trimisteğe bağlı	boolean	Tam nesne yerine kısaltılmış bir nesne (kimlik, açıklama, istatistikler, video, yazar, tarihler ve URL) döndürür.Varsayılan: `false`
cache_max_ageisteğe bağlı	string	Uyumluluk için kabul edilir; her çağrı güncel veriyle yanıtlanır. Listede olmayan bir değer ücretsiz 400 hatası döner.Kabul edilen değerler:`1d3d7d14d30d`

02İstek

curl "https://api.scrapesocial.ai/v2/tiktok/video?url=https%3A%2F%2Fwww.tiktok.com%2F%40tiktok%2Fvideo%2F7683195368279985438" \
  -H "x-api-key: $SCRAPESOCIAL_KEY"

03Yanıtlar

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

GET /v2/tiktok/video?url=https%3A%2F%2Fwww.tiktok.com%2F%40tiktok%2Fvideo%2F7683195368279985438

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "aweme_detail": {
    "added_sound_music_info": {
      "author": "TikTok",
      "cover_large": {
        "data_size": 0,
        "height": 720,
        "uri": "tos-maliva-avt-0068/ba67b11de451691939223e9d978e613a",
        "url_list": [
          "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=995fbd26&x-expires=1793120400&x-signature=4Uln2LWthKdh0Hwbyegf4%2Fc6CXs%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my"
        ],
        "url_prefix": null,
        "width": 720
      },
      "cover_medium": {
        "data_size": 0,
        "height": 720,
        "uri": "tos-maliva-avt-0068/ba67b11de451691939223e9d978e613a",
        "url_list": [
          "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=bed6c8d0&x-expires=1793120400&x-signature=o7l8LcJLbNVmSGhfKlst0Rp06jw%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my"
        ],
        "url_prefix": null,
        "width": 720
      },
      "cover_thumb": {
        "data_size": 0,
        "height": 720,
        "uri": "tos-maliva-avt-0068/ba67b11de451691939223e9d978e613a",
        "url_list": [
          "https://p19-common-sign.tiktokcdn.com/tos-maliva-avt-0068/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=5ea31469&x-expires=1793120400&x-signature=5B7d2lrjChKlnOX2HnB7VfxtgBE%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my"
        ],
        "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": "7683266637168610079",
      "id_str": "7683266637168610079",
      "mid": "7683266637168610079",
      "play_url": {
        "data_size": 0,
        "height": 720,
        "uri": "https://v58.tiktokcdn.com/video/tos/alisg/tos-alisg-v-2370c799-sg/ooeqefmFQiGgGAaI95LkfIAJQgA6IAFQcIAUAJ/?a=1233&bti=ODszNWYuMDE6&&bt=125&ft=GcDrcInz7ThmQ4dGXq8Zmo&mime_type=audio_mpeg&rc=Mzc5Nm45cm06ZDMzaTU8NEBpMzc5Nm45cm06ZDMzaTU8NEA1c2gtMmRzMWRhLS1kMTJzYSM1c2gtMmRzMWRhLS1kMTJzcw%3D%3D&vvpl=1&l=2026102601085060DE589D4FBD3A57800B&VExpiration=1793034598&VSignature=bLC1u2TOt-TDhzuEr3yXlg&btag=e0005…",
        "url_list": [
          "https://v58.tiktokcdn.com/video/tos/alisg/tos-alisg-v-2370c799-sg/ooeqefmFQiGgGAaI95LkfIAJQgA6IAFQcIAUAJ/?a=1233&bti=ODszNWYuMDE6&&bt=125&ft=GcDrcInz7ThmQ4dGXq8Zmo&mime_type=audio_mpeg&rc=Mzc5Nm45cm06ZDMzaTU8NEBpMzc5Nm45cm06ZDMzaTU8NEA1c2gtMmRzMWRhLS1kMTJzYSM1c2gtMmRzMWRhLS1kMTJzcw%3D%3D&vvpl=1&l=2026102601085060DE589D4FBD3A57800B&VExpiration=1793034598&VSignature=bLC1u2TOt-TDhzuEr3yXlg&btag=e0005…"
        ],
        "url_prefix": null,
        "width": 720
      },
      "title": "original sound"
    },
    "author": {
      "avatar_larger": {
        "data_size": 0,
        "height": 720,
        "uri": "tos-maliva-avt-0068/ba67b11de451691939223e9d978e613a",
        "url_list": [
          "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=995fbd26&x-expires=1793120400&x-signature=4Uln2LWthKdh0Hwbyegf4%2Fc6CXs%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my"
        ],
        "url_prefix": null,
        "width": 720
      },
      "avatar_medium": {
        "data_size": 0,
        "height": 720,
        "uri": "tos-maliva-avt-0068/ba67b11de451691939223e9d978e613a",
        "url_list": [
          "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=bed6c8d0&x-expires=1793120400&x-signature=o7l8LcJLbNVmSGhfKlst0Rp06jw%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my"
        ],
        "url_prefix": null,
        "width": 720
      },
      "avatar_thumb": {
        "data_size": 0,
        "height": 720,
        "uri": "tos-maliva-avt-0068/ba67b11de451691939223e9d978e613a",
        "url_list": [
          "https://p19-common-sign.tiktokcdn.com/tos-maliva-avt-0068/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=5ea31469&x-expires=1793120400&x-signature=5B7d2lrjChKlnOX2HnB7VfxtgBE%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my"
        ],
        "url_prefix": null,
        "width": 720
      },
      "avatar_uri": "tos-maliva-avt-0068/ba67b11de451691939223e9d978e613a",
      "follower_count": 96400000,
      "following_count": 1,
      "nickname": "TikTok",
      "sec_uid": "MS4wLjABAAAAv7iSuuXDJGDvJkmH_vz1qkDZYo1apxgzaxdBSeIuPiM",
      "signature": "Your next discovery is waiting on TikTok.",
      "uid": "107955",
      "unique_id": "tiktok"
    },
    "author_user_id": 107955,
    "aweme_id": "7683195368279985438",
    "aweme_type": 0,
    "content_type": "video",
    "create_time": 1788883336,
    "desc": "hear how @Palina La Diva 🌐 spinning tracks on LIVE brings techno lovers together 🪩",
    "group_id": "7683195368279985438",
    "music": {
      "author": "TikTok",
      "cover_large": {
        "data_size": 0,
        "height": 720,
        "uri": "tos-maliva-avt-0068/ba67b11de451691939223e9d978e613a",
        "url_list": [
          "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=995fbd26&x-expires=1793120400&x-signature=4Uln2LWthKdh0Hwbyegf4%2Fc6CXs%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my"
        ],
        "url_prefix": null,
        "width": 720
      },
      "cover_medium": {
        "data_size": 0,
        "height": 720,
        "uri": "tos-maliva-avt-0068/ba67b11de451691939223e9d978e613a",
        "url_list": [
          "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=bed6c8d0&x-expires=1793120400&x-signature=o7l8LcJLbNVmSGhfKlst0Rp06jw%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my"
        ],
        "url_prefix": null,
        "width": 720
      },
      "cover_thumb": {
        "data_size": 0,
        "height": 720,
        "uri": "tos-maliva-avt-0068/ba67b11de451691939223e9d978e613a",
        "url_list": [
          "https://p19-common-sign.tiktokcdn.com/tos-maliva-avt-0068/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter:100:100.jpeg?dr=14579&refresh_token=5ea31469&x-expires=1793120400&x-signature=5B7d2lrjChKlnOX2HnB7VfxtgBE%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my"
        ],
        "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": "7683266637168610079",
      "id_str": "7683266637168610079",
      "mid": "7683266637168610079",
      "play_url": {
        "data_size": 0,
        "height": 720,
        "uri": "https://v58.tiktokcdn.com/video/tos/alisg/tos-alisg-v-2370c799-sg/ooeqefmFQiGgGAaI95LkfIAJQgA6IAFQcIAUAJ/?a=1233&bti=ODszNWYuMDE6&&bt=125&ft=GcDrcInz7ThmQ4dGXq8Zmo&mime_type=audio_mpeg&rc=Mzc5Nm45cm06ZDMzaTU8NEBpMzc5Nm45cm06ZDMzaTU8NEA1c2gtMmRzMWRhLS1kMTJzYSM1c2gtMmRzMWRhLS1kMTJzcw%3D%3D&vvpl=1&l=2026102601085060DE589D4FBD3A57800B&VExpiration=1793034598&VSignature=bLC1u2TOt-TDhzuEr3yXlg&btag=e0005…",
        "url_list": [
          "https://v58.tiktokcdn.com/video/tos/alisg/tos-alisg-v-2370c799-sg/ooeqefmFQiGgGAaI95LkfIAJQgA6IAFQcIAUAJ/?a=1233&bti=ODszNWYuMDE6&&bt=125&ft=GcDrcInz7ThmQ4dGXq8Zmo&mime_type=audio_mpeg&rc=Mzc5Nm45cm06ZDMzaTU8NEBpMzc5Nm45cm06ZDMzaTU8NEA1c2gtMmRzMWRhLS1kMTJzYSM1c2gtMmRzMWRhLS1kMTJzcw%3D%3D&vvpl=1&l=2026102601085060DE589D4FBD3A57800B&VExpiration=1793034598&VSignature=bLC1u2TOt-TDhzuEr3yXlg&btag=e0005…"
        ],
        "url_prefix": null,
        "width": 720
      },
      "title": "original sound"
    },
    "region": "US",
    "share_url": "https://www.tiktok.com/@tiktok/video/7683195368279985438",
    "statistics": {
      "aweme_id": "7683195368279985438",
      "collect_count": 1440,
      "comment_count": 3633,
      "digg_count": 14600,
      "play_count": 688400,
      "share_count": 1125
    },
    "status": {
      "aweme_id": "7683195368279985438"
    },
    "text_extra": [
      {
        "end": 27,
        "sec_uid": "MS4wLjABAAAAfCHQJzucD3eL9ppy23Bzi07hMMnkxk1nb21II7HATKSfFniTw3rZyMjQ5qGHJeZj",
        "start": 9,
        "type": 0,
        "user_id": "6844402354738103301"
      }
    ],
    "video": {
      "cla_info": {
        "caption_infos": [
          {
            "caption_format": "webvtt",
            "expire": 1793120999,
            "is_auto_generated": true,
            "lang": "eng-US",
            "language_code": "en",
            "language_id": 2,
            "url": "https://v16-webapp.tiktok.com/2e745f4da958644fa8feea2626962d10/6ae0dae7/video/tos/alisg/tos-alisg-v-37c799-sg/f903e38a3a6c46279e66eb1c166e1697/?a=1988&bti=ODszNWYuMDE6&&bt=10653&ft=-ElcomXMPD12NflyLn-UxGT2aY6e3wv25ycAp&mime_type=video_mp4&rc=ajttdm85cnA2ZDMzaTczNEBpajttdm85cnA2ZDMzaTczNEBmMGxsMmRjL2RhLS1kMTJzYSNmMGxsMmRjL2RhLS1kMTJzcw%3D%3D&l=2026102601085060DE589D4FBD3A57800B&btag=e00050000",
            "url_list": [
              "https://v16-webapp.tiktok.com/2e745f4da958644fa8feea2626962d10/6ae0dae7/video/tos/alisg/tos-alisg-v-37c799-sg/f903e38a3a6c46279e66eb1c166e1697/?a=1988&bti=ODszNWYuMDE6&&bt=10653&ft=-ElcomXMPD12NflyLn-UxGT2aY6e3wv25ycAp&mime_type=video_mp4&rc=ajttdm85cnA2ZDMzaTczNEBpajttdm85cnA2ZDMzaTczNEBmMGxsMmRjL2RhLS1kMTJzYSNmMGxsMmRjL2RhLS1kMTJzcw%3D%3D&l=2026102601085060DE589D4FBD3A57800B&btag=e00050000"
            ]
          }
        ]
      },
      "cover": {
        "data_size": 0,
        "height": 720,
        "uri": "tos-useast8-p-0068-tx2/o03gDFAUfAEdyjCpABI1FYB6MiiKiCANXBAIG9",
        "url_list": [
          "https://p16-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/o03gDFAUfAEdyjCpABI1FYB6MiiKiCANXBAIG9~tplv-tiktokx-origin.image?dr=14575&x-expires=1793120400&x-signature=XVGj06whnRqu5Qjksnbq58WNWOA%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=55bbe6a9&idc=my"
        ],
        "url_prefix": null,
        "width": 720
      },
      "download_addr": {
        "height": 1280,
        "uri": "",
        "url_list": [
          "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-ve-37c799-sg/os3ziEfBqI1YIx1CxMalOUoBgAZANiiAiQQsEA/?a=1988&bti=ODszNWYuMDE6&&bt=1900&ft=-Csk_mXMPD12NflyLn-UxGT2aY6e3wv25ycAp&mime_type=video_mp4&rc=OGYzMzw4OWg7aWc2OTQ1OUBpajttdm85cnA2ZDMzaTczNEA2YmMwMTRjXjExMzVhMWE0YSNmMGxsMmRjL2RhLS1kMTJzcw%3D%3D&expire=1793120999&l=2026102601085060DE589D4FBD3A57800B&ply_type=2&policy=2&signature=82…"
        ],
        "url_prefix": null,
        "width": 720
      },
      "duration": 68000,
      "dynamic_cover": {
        "data_size": 0,
        "height": 720,
        "uri": "tos-useast8-p-0068-tx2/o03gDFAUfAEdyjCpABI1FYB6MiiKiCANXBAIG9",
        "url_list": [
          "https://p16-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/o03gDFAUfAEdyjCpABI1FYB6MiiKiCANXBAIG9~tplv-tiktokx-origin.image?dr=14575&x-expires=1793120400&x-signature=XVGj06whnRqu5Qjksnbq58WNWOA%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=55bbe6a9&idc=my"
        ],
        "url_prefix": null,
        "width": 720
      },
      "has_watermark": true,
      "height": 1280,
      "origin_cover": {
        "data_size": 0,
        "height": 720,
        "uri": "tos-useast8-p-0068-tx2/oMHGa9GzgLAKg4CQUIIq0YIfIXGeejTAVMxdAi",
        "url_list": [
          "https://p16-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/oMHGa9GzgLAKg4CQUIIq0YIfIXGeejTAVMxdAi~tplv-tiktokx-origin.image?dr=14575&x-expires=1793120400&x-signature=%2BygdbZRHoydYkzh3Wk72iP24Gtc%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=55bbe6a9&idc=my"
        ],
        "url_prefix": null,
        "width": 720
      },
      "play_addr": {
        "height": 1280,
        "uri": "",
        "url_list": [
          "https://v16-webapp-prime.tiktok.com/video/tos/alisg/tos-alisg-ve-37c799-sg/oYgjRj7ERIjAdVGfreQgmJDquIKFEEZDBAtFMo/?a=1988&bti=ODszNWYuMDE6&&bt=2121&ft=-Csk_mXMPD12NflyLn-UxGT2aY6e3wv25ycAp&mime_type=video_mp4&rc=ZjNnNGQ8NTM3aTo0OjZoM0Bpajttdm85cnA2ZDMzaTczNEBiLzUvLzUxXmMxYjZeNjRjYSNmMGxsMmRjL2RhLS1kMTJzcw%3D%3D&expire=1793120999&l=2026102601085060DE589D4FBD3A57800B&ply_type=2&policy=2&signature=9d…"
        ],
        "url_prefix": null,
        "width": 720
      },
      "width": 720
    },
    "is_ad": false,
    "is_eligible_for_commission": false,
    "is_paid_partnership": false,
    "create_time_utc": "2026-09-08T16:02:16.000Z",
    "url": "https://www.tiktok.com/@tiktok/video/7683195368279985438",
    "shop_product_url": null
  }
}

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

Video `aweme_detail` içindedir. TikTok dışından bir URL ya da video id'si olmayan bir TikTok URL'si ücretsiz 400, bilinmeyen video ücretsiz 404 döner. 10.000'in üzerindeki beğeni, paylaşım ve izlenme sayıları yuvarlanmış olabilir; `video.duration` milisaniyedir, tam saniyeye yuvarlanır; oynatma ve indirme URL'leri asıl oturum dışında çalışmayabilir (altyazı, müzik ve görsel URL'leri çalışır). `download_media` desteklenmez. `get_transcript` yalnızca videonun zaten sahip olduğu altyazıları döndürür; yapay zekâ ile döküm için Video Transcript uç noktasını kullanın.

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.