🎵 TikTok Scraper Extract videos, profiles, hashtags, and search results from TikTok - the world's most popular short-video platform. --- ## 🚀 How to scrape TikTok in 5 steps 1. Create a free Apify account using your email. 2. Open TikTok Scraper. 3. Add hashtags, profiles, video URLs, or search queries. 4. Click "Start" and wait for the data to be extracted. 5. Download your data in JSON, XML, CSV, Excel, or HTML. --- ## ✨ What You Get ### 📹 Video Data | Field | Description | |-------|-------------| | videoId | Unique TikTok video ID | | description | Video caption with hashtags | | createTime | Unix timestamp | | createTimeISO | Human-readable date | | duration | Video length in seconds | | videoUrl | Direct link to video | | downloadUrl | Video download URL | | playUrl | Streaming URL | | coverUrl | Thumbnail image | ### 📊 Engagement Stats | Field | Description | |-------|-------------| | likes | Heart count | | comments | Comment count | | shares | Share count | | views | View count | | saves | Bookmark count | ### 👤 Author Info | Field | Description | |-------|-------------| | authorUniqueId | Username | | authorNickname | Display name | | authorSignature | Bio text | | authorVerified | Blue checkmark | | authorAvatarUrl | Profile picture | ### 🎵 Music Info | Field | Description | |-------|-------------| | musicTitle | Sound name | | musicAuthor | Artist/creator | | musicCoverUrl | Album art | ### 🏷️ Extra | Field | Description | |-------|-------------| | hashtags | Array of hashtag names | | isPinned | Pinned to profile | | downloadedVideoUrl | KV Store link (if downloaded) | | downloadedCoverUrl | KV Store link (if downloaded) | --- ## 🚀 Quick Start ### #️⃣ Scrape Hashtags Get trending videos from any hashtag: json { "hashtags": ["fyp", "viral", "trending"], "resultsPerPage": 20 } --- ### 👤 Scrape Profiles Get all videos from a creator: json { "profiles": ["tiktok", "charlidamelio"], "profileSorting": "popular", "resultsPerPage": 50 } --- ### 🔍 Search TikTok Find videos or users by keyword: json { "searchQueries": ["funny cats", "cooking recipes"], "searchSection": "/video", "resultsPerPage": 30 } --- ### 🔗 Scrape Specific Videos Paste URLs or just video IDs: json { "postURLs": [ "https://www.tiktok.com/@user/video/1234567890", "7578160501549567288" ] } --- ### 📥 Download Videos Without Watermark json { "profiles": ["tiktok"], "resultsPerPage": 10, "shouldDownloadVideos": true, "downloadWithoutWatermark": true } --- ## ⚙️ Input Options ### 📍 Scraping Sources | Parameter | Description | |-----------|-------------| | hashtags | Hashtags to scrape (fyp, #viral, or full URL) | | profiles | Usernames to scrape (tiktok, @user, or full URL) | | searchQueries | Search terms | | postURLs | Video URLs or numeric IDs | ### 👤 Profile Options | Parameter | Default | Description | |-----------|---------|-------------| | profileSorting | latest | Sort: latest, popular, oldest | | excludePinnedPosts | false | Skip pinned videos | ### 🔍 Search Options | Parameter | Default | Description | |-----------|---------|-------------| | searchSection | Top | Search: Top, /video, or /user | ### 🎛️ Filters | Parameter | Description | |-----------|-------------| | resultsPerPage | Max videos per input (1-1000) | | oldestPostDate | Only posts after this date | | newestPostDate | Only posts before this date | | minLikes / maxLikes | Filter by likes | | minViews / maxViews | Filter by views | ### 📥 Media Downloads | Parameter | Default | Description | |-----------|---------|-------------| | shouldDownloadVideos | false | Download video files | | downloadWithoutWatermark | false | Remove TikTok watermark | | shouldDownloadCovers | false | Download thumbnails | | shouldDownloadAvatars | false | Download profile pics | | shouldDownloadMusicCovers | false | Download music art | | mediaKvStoreName | default | Custom KV Store name | ### 🌍 Proxy | Parameter | Default | Description | |-----------|---------|-------------| | proxyCountryCode | None | Country for geo-restricted content | --- ## 💡 Tips - 🎯 Flexible input - Enter tiktok, @tiktok, or full URL - all work! - 🔢 Video IDs - Just paste the number, no URL needed - 📅 Date filters - Use 2024-01-15 or 7 days (relative) - 📌 Skip pinned - Enable to get organic content only - ✨ No watermark - Works on most videos, may fail on protected content - 🌐 Geo-blocked? - Use proxy country to access regional content --- ## 🎯 Who is this for? Marketers — Find trending content, track hashtag performance, discover influencers worth partnering with. Researchers — Collect data for academic studies, sentiment analysis, or trend forecasting. Brands — Monitor competitors, analyze what content performs, plan your TikTok strategy. Developers — Feed TikTok data into your apps, dashboards, or AI models via API. Agencies — Deliver TikTok insights to clients, automate reporting, scale your services. --- ## 💰 Pricing This Actor uses pay-per-event pricing. You only pay for what you use: | What you pay for | When it's charged | |------------------|-------------------| | 🚀 Actor start | Each time you run the scraper | | 📄 Result | Per video added to your dataset | | 🎛️ Filters | When filtering by date, likes, or views | | 📥 Video download | When saving videos to storage | | 🌍 Country proxy | When using location-specific proxy | --- ## 🔌 Works with your stack Export data directly to Google Sheets, Slack, Airtable, or your own database. Connect via Zapier, Make, webhooks, or the Apify API. --- ## ⚠️ Good to know - TikTok has rate limits — the scraper handles retries automatically - Private or deleted videos are skipped - No-watermark downloads use TikTok's internal endpoints (may change) - Only public data is collected — no private user info --- ## 📞 Need help? Open an issue on GitHub