TikTok Video Scraper

Extract video metadata and download TikTok videos without login. Supports single videos, user profiles, hashtag pages, and short links.

What You Can Do

• Scrape single videos — get metadata + download the video file
• Scrape user profiles — collect videos from any public account
• Scrape hashtag pages — collect videos from any trending or niche hashtag
• Follow short links — vt.tiktok.com short links are automatically resolved
• Download video files — stored in Apify Key-Value Store, accessible via public URL

Supported URL Types

URL Type	Example
Single video	https://www.tiktok.com/@username/video/123456789
User profile	https://www.tiktok.com/@username
Hashtag page	https://www.tiktok.com/tag/funny
Short link	https://vt.tiktok.com/ZSxxxxxx

Input

Parameter	Type	Required	Default	Description
urls	Array of strings	Yes	—	TikTok URLs to scrape
maxItems	Integer	No	20	Max videos to collect per user/hashtag page (1–500)

Example Input

{
  "urls": [
    "https://www.tiktok.com/@charlidamelio/video/7156033831819037994",
    "https://www.tiktok.com/@charlidamelio",
    "https://www.tiktok.com/tag/dance",
    "https://vt.tiktok.com/ZSUgNjGcw"
  ],
  "maxItems": 10
}

Output

Each collected video is saved as a structured record in the dataset.

{
  "videoId": "7156033831819037994",
  "videoUrl": "https://www.tiktok.com/@charlidamelio/video/7156033831819037994",
  "videoTitle": "Video description text here...",
  "createTime": "2022-10-26T12:34:56.000Z",
  "author": {
    "username": "charlidamelio",
    "nickname": "charli d'amelio",
    "avatarUrl": "https://p16-sign.tiktokcdn-us.com/...",
    "signature": "Bio text",
    "verified": true,
    "profileUrl": "https://www.tiktok.com/@charlidamelio"
  },
  "statistics": {
    "playCount": 12000000,
    "likeCount": 850000,
    "commentCount": 4200,
    "shareCount": 18000
  },
  "music": {
    "title": "original sound",
    "author": "charlidamelio",
    "url": "https://www.tiktok.com/music/..."
  },
  "hashtags": ["dance", "fyp", "viral"],
  "videoFileUrl": "https://api.apify.com/v2/key-value-stores/.../video_7156033831819037994.mp4",
  "videoFileName": "video_7156033831819037994.mp4",
  "videoDuration": 15,
  "videoResolution": { "width": 576, "height": 1024 },
  "collectedAt": "2025-10-26T12:00:00.000Z",
  "inputUrl": "https://www.tiktok.com/@charlidamelio/video/7156033831819037994",
  "urlType": "video"
}

Output Storage

• Dataset — structured JSON records, one per video
• Key-Value Store — downloaded MP4 video files

Tips for Best Results

• Start with a small batch (5–10 URLs) to verify results before scaling up
• Avoid scraping the same account repeatedly in a short period
• If results are empty, the account may be private or region-restricted

Limitations

• Private content: Cannot access private, age-restricted, or login-gated videos
• Region restrictions: Some videos may be unavailable in certain regions
• Music pages: tiktok.com/music/ URLs are not supported
• Watermarks: Most videos are downloaded watermark-free, but some may include a watermark depending on TikTok's response

Troubleshooting

No results from a user or hashtag page The account may be private, have no public videos, or TikTok may be temporarily limiting access. Verify the URL is correct and the profile is public.

Video download shows "skipped" The video metadata is still saved to the dataset. The video file download may fail for region-restricted or live-stream content.

Fewer videos collected than expected For user/hashtag pages, the first batch of videos is collected based on what TikTok makes available. Increase maxItems if needed.

Short links not resolving Ensure the short link is a valid vt.tiktok.com URL. Some short links may expire or be region-restricted.

Compliance

This Actor collects only publicly available TikTok data — no login or authentication is required. You are responsible for ensuring your use complies with TikTok's Terms of Service and applicable laws in your region.