API Documentation

TikTok Video Detail API

Query public TikTok data synchronously; empty results and failures are free.

Test API

Results return directly in the same request; no task submission or polling is needed.

Open product page and API Tester

Endpoint and authentication

GET https://api.goanyapi.com/api/v1/tiktok/video-detail

Authenticate with Authorization: Bearer YOUR_API_KEY. Supply query-string parameters; there is no request body.

Input parameters

ParameterTypeLocationRequiredConstraints / defaultDescription
AuthorizationstringHeaderYesBearer YOUR_API_KEYAPI key for the current account
item_idstringQueryOne of two^[0-9]+$Video ID. Example: 7686957509826923808.
urlstringQueryOne of two^https://(www\.)?tiktok\.com/@[A-Za-z0-9._]+/video/[0-9]+/?(?:\?[^#\s]*)?(?:#[^\s]*)?$Full TikTok video URL. Example: https://www.tiktok.com/@spidey.glow/video/7686957509826923808. Supply either url or item_id, never both. Sharing parameters and fragments are removed. Short links are unsupported. URL resolution adds no separate credit charge.

Full URL supported: https://www.tiktok.com/@spidey.glow/video/7686957509826923808. Supply either url or item_id, never both. Sharing parameters, fragments and trailing slashes are removed; short links are unsupported. URL format handling adds no separate charge.

Request example

GET /api/v1/tiktok/video-detail?url=https%3A%2F%2Fwww.tiktok.com%2F%40spidey.glow%2Fvideo%2F7686957509826923808
Authorization: Bearer YOUR_API_KEY

Output parameters

Success returns HTTP 200. Null, empty and missing business fields are preserved; a zero statistic is valid. Only documented public fields are returned.

FieldTypeDescription
codestringok on success
messagestringRequest message
data.creditsUsednumberCredits charged for this request; zero for empty results
data.remainingCreditsnumberAccount balance after settlement
data.itemobject | nullVideo details; null when empty
data.item.idstringPost ID
data.item.descstringPost description
data.item.createTimenumberUnix timestamp in seconds
data.item.isAdbooleanAdvertisement indicator
data.item.authorobjectAuthor information
data.item.statsobjectEngagement statistics
data.item.statsV2objectString statistics
data.item.videoobjectVideo media information
data.item.author.idstring | number | boolean | nullReturned public author field; may be absent or empty
data.item.author.uniqueIdstring | number | boolean | nullReturned public author field; may be absent or empty
data.item.author.nicknamestring | number | boolean | nullReturned public author field; may be absent or empty
data.item.author.signaturestring | number | boolean | nullReturned public author field; may be absent or empty
data.item.author.secUidstring | number | boolean | nullReturned public author field; may be absent or empty
data.item.author.avatarThumbstring | number | boolean | nullReturned public author field; may be absent or empty
data.item.author.avatarMediumstring | number | boolean | nullReturned public author field; may be absent or empty
data.item.author.avatarLargerstring | number | boolean | nullReturned public author field; may be absent or empty
data.item.author.verifiedstring | number | boolean | nullReturned public author field; may be absent or empty
data.item.author.privateAccountstring | number | boolean | nullReturned public author field; may be absent or empty
data.item.author.createTimestring | number | boolean | nullReturned public author field; may be absent or empty
data.item.video.idstring | number | nullReturned public media field; may be absent or empty
data.item.video.descstring | number | nullReturned public media field; may be absent or empty
data.item.video.createTimestring | number | nullReturned public media field; may be absent or empty
data.item.video.durationstring | number | nullReturned public media field; may be absent or empty
data.item.video.widthstring | number | nullReturned public media field; may be absent or empty
data.item.video.heightstring | number | nullReturned public media field; may be absent or empty
data.item.video.ratiostring | number | nullReturned public media field; may be absent or empty
data.item.video.coverstring | number | nullReturned public media field; may be absent or empty
data.item.video.originCoverstring | number | nullReturned public media field; may be absent or empty
data.item.video.dynamicCoverstring | number | nullReturned public media field; may be absent or empty
data.item.video.playAddrstring | number | nullReturned public media field; may be absent or empty
data.item.video.downloadAddrstring | number | nullReturned public media field; may be absent or empty
data.item.stats.diggCountnumber | string | nullReturned statistic; may be absent or empty
data.item.stats.shareCountnumber | string | nullReturned statistic; may be absent or empty
data.item.stats.commentCountnumber | string | nullReturned statistic; may be absent or empty
data.item.stats.playCountnumber | string | nullReturned statistic; may be absent or empty
data.item.stats.collectCountnumber | string | nullReturned statistic; may be absent or empty
data.item.stats.followerCountnumber | string | nullReturned statistic; may be absent or empty
data.item.stats.followingCountnumber | string | nullReturned statistic; may be absent or empty
data.item.stats.heartCountnumber | string | nullReturned statistic; may be absent or empty
data.item.stats.heartnumber | string | nullReturned statistic; may be absent or empty
data.item.stats.videoCountnumber | string | nullReturned statistic; may be absent or empty
data.item.stats.friendCountnumber | string | nullReturned statistic; may be absent or empty
data.item.stats.viewCountnumber | string | nullReturned statistic; may be absent or empty
data.item.statsV2.diggCountnumber | string | nullReturned statistic; may be absent or empty
data.item.statsV2.shareCountnumber | string | nullReturned statistic; may be absent or empty
data.item.statsV2.commentCountnumber | string | nullReturned statistic; may be absent or empty
data.item.statsV2.playCountnumber | string | nullReturned statistic; may be absent or empty
data.item.statsV2.collectCountnumber | string | nullReturned statistic; may be absent or empty
data.item.statsV2.followerCountnumber | string | nullReturned statistic; may be absent or empty
data.item.statsV2.followingCountnumber | string | nullReturned statistic; may be absent or empty
data.item.statsV2.heartCountnumber | string | nullReturned statistic; may be absent or empty
data.item.statsV2.heartnumber | string | nullReturned statistic; may be absent or empty
data.item.statsV2.videoCountnumber | string | nullReturned statistic; may be absent or empty
data.item.statsV2.friendCountnumber | string | nullReturned statistic; may be absent or empty
data.item.statsV2.viewCountnumber | string | nullReturned statistic; may be absent or empty

Real response example

Saved from a real successful response and projected to public fields. Lists show only the first two records. Account balance and request charges are omitted; live responses also contain creditsUsed and remainingCredits based on current configuration. Displaying the example sends no query and charges no credits.

{
  "code": "ok",
  "message": "ok",
  "data": {
    "item": {
      "id": "7686957509826923808",
      "desc": "Comment “SANTA” if you need one 🤭🎄 #christmas #christmasiscoming #projector #merrychristmas #christmasdecor ",
      "createTime": 1789759268,
      "isAd": false,
      "author": {
        "id": "7672400417817625622",
        "uniqueId": "spidey.glow",
        "nickname": "SpideyGlow",
        "signature": "",
        "secUid": "MS4wLjABAAAAK4RIcIbr3DY__BALfxpDu7FXrXMdNIkck5Zzt7ScvdWxtGgRjeLDOCixGr4nFQrG",
        "avatarThumb": "https://p16-common-sign.tiktokcdn-us.com/tos-useast2a-avt-0068-euttp/58cb4b19080af86926f621f3ced3a91d~tplv-tiktokx-cropcenter:100:100.jpeg?dr=9640&refresh_token=a34c0f1e&x-expires=1794646800&x-signature=YMzBmDgoFv2S4Kui2XY0XXEDhwI%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast5",
        "avatarMedium": "https://p16-common-sign.tiktokcdn-us.com/tos-useast2a-avt-0068-euttp/58cb4b19080af86926f621f3ced3a91d~tplv-tiktokx-cropcenter:720:720.jpeg?dr=9640&refresh_token=18965771&x-expires=1794646800&x-signature=k%2FtqwEg%2FG2ewpHJw%2FxdKOhdeRm0%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast5",
        "avatarLarger": "https://p19-common-sign.tiktokcdn-us.com/tos-useast2a-avt-0068-euttp/58cb4b19080af86926f621f3ced3a91d~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=9640&refresh_token=eb2f6582&x-expires=1794646800&x-signature=8MwRsymAfh8mqWKXlfe5Z%2BzlRKk%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast5",
        "verified": false,
        "privateAccount": false
      },
      "stats": {
        "diggCount": 11100,
        "shareCount": 7166,
        "commentCount": 491,
        "playCount": 1000000,
        "collectCount": 2423
      },
      "statsV2": {
        "diggCount": "11100",
        "shareCount": "7166",
        "commentCount": "491",
        "playCount": "1000000",
        "collectCount": "2423"
      },
      "video": {
        "id": "7686957509826923808",
        "duration": 14,
        "width": 576,
        "height": 1024,
        "ratio": "540p",
        "cover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast2a-p-0037-euttp/owHQfADrKH1DkFRNqzPJ6CmEQIebBDgQunkYEV~tplv-tiktokx-origin.image?dr=9636&x-expires=1794646800&x-signature=LtUxvaSud4oEjRkn9Wfiz2T1YwA%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=useast5",
        "originCover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast2a-p-0037-euttp/oYEsyqotmiQaZSh1AlBgIjItfdCaPABznByIVi~tplv-tiktokx-origin.image?dr=9636&x-expires=1794646800&x-signature=7L%2BLsb1IUpQZz7Zufap2OlxC9sw%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=useast5",
        "dynamicCover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast2a-p-0037-euttp/oMyimjqyIZyCzGVAntZBfBlIdEAiCUsoEzi1Ih~tplv-tiktokx-origin.image?dr=9636&x-expires=1794646800&x-signature=Q%2FrsN7LCrnTEr0lVcZ0C7TzAUas%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=useast5",
        "playAddr": "https://v16-webapp-prime.us.tiktok.com/video/tos/useast2a/tos-useast2a-ve-0068c001-euttp/ow1EVtFrPQDeJkgA6K9QfDEzqbIHRqNDmDmYHB/?a=1988&bti=ODszNWYuMDE6&&bt=1087&ft=4KJMyMzm8Zmo0FcjMa4jVJyedpWrKsd.&mime_type=video_mp4&rc=aTM6NzY1aDY5PDY0ZjxmZ0Bpajp0cmw5cjVyZDMzZjczNUA0NjBjLWNiXzUxYS0tM2AxYSNmaWBgMmRjcWphLS1kMTNzcw%3D%3D&expire=1794648888&l=202611120934347C1B176E04FFD2014F20&ply_type=2&policy=2&signature=7960f205a17931084ce957cd56b59cab&tk=tt_chain_token&btag=e000b8000",
        "downloadAddr": "https://video-useast5-bp.us.tiktok.com/b63e11495ffdb3e6ff708d815695a650/6af82b38/kmoat/mps/logo/v3/r/p/v26044gc0000damot2fog65icocql7ig/d3a2b34d8a654b1299c10af3e9527c90/07f34a1c8d363dc39fbe34e3c4004545/mp4/main.mp4?a=1988&bti=ODszNWYuMDE6&&bt=0&ft=4KUERMzm8Zmo0FcjMa4jVJyedpWrKsd.&mime_type=video_mp4&rc=cnF8b2hsc2d3SkBwaHIxaDFybndmM2Y1PDZkNDw1ZThkZzY1NkBpajp0cmw5cjVyZDMzZjczNUBjRl5Nc3FePmJKYSNvYF90aHFmOiM2NDJiYy1gNi4xMzUxX15hYSNmaWBgMmRjcWphLS1kMTNzcw%3D%3D&definition=720p&du=15&item_id=7686957509826923808&l=202611120934347C1B176E04FFD2014F20&logo_type=tiktok_creator&ply_type=2&policy=eyJ2bSI6MiwiY2siOiJ0dF9jaGFpbl90b2tlbiJ9&sign_params=item_id%2Cuser_text&user_text=spidey.glow&btag=e000b8000"
      }
    }
  }
}

Billing

With the current configuration, each successful request costs 1 credit.

Non-empty successful results use the currently configured rate; empty results and failures are free. Sufficient balance is required before requesting. A concurrent settlement with insufficient balance also returns 402 without delivering unsettled paid results. Empty or null details and lists without meaningful records are empty; individual empty fields do not make a populated result empty.

Errors

400: invalid parameters; 401: invalid authentication; 402: insufficient credits; 429: rate limit; 502: request failed; 503: API or pricing not configured. Errors contain code and message without internal addresses or credentials.

{"code":"invalid_params","message":"Invalid parameter"}