🎵 TikTok Profile & Hashtag Scraper

Scrape TikTok user profiles, hashtag feeds, and search results. Extract video metadata, view counts, likes, comments, captions, author stats, and music info — with no TikTok account required.

🚀 What You Can Do

• Scrape a user profile — get all videos from any public TikTok account
• Scrape a hashtag feed — get trending videos from any hashtag (e.g., #viral, #fyp)
• Scrape search results — get videos matching any search query (e.g., "dance challenge")

📦 Output Data (per video)

Field	Type	Description
id	string	TikTok video ID
webVideoUrl	string	Direct link to the video on TikTok
authorUsername	string	Author's username (without @)
authorNickname	string	Author's display name
authorId	string	Author's TikTok ID
authorFollowers	integer	Author's follower count
authorFollowing	integer	Number of accounts followed by the author
authorHearts	integer	Total likes on author's account
authorVerified	boolean	Whether the author is verified
caption	string	Video caption / description text
hashtags	array	List of hashtags extracted from caption
videoPlayCount	integer	View / play count
videoLikeCount	integer	Like count (hearts)
videoCommentCount	integer	Comment count
videoShareCount	integer	Share count
videoBookmarkCount	integer	Bookmark / save count
videoDuration	integer	Duration in seconds
videoWidth	integer	Width in pixels
videoHeight	integer	Height in pixels
coverUrl	string	Thumbnail image URL
musicTitle	string	Background music title
musicAuthor	string	Background music author
musicDuration	integer	Background music duration in seconds
createdAt	string	Video creation date (ISO 8601)
scrapedAt	string	Scrape timestamp (ISO 8601)

⚙️ Input Parameters

Parameter	Type	Required	Default	Description
scrapeType	select	✅	user	user, hashtag, or search
query	string	✅	—	Username (no @), hashtag (no #), or search query
maxItems	integer	❌	50	Max videos to return (1–1000)
proxyConfiguration	proxy	❌	RESIDENTIAL	Proxy settings — recommended for reliability

💡 Input Examples

Scrape a user profile:

{
  "scrapeType": "user",
  "query": "charlidamelio",
  "maxItems": 50
}

Scrape a hashtag:

{
  "scrapeType": "hashtag",
  "query": "viral",
  "maxItems": 100
}

Search for videos:

{
  "scrapeType": "search",
  "query": "dance challenge 2024",
  "maxItems": 50
}

💰 Pricing

This Actor is compatible with Apify's Pay-Per-Event pricing. When the synthetic default-dataset-item event is enabled in the Actor's monetization settings, each saved video produces one billable dataset event. Exact prices and any start event are shown on the Actor's Apify Store page.

🌐 Proxy Requirements

TikTok may block datacenter IPs. For best results, use Residential Proxy (pre-filled by default).

📋 Use Cases

• Influencer research — Analyze top creators in any niche
• Competitor analysis — Track what content a brand publishes
• Trend discovery — Monitor hashtag performance over time
• Content marketing — Find viral video patterns for inspiration
• Market research — Understand audience engagement in your industry

⚠️ Limitations

• Only public profiles and hashtags are accessible
• The Actor scrolls to collect more results when requested, but the exact count depends on what TikTok exposes for the query and proxy session
• Private, banned, or age-restricted content is not accessible
• TikTok's structure may change, affecting scraping reliability

🔌 API Usage

curl -X POST \
  "https://api.apify.com/v2/acts/YOUR_USERNAME~tiktok-profile-hashtag-scraper/runs?token=YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "scrapeType": "user",
    "query": "charlidamelio",
    "maxItems": 50,
    "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"] }
  }'

🛠️ Local Development

git clone https://github.com/arda-ozkan/tiktok-profile-hashtag-scraper
cd tiktok-profile-hashtag-scraper
npm install
npm run check

Node.js 22 or newer is required. Set the APIFY_TOKEN environment variable and use npm run dev for local runs that use Apify Proxy.

⚖️ Responsible Use

This actor accesses only publicly available TikTok data. Do not use it to scrape private data, violate TikTok's Terms of Service, or for any unlawful purpose. The operator is not responsible for misuse.