TikTok Scraper + AI — Videos, Profiles, Comments & Hashtags 🚀

A high-performance TikTok data extraction tool designed for fast, reliable, and cost-efficient collection of public TikTok content. Emits structured datasets for profiles, videos, search queries, hashtags, and comments, with optional integrated AI analysis.

---

Key Capabilities

• ⚡ High-Efficiency Data Extraction: Designed for fast startup, low memory footprint, and high throughput.
• 👤 TikTok Profile Scraper: Extract public profile metadata, follower counts, total likes, video counts, and public video feeds for any @username.
• 🎬 TikTok Video Scraper: Collect direct video details, descriptions, creation timestamps, author statistics, play counts, likes, comments, shares, and saves.
• 🔍 TikTok Search & Hashtag Scraper: Discover public videos matching search keywords or trending hashtags.
• 💬 TikTok Comment Scraper: Fetch top-level video comments and nested comment replies with comment hierarchy structure.
• 🧠 Optional TikTok AI Analysis: Enrich video records with customizable AI summaries, language detection, sentiment analysis, topic extraction, brand mentions, promotional detection, and content classification.
• 🛡️ Built-in Deduplication & Limits: Strict result limits and automatic deduplication to ensure clean datasets without duplicate charges.

---

Transparent Commercial Pricing

• TikTok Scraping: $1.00 per 1,000 results ($0.001 / record)
• Optional AI Enrichment: $3.00 per 1,000 successfully AI-enriched results ($0.00300 / record)

Note: When AI analysis is disabled (enableAI: false, default), customers pay only for scraping ($1.00 / 1k results). Failed AI enrichments are never billed as successful AI results.

---

Supported Use Cases

• 📊 Social Media & Market Research: Analyze video performance and audience engagement trends across categories.
• 🎯 Creator & Influencer Discovery: Evaluate creator profile metrics, posting frequency, and audience reach.
• 🏷️ Brand & Campaign Monitoring: Track brand mentions (targetBrand) and campaign hashtag performance (campaignKeywords).
• 📈 Sentiment & Trend Discovery: Classify content tone (positive, neutral, negative) and auto-detect top discussion topics.

---

Input Parameters

Parameter	Type	Default	Description
startUrls	Array	[{"url": "https://www.tiktok.com/@tiktok"}]	List of TikTok URLs (Profile URLs, Video URLs, Hashtag URLs).
profiles	Array	[]	List of TikTok usernames (e.g. ['@mrbeast', 'tiktok']).
postUrls	Array	[]	List of direct video URLs or Video IDs.
searchQueries	Array	[]	Search terms to find relevant videos (e.g. ['crypto', 'AI tools']).
hashtags	Array	[]	Hashtags without hash symbol (e.g. ['tech', 'funny']).
maxItems	Integer	3	Maximum total records (videos, profiles, comments) to emit.
maxVideosPerProfile	Integer	10	Maximum videos to fetch per profile target.
maxCommentsPerVideo	Integer	0	Maximum top-level comments per video (0 to disable comments).
includeReplies	Boolean	false	Extract nested comment replies when fetching comments.
includeSubtitles	Boolean	false	Extract native closed-captions / subtitles if available.
dateFrom	String	null	Filter videos created on or after this date (YYYY-MM-DD).
dateTo	String	null	Filter videos created on or before this date (YYYY-MM-DD).
proxyConfiguration	Object	{"useApifyProxy": true}	Proxy configuration to maintain stable extraction.
enableAI	Boolean	false	Master switch to enable optional AI analysis. Default false.
aiFeatures	Array	['summary', 'language', 'sentiment', 'topics', 'brandMentions', 'promotionDetection', 'classification']	Select specific AI analysis features to run on videos.
targetBrand	String	null	Optional brand name to specifically evaluate in AI analysis (e.g. 'Nike').
campaignKeywords	Array	[]	Optional campaign terms/hashtags to evaluate for campaign relevance.
aiInstructions	String	null	Optional custom guidance for AI content analysis.

---

AI Analysis Controls

Optional AI analysis can enrich video records with automated metadata insights.

Customer Controls

• enableAI: Master toggle. When set to false (default), zero AI processing occurs.
• aiFeatures: Customize which analyses are generated (summary, language, sentiment, topics, brandMentions, promotionDetection, classification).
• targetBrand: Specify a brand name (e.g. "Nike") to evaluate whether the target brand is mentioned (targetBrandMentioned: true/false).
• campaignKeywords: Supply campaign keywords or hashtags to evaluate campaign relevance (campaignRelevant: true/false).
• aiInstructions: Supply custom textual analysis instructions to tailor AI evaluation context.

When AI is enabled, enriched video records contain only the requested feature outputs:

• Summary: Concise one-sentence summary of the post caption.
• Language: ISO language code detection.
• Sentiment: Content tone classification (positive, neutral, or negative).
• Topics: Main themes identified in the content.
• Brand Mentions: Recognized commercial brands mentioned.
• Promotional Detection: Boolean flag indicating whether the content is promotional or sponsored.
• Classification: High-level content category (educational, entertainment, promotional, news, lifestyle, other).

---

Output Examples

Profile Record

{
  "type": "profile",
  "id": "6614519312189947909",
  "username": "mrbeast",
  "nickname": "MrBeast",
  "bio": "Welcome to my channel!",
  "verified": true,
  "avatarUrl": "https://example.com/avatar.jpg",
  "followers": 137400000,
  "following": 354,
  "likes": 1400000000,
  "videoCount": 467,
  "profileUrl": "https://www.tiktok.com/@mrbeast"
}

Video Record (with Optional AI)

{
  "type": "video",
  "id": "7404455823158021419",
  "url": "https://www.tiktok.com/@mrbeast/video/7404455823158021419",
  "description": "Building 100 houses! #charity #help",
  "createdAt": "2024-08-17T03:00:00.000Z",
  "author": {
    "id": "6614519312189947909",
    "username": "mrbeast",
    "nickname": "MrBeast",
    "verified": true,
    "avatarUrl": "https://example.com/avatar.jpg",
    "followers": 137400000
  },
  "stats": {
    "views": 55000000,
    "likes": 4200000,
    "comments": 35000,
    "shares": 120000,
    "saves": 45000
  },
  "hashtags": ["charity", "help"],
  "mentions": [],
  "music": {
    "id": "740445582390",
    "title": "Original Sound - MrBeast",
    "author": "MrBeast",
    "original": true,
    "url": "https://example.com/sound.mp3"
  },
  "video": {
    "duration": 58,
    "width": 1080,
    "height": 1920,
    "coverUrl": "https://example.com/cover.jpg",
    "dynamicCoverUrl": "https://example.com/dynamic_cover.jpg",
    "downloadUrl": "https://example.com/video.mp4",
    "playUrl": "https://example.com/play.mp4"
  },
  "ai": {
    "summary": "MrBeast documents building 100 houses for families in need.",
    "language": "en",
    "sentiment": "positive",
    "topics": ["charity", "humanitarian"],
    "brandMentions": [],
    "isPromotional": false,
    "classification": "educational"
  }
}

---

Limitations & Recommendations

• Public Data Only: Collects publicly available TikTok profiles, posts, and comments.
• Proxy Usage: Apify Proxy (proxyConfiguration: { useApifyProxy: true }) is recommended for high-volume extraction to avoid IP rate limits.