Search APIs
Loading…
← API Store
Social

TikTok

TikTok

One TikTok video

GET /tiktok/v1/post
Test this endpoint

Every response includes credits_used: the credits this call cost.

Each call costs 1 credits; failed calls are free. Run it in the console playground to see a live result.

Parameters

NameTypeDescription
urlrequiredstring Example: https://www.tiktok.com/@nasa/video/7697300954667994381

Every endpoint also takes: raw、fields、fresh、output、records

{
  "ai_generated": null,
  "author": {
    "avatar": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/e5143212a59c09a008bf50f487d54d1f~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=…",
    "id": "7664638705177150477",
    "nickname": "NASA",
    "username": "nasa",
    "verified": true
  },
  "author_info": {
    "avatar_medium": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/e5143212a59c09a008bf50f487d54d1f~tplv-tiktokx-cropcenter:720:720.jpeg?dr=96…",
    "avatar_thumb": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/e5143212a59c09a008bf50f487d54d1f~tplv-tiktokx-cropcenter:100:100.jpeg?dr=96…",
    "private": false,
    "sec_uid": "MS4wLjABAAAAU9BRVzC8oCaegVnia8IbqWhPb_-dbU7s00Y3wS1_Nx8g5RUaYvyXrpejgjdxTwd6",
    "signature": "Making the seemingly impossible, possible.✨",
    "url": "https://www.tiktok.com/@nasa"
  },
  "author_stats": {
    "diggCount": "356",
    "followerCount": "2100000",
    "followingCount": "23",
    "friendCount": "0",
    "heart": "11300000",
    "heartCount": "11300000",
    "videoCount": "58"
  },
  "cached": false,
  "challenges": [],
  "cover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/ocERRGQkjGFMAfD9CgfkFlASA6IARAlMDk0qnE~tplv-tiktokx-origin.image?dr=9636&x-ex…",
  "create_time": "2026-10-16T16:19:26.000Z",
  "create_time_unix": 1792167566,
  "credits_used": 1,
  "desc": "There was plenty to see across NASA this week 🚀   🔴 Perseverance breaks a record on Mars 🛰️ Fresh cargo arrives at the ISS 🌌 CRS-35’s space …",
  "diversification_labels": [
    "Science",
    "Education",
    "… 1 more"
  ],
  "duet_enabled": true,
  "duration": 121,
  "hashtags": [],
  "id": "7697300954667994381",
  "images": [],
  "is_ad": false,
  "location_created": "US",
  "mentions": [],
  "music": {
    "author": "NASA",
    "id": "7697301026352728845",
    "title": "original sound - NASA"
  },
  "music_info": {
    "album": null,
    "cover": "https://p16-common.tiktokcdn-us.com/tos-useast5-avt-0068-tx/e5143212a59c09a008bf50f487d54d1f~tplv-tiktokx-cropcenter:720:720.jpeg?dr=9584&t=…",
    "duration": 121,
    "original": false,
    "play_url": "https://v16m.tiktokcdn-us.com/0e8ee318ca18d916bcd251f1d085bee5/6adc0e64/video/tos/useast5/tos-useast5-v-27dcd7-tx/oUSAMkAMigODJA6tB4LHaHTiEA…"
  },
  "page": {
    "shareMeta": {
      "desc": "There was plenty to see across NASA this week 🚀   🔴 Perseverance breaks a record on Mars 🛰️ Fresh cargo arrives at the ISS 🌌 CRS-35’s space …",
      "title": "NASA on TikTok"
    },
    "statusCode": 0,
    "statusMsg": ""
  },
  "pinned": null,
  "poi": null,
  "private_item": false,
  "share_enabled": true,
  "stats": {
    "collectCount": "1579",
    "commentCount": "514",
    "diggCount": "21300",
    "playCount": "389600",
    "repostCount": "0",
    "shareCount": "586"
  },
  "stitch_enabled": true,
  "suggested_words": [
    "JellyFish Lighting",
    "nasa space",
    "… 8 more"
  ],
  "url": "https://www.tiktok.com/@nasa/video/7697300954667994381",
  "video": {
    "bitrate": 922075,
    "bitrates": [
      {
        "bitrate": 922075,
        "codec": "h264",
        "gear": "normal_720_0",
        "height": 1280,
        "quality": 10,
        "size": "13957923",
        "urls": [
          "https://v16-webapp-prime.us.tiktok.com/video/tos/useast5/tos-useast5-pve-0068-tx/oYS1ASVNiJsiV7TAbwcIasYTIcNgBBQzCfFEdp/?a=1988&bti=ODszNWYu…",
          "https://v19-webapp-prime.us.tiktok.com/video/tos/useast5/tos-useast5-pve-0068-tx/oYS1ASVNiJsiV7TAbwcIasYTIcNgBBQzCfFEdp/?a=1988&bti=ODszNWYu…",
          "… 1 more"
        ],
        "width": 720
      },
      {
        "bitrate": 524596,
        "codec": "h265_hvc1",
        "gear": "adapt_lower_720_1",
        "height": 1280,
        "quality": 14,
        "size": "5695221",
        "urls": [
          "https://v16-webapp-prime.us.tiktok.com/video/tos/useast5/tos-useast5-v-0068-tx/oIY1YOcgAAAzAI70wIisaVpBJfNdVdSiBCADSg/media-video-hvc1/?a=19…",
          "https://v19-webapp-prime.us.tiktok.com/video/tos/useast5/tos-useast5-v-0068-tx/oIY1YOcgAAAzAI70wIisaVpBJfNdVdSiBCADSg/media-video-hvc1/?a=19…",
          "… 1 more"
        ],
        "width": 720
      },
      "… 1 more"
    ],
    "codec": "h264",
    "cover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/ocERRGQkjGFMAfD9CgfkFlASA6IARAlMDk0qnE~tplv-tiktokx-origin.image?dr=9636&x-ex…",
    "definition": "720p",
    "download_url": "https://v16-webapp-prime.us.tiktok.com/video/tos/useast5/tos-useast5-pve-0068-tx/okdzT1aTfAAbQNBJCqBScYEwgiIaSaDMVpiIBs/?a=1988&bti=ODszNWYu…",
    "dynamic_cover": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/ocERRGQkjGFMAfD9CgfkFlASA6IARAlMDk0qnE~tplv-tiktokx-origin.image?dr=9636&x-ex…",
    "format": "mp4",
    "height": 1280,
    "origin_cover": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/ooBgb7TTAw4EkmSqR4YBDqA5pEQvQBFSmfl0fD~tplv-tiktokx-origin.image?dr=9636&x-ex…",
    "play_url": "https://v16-webapp-prime.us.tiktok.com/video/tos/useast5/tos-useast5-pve-0068-tx/oYS1ASVNiJsiV7TAbwcIasYTIcNgBBQzCfFEdp/?a=1988&bti=ODszNWYu…",
    "quality": "normal",
    "ratio": "720p",
    "size": "13957923",
    "subtitles": [
      {
        "format": "webvtt",
        "language": "eng-US",
        "source": "ASR",
        "url": "https://v16m-webapp.tiktokcdn-us.com/10a7e585ebadfafda7ad87e65af9fa05/6ade5d04/video/tos/useast5/tos-useast5-v-0068-tx/094c4a073d7245fd970de…"
      }
    ],
    "width": 720
  }
}
Response fields (103)

Field paths and types observed in the sample response; the live response is authoritative.

$object
$.ai_generatednull
$.authorobject
$.author.avatarstring
$.author.idstring
$.author.nicknamestring
$.author.usernamestring
$.author.verifiedboolean
$.author_infoobject
$.author_info.avatar_mediumstring
$.author_info.avatar_thumbstring
$.author_info.privateboolean
$.author_info.sec_uidstring
$.author_info.signaturestring
$.author_info.urlstring
$.author_statsobject
$.author_stats.diggCountstring
$.author_stats.followerCountstring
$.author_stats.followingCountstring
$.author_stats.friendCountstring
$.author_stats.heartstring
$.author_stats.heartCountstring
$.author_stats.videoCountstring
$.cachedboolean
$.challengesarray
$.coverstring
$.create_timestring
$.create_time_unixinteger
$.credits_usedinteger
$.descstring
$.diversification_labelsarray
$.diversification_labels[]string
$.duet_enabledboolean
$.durationinteger
$.hashtagsarray
$.idstring
$.imagesarray
$.is_adboolean
$.location_createdstring
$.mentionsarray
$.musicobject
$.music.authorstring
$.music.idstring
$.music.titlestring
$.music_infoobject
$.music_info.albumnull
$.music_info.coverstring
$.music_info.durationinteger
$.music_info.originalboolean
$.music_info.play_urlstring
$.pageobject
$.page.shareMetaobject
$.page.shareMeta.descstring
$.page.shareMeta.titlestring
$.page.statusCodeinteger
$.page.statusMsgstring
$.pinnednull
$.poinull
$.private_itemboolean
$.share_enabledboolean
$.statsobject
$.stats.collectCountstring
$.stats.commentCountstring
$.stats.diggCountstring
$.stats.playCountstring
$.stats.repostCountstring
$.stats.shareCountstring
$.stitch_enabledboolean
$.suggested_wordsarray
$.suggested_words[]string
$.urlstring
$.videoobject
$.video.bitrateinteger
$.video.bitratesarray
$.video.bitrates[]object | string
$.video.bitrates[].bitrateinteger
$.video.bitrates[].codecstring
$.video.bitrates[].gearstring
$.video.bitrates[].heightinteger
$.video.bitrates[].qualityinteger
$.video.bitrates[].sizestring
$.video.bitrates[].urlsarray
$.video.bitrates[].urls[]string
$.video.bitrates[].widthinteger
$.video.codecstring
$.video.coverstring
$.video.definitionstring
$.video.download_urlstring
$.video.dynamic_coverstring
$.video.formatstring
$.video.heightinteger
$.video.origin_coverstring
$.video.play_urlstring
$.video.qualitystring
$.video.ratiostring
$.video.sizestring
$.video.subtitlesarray
$.video.subtitles[]object
$.video.subtitles[].formatstring
$.video.subtitles[].languagestring
$.video.subtitles[].sourcestring
$.video.subtitles[].urlstring
$.video.widthinteger