TikTok Posts Scraper

TikTok Posts Scraper

A fast and reliable TikTok scraper that extracts posts, video metadata, and engagement data from profiles, hashtags, and keyword searches. Collect thousands of TikTok posts with full details — including video stats, author info, captions, hashtags, and music data. Export to JSON, CSV, or Excel with no coding required.

Use cases

• Social media monitoring — Track brand mentions, competitor content, and trending topics across TikTok
• Influencer research — Evaluate creator performance by analyzing post frequency, engagement rates, and content themes
• Trend analysis — Discover emerging hashtags, sounds, and content formats before they peak
• Market research — Understand audience interests and content preferences in any niche or region
• Academic research — Collect structured TikTok datasets for social media studies and NLP projects
• Content strategy — Identify top-performing post formats, optimal posting patterns, and high-engagement topics
• Competitor benchmarking — Compare engagement metrics, posting cadence, and content mix across competing accounts

Features

• Multiple scraping modes — Scrape by profile, hashtag, keyword search, or paste any TikTok URL directly
• Smart URL detection — Paste video, profile, hashtag, search, or music URLs and the Actor auto-detects the type
• Flexible sorting — Sort results by latest, most popular, relevance, most liked, or date posted
• Date filters — Filter keyword searches by time range (yesterday, this week, this month, up to all time)
• Region targeting — Specify a country code to get region-specific content results
• Rich output data — Every post includes video metadata, engagement metrics, author profile, hashtags, music info, and more
• Scalable — Scrape from 1 to 10,000 posts per run with configurable limits per profile or search
• Fast extraction — Bulk data retrieval with efficient pagination, no browser emulation needed

Input

Field	Description	Default
Start URLs	Paste TikTok URLs directly (video, profile, hashtag, search, music). Overrides Scrape Mode when provided.	—
Scrape Mode	Choose profiles, hashtag, or keyword	profiles
TikTok Profiles	List of usernames to scrape (without @)	—
Hashtag	Hashtag to search (without #)	—
Search Keyword	Keyword or phrase to search	—
Max Results	Maximum posts to return (hashtag/keyword modes)	50
Max Results Per Profile	Maximum posts per profile	30
Sort By	Sort order: latest, popular, relevance, most-liked, date-posted	—
Date Posted Filter	Time range filter for keyword searches	—
Region	2-letter country code (e.g., US, GB, FR) for region-specific results	—

Input examples

Scrape posts from specific profiles:

{
    "scrapeMode": "profiles",
    "profiles": ["charlidamelio", "khaby.lame"],
    "maxResultsPerProfile": 50,
    "sortBy": "popular"
}

Search by hashtag:

{
    "scrapeMode": "hashtag",
    "hashtag": "fyp",
    "maxResults": 100
}

Keyword search with filters:

{
    "scrapeMode": "keyword",
    "keyword": "cooking recipes",
    "maxResults": 200,
    "sortBy": "most-liked",
    "datePosted": "this-month",
    "region": "US"
}

Paste URLs directly:

{
    "startUrls": [
        "https://www.tiktok.com/@charlidamelio",
        "https://www.tiktok.com/tag/fyp",
        "https://www.tiktok.com/search?q=cooking"
    ]
}

Output

Each post in the output dataset includes:

• Video details — ID, description/caption, creation timestamp, duration, dimensions, cover images, download URLs
• Engagement metrics — plays, likes, comments, shares, saves, and reposts count
• Author info — username, display name, avatar, verified status, follower/following counts, bio
• Hashtags — All hashtags used in the post
• Music/sound — Title, author, album, duration, and cover image of the audio used
• Additional metadata — Region, language, content warnings, and original sound flags

Output example

{
    "id": "7345678901234567890",
    "text": "This is a sample TikTok caption #fyp #viral",
    "createTime": 1709251200,
    "createTimeISO": "2024-03-01T00:00:00.000Z",
    "authorMeta": {
        "id": "123456789",
        "name": "username",
        "nickName": "Display Name",
        "verified": true,
        "fans": 150000000,
        "heart": 2000000000
    },
    "videoMeta": {
        "duration": 15,
        "width": 1080,
        "height": 1920
    },
    "diggCount": 5000000,
    "shareCount": 100000,
    "playCount": 50000000,
    "commentCount": 75000,
    "hashtags": [
        { "name": "fyp" },
        { "name": "viral" }
    ],
    "musicMeta": {
        "musicName": "Original Sound",
        "musicAuthor": "username"
    }
}

FAQ

How many posts can I scrape per run? You can scrape up to 10,000 posts per run for hashtag and keyword searches, and up to 5,000 posts per profile. Adjust the Max Results settings to control volume and cost.

Can I scrape multiple profiles in a single run? Yes. Add as many usernames as you need to the Profiles list. Each profile is scraped independently with its own results limit.

What URL formats are supported? The Actor accepts standard TikTok URLs for videos, profiles, hashtags, search queries, and music/sound pages. Short URLs (vm.tiktok.com) are also supported.

How does region targeting work? Set a 2-letter country code (ISO 3166-1) in the Region field. This influences which content TikTok returns, similar to browsing from that country.

Is the output compatible with other TikTok scrapers? Yes. The output schema is designed to be compatible with popular TikTok scraper formats, making it easy to switch or combine data sources without changing your pipeline.

Can I schedule recurring scrapes? Yes. Use Apify's built-in scheduler to run the Actor on a daily, weekly, or custom schedule. Combined with Apify integrations, you can automatically push results to Google Sheets, Slack, webhooks, or any API.

Disclaimer

This Actor is an unofficial tool and is not affiliated with, endorsed by, or sponsored by TikTok or ByteDance Ltd. All product names, trademarks, and registered trademarks are the property of their respective owners. Use this Actor responsibly and in compliance with TikTok's Terms of Service.