🎬 TikTok Post Detail Scraper

Get comprehensive metadata for any TikTok video — engagement stats, author stats, hashtags, music info, download URLs, subtitles, and more. Extracts data from TikTok's full SSR page for maximum richness, with embed-page fallback for reliability.

✨ Why Use This Actor?

• ⚡ Fast — HTTP-only, no browser overhead
• 💰 Extremely cheap — Uses only 0.0001 CU per run ($0.00003)
• 🪶 Lightweight — ~256 MB RAM
• ✅ No login required — Works without any TikTok account
• 📊 Richest data — Full page extraction: authorStats, downloadAddr, subtitleInfos, bitRateList, poi, duetInfo, imagePost, and more
• 🔗 Flexible input — Accepts video ID or full TikTok URL
• 🔄 Reliable fallback — Falls back to embed page if full page is blocked

🎯 Use Cases

• Content analysis — Analyze video performance metrics (views, likes, shares, saves)
• Hashtag research — Extract hashtags used in top-performing videos
• Music/sound tracking — Find which sounds are being used in viral content
• Engagement monitoring — Track how a specific video performs over time
• Influencer analytics — Get detailed author stats (followerCount, followingCount, heartCount)
• Download pipeline — Get direct downloadAddr / playAddr CDN URLs
• Subtitle extraction — Access subtitleInfos for all available languages

🔧 How It Works

Uses pure HTTP requests — no browser, no Playwright. Fast and resource-efficient.

📥 Input

Parameter	Type	Required	Default	Description
video_id	string	Yes	-	TikTok video ID or full video URL

Example input

{
    "video_id": "7600353976667704584"
}

You can also pass a full URL (username is extracted automatically):

{
    "video_id": "https://www.tiktok.com/@username/video/7600353976667704584"
}

📤 Output

Each item is the raw itemStruct from TikTok's SSR data, returned as-is. The only added field is _input (the original input value).

Fields available from full page (primary)

Field	Type	Description
id	string	Video ID
desc	string	Caption / description
createTime	number	Unix timestamp
author	object	Author details including secUid, signature, avatarLarger
authorStats	object	followerCount, followingCount, heartCount, videoCount
stats	object	playCount, diggCount, shareCount, commentCount, collectCount, repostCount
video.downloadAddr	string	Direct CDN URL for video download
video.playAddr	string	Direct CDN URL for streaming
video.duration	number	Video duration in seconds
video.width / video.height	number	Video dimensions
video.definition	string	Quality: 540p, 720p, 1080p
video.bitRateList	array	All available quality tiers
video.subtitleInfos	array	Subtitle download links per language
music	object	playUrl, coverMedium, coverLarge, original, duration
challenges	array	Hashtags used in the video
textExtra	array	Hashtag / mention positions in description
poi	object	Location tag (if set)
duetInfo / duetDisplay / stitchDisplay	object	Duet & stitch settings
suggestedWords	array	TikTok-suggested keywords
diversificationLabels	array	Content classification labels
imagePost	object	Full slideshow / photo data
adAuthorization	boolean	Whether content is branded/paid
isAd	boolean	Ad flag
_input	string	Original input (video ID or URL)

Example output

{
  "id": "7600353976667704584",
  "desc": "testing #fyp",
  "createTime": 1768055051,
  "author": {
    "id": "7165941169842914310",
    "uniqueId": "username",
    "nickname": "Display Name",
    "avatarLarger": "https://p16-sign.tiktokcdn-us.com/...",
    "secUid": "MS4wLjABAAAA...",
    "signature": "Bio text here",
    "verified": false
  },
  "authorStats": {
    "followerCount": 12400,
    "followingCount": 300,
    "heartCount": 95000,
    "videoCount": 84
  },
  "stats": {
    "diggCount": 1820,
    "shareCount": 142,
    "commentCount": 37,
    "playCount": 48600,
    "collectCount": 210,
    "repostCount": 0
  },
  "video": {
    "id": "7600353976667704584",
    "duration": 15,
    "width": 576,
    "height": 1024,
    "definition": "720p",
    "downloadAddr": "https://v19-webapp.tiktok.com/video/tos/...",
    "playAddr": "https://v19-webapp.tiktok.com/video/tos/...",
    "cover": "https://p16-sign.tiktokcdn-us.com/...",
    "subtitleInfos": [
      {
        "LanguageCodeName": "eng-US",
        "Url": "https://v19.tiktokcdn.com/...",
        "Format": "webvtt"
      }
    ]
  },
  "music": {
    "id": "7306725305686002434",
    "title": "original sound",
    "authorName": "username",
    "original": true,
    "duration": 15,
    "playUrl": "https://sf19-ies-music.tiktokcdn-us.com/...",
    "coverMedium": "https://p16-sign.tiktokcdn-us.com/..."
  },
  "challenges": [
    { "id": "229207", "title": "fyp" }
  ],
  "textExtra": [
    { "Start": 8, "End": 12, "Type": 1, "HashtagName": "fyp", "HashtagId": "229207" }
  ],
  "_input": "7600353976667704584"
}

🛠️ Technical Details

• Engine: HTTP-only — no browser required
• Docker image: apify/actor-python:3.12
• Memory: ~256 MB RAM
• Proxy: Not required (works without proxy on Apify cloud)