Video

GET/v2/tiktok/video1 credit

Returns the details of a single TikTok video or photo post: caption, author, music, statistics and video information, optionally with its captions.

01Query parameters

Name	Type	Description
urlrequired	string	The video's URL (`tiktok.com/@user/video/<id>`, a photo post URL, or a short share link).
get_transcriptoptional	boolean	Also return the video's own captions as WebVTT in `transcript` (null when the video has none).Default: `false`
trimoptional	boolean	Return a compact object (id, caption, statistics, video, author, dates and URL) instead of the full one.Default: `false`
cache_max_ageoptional	string	Accepted for compatibility; every call is fetched fresh. Any other value is rejected with a free 400.Accepted values:`1d3d7d14d30d`

02Request

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"

03Responses

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

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

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 video is in `aweme_detail`. A URL outside TikTok, or a TikTok URL without a video id, is a free 400; an unknown video is a free 404. Like, share and play counts above 10,000 may be rounded; `video.duration` is in milliseconds, rounded to whole seconds; the play and download URLs may not work outside the original session (caption, music and image URLs do). `download_media` is not supported. `get_transcript` returns only captions the video already has; for AI transcription use the Video Transcript endpoint.

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.