🎵 TikTok Search Videos Scraper - Powerful Video Search & Data Extraction

Search and scrape TikTok videos by keywords with comprehensive metadata extraction. Get video details, engagement metrics, author information, music data, and direct download links. Supports advanced filtering by region, publish time, and sort type!

📋 Table of Contents

• 🚀 Features
• 🎯 Use Cases
• ⚡ Quick Start
• 📊 Input Parameters
• 📤 Output Format
• 🔧 Configuration
• 📈 Performance
• ❓ FAQ
• 🛠️ Troubleshooting
• 📞 Support

🚀 Features

🔍 Powerful Search Capabilities

• ✅ Keyword-Based Search - Search TikTok videos using any keywords
• ✅ Advanced Filtering - Filter by region, publish time, and sort type
• ✅ Pagination Support - Automatically fetch multiple pages of results
• ✅ Customizable Results - Control the number of videos to scrape
• ✅ Real-Time Data - Get the latest trending videos and content

📊 Comprehensive Metadata Extraction

• ✅ Video Details - Title, description, duration, region, and video IDs
• ✅ Engagement Metrics - Views, likes, comments, shares, and downloads
• ✅ Author Information - Username, nickname, user ID, and avatar
• ✅ Music Data - Song title, artist, duration, and audio URL
• ✅ Visual Assets - Cover images, thumbnails, and dynamic covers
• ✅ Download Links - Direct video URLs (with and without watermark)

🌍 Global & Regional Support

• ✅ Multi-Region Search - Search across US, Japan, Korea, Vietnam, Brazil, Russia, and more
• ✅ Time-Based Filtering - Filter by past 24 hours, week, month, or custom periods
• ✅ Smart Sorting - Sort by relevance, like count, or date posted
• ✅ Regional Content - Access region-specific trending content

🎯 Use Cases

Use Case	Description	Benefits
📊 Trend Analysis	Track trending topics and viral content	Identify popular hashtags, monitor content trends
🎯 Competitor Research	Analyze competitor content and engagement	Benchmark performance, discover successful strategies
📢 Influencer Marketing	Find relevant creators and content	Identify partnership opportunities, track influencer performance
🎵 Music Discovery	Discover trending songs and audio tracks	Find popular music, track audio usage
📝 Content Inspiration	Gather ideas for content creation	Analyze successful formats, discover creative concepts
📈 Social Media Analytics	Monitor brand mentions and sentiment	Track engagement metrics, measure campaign performance
🎓 Academic Research	Study social media behavior and trends	Collect data for research, analyze user engagement patterns

⚡ Quick Start

1️⃣ Basic Search

{
  "keywords": "funny cats",
  "region": "us",
  "maxItems": 20
}

2️⃣ Advanced Search with Filters

{
  "keywords": "dance challenge",
  "region": "us",
  "publish_time": 7,
  "sort_type": 1,
  "maxItems": 50
}

3️⃣ Trending Content Search

{
  "keywords": "viral trends",
  "region": "jp",
  "publish_time": 1,
  "sort_type": 1,
  "maxItems": 100
}

📊 Input Parameters

Parameter	Type	Required	Description	Example
keywords	String	✅	Search keywords for TikTok videos	"funny cats", "dance challenge"
region	String	❌	Region code for search results	"us", "jp", "kr" (default: "us")
publish_time	Integer	❌	Filter by publish time	0 (All), 1 (24h), 7 (Week), 30 (Month)
sort_type	Integer	❌	Sort results by	0 (Relevance), 1 (Likes), 3 (Date)
maxItems	Integer	❌	Maximum videos to scrape	20 (default), min: 1

🌍 Supported Regions

• 🇺🇸 us - United States
• 🇯🇵 jp - Japan
• 🇰🇷 kr - South Korea
• 🇻🇳 vn - Vietnam
• 🇧🇷 br - Brazil
• 🇷🇺 ru - Russia
• 🇩🇪 de - Germany
• 🇫🇷 fr - France
• 🇪🇸 es - Spain
• 🇮🇹 it - Italy

📤 Output Format

🎬 Video Data Structure

{
  "source": "tiktok",
  "aweme_id": "v12044gd0000d45h7l7og65ji6d67pe0",
  "video_id": "7569167709833841933",
  "region": "US",
  "title": "Funny pug #dog #dogsoftiktok #funny #pet #fyp",
  "cover": "https://...",
  "duration": 103,
  "play_url": "https://...",
  "download_url": "https://...",
  "size": 15298849,
  "music_url": "https://...",
  "music_info": {
    "id": "7569167771397868301",
    "title": "original sound - furball.diary",
    "author": "Furball Diary",
    "original": true,
    "duration": 103
  },
  "play_count": 5279936,
  "digg_count": 750319,
  "comment_count": 3309,
  "share_count": 162755,
  "download_count": 16220,
  "create_time": 1762334206,
  "author": {
    "id": "7445238900832240683",
    "unique_id": "furball.diary",
    "nickname": "Furball Diary",
    "avatar": "https://..."
  },
  "is_ad": false,
  "is_top": 0
}

📊 Data Fields Explained

• Engagement Metrics: Views, likes, comments, shares, downloads
• Video URLs: Direct play and download links (with/without watermark)
• Author Info: Complete creator profile data
• Music Data: Song details and audio URL
• Timestamps: Creation time in Unix format
• File Info: Video size in bytes and duration in seconds

🔧 Configuration

⏰ Publish Time Filters

Value	Description	Use Case
0	All Time	Get all videos regardless of age
1	Past 24 Hours	Latest trending content
7	This Week	Recent popular videos
30	This Month	Monthly trending content
90	Last 3 Months	Quarterly analysis
180	Last 6 Months	Long-term trends

📊 Sort Types

Value	Sort By	Best For
0	Relevance	Most relevant search results
1	Like Count	Most popular/viral content
3	Date Posted	Newest content first

📈 Performance

⚡ Speed Metrics

• Search Speed: ~1-3 seconds per request
• Pagination: Automatic handling of multiple result pages
• Batch Size: 10 videos per call
• Throughput: 100+ videos per minute
• Data Extraction: Real-time metadata processing

🔄 Reliability Features

• Retry Logic - Handles temporary failures with exponential backoff
• Rate Limiting - Smart throttling to prevent API blocks
• Error Handling - Comprehensive error reporting and recovery
• Cursor-Based Pagination - Efficient result fetching

❓ FAQ

Q: How many videos can I scrape?

A: You can scrape as many videos as needed using the maxItems parameter. The actor automatically handles pagination to fetch multiple pages of results.

Q: What regions are supported?

A: We support 10+ regions including US, Japan, Korea, Vietnam, Brazil, Russia, Germany, France, Spain, and Italy. Each region may return different trending content.

Q: Can I filter by video age?

A: Yes! Use the publish_time parameter to filter videos by:

• Past 24 hours (1)
• This week (7)
• This month (30)
• Last 3 months (90)
• Last 6 months (180)
• All time (0)

Q: How do I get the most popular videos?

A: Set sort_type to 1 to sort results by like count, which shows the most popular/viral content first.

Q: Are download links included?

A: Yes! Each video includes direct play and download URLs, both with and without watermarks.

Q: What about rate limits?

A: The actor includes retry logic to handle rate limits efficiently.

Q: Is this legal to use?

A: This tool is for research, analytics, and personal use. Users must comply with TikTok's Terms of Service and applicable laws.

🛠️ Troubleshooting

🚨 Common Issues

Issue	Cause	Solution
"Keywords are required"	Missing search keywords	Provide valid search keywords in the input
"No videos found"	No matching results	Try different keywords or adjust filters
"Request timeout"	Network issues	Retry the run, check API status
"Invalid region code"	Unsupported region	Use supported region codes (us, jp, kr, etc.)

🔍 Debug Tips

1. Start Small - Test with maxItems: 10 first before scaling up
2. Check Keywords - Ensure keywords are relevant and not too specific
3. Review Logs - Check actor run logs for detailed error messages
4. Region Testing - Try different regions if results are limited

📞 Support

🆘 Need Help?

• 📧 Issues: Report bugs and feature requests
• 💬 Community: Join our developer community
• 📖 Documentation: Comprehensive guides and examples
• 🎯 Best Practices: Optimization tips and tricks

---

🏷️ Keywords & Tags

tiktok scraper, tiktok search, tiktok api, tiktok videos, tiktok downloader, tiktok metadata, tiktok engagement metrics, tiktok analytics, tiktok trending, tiktok viral content, tiktok influencer, tiktok music, tiktok hashtags, tiktok author info, tiktok video extractor, tiktok batch scraper, tiktok apify actor, tiktok automation, tiktok data extraction, tiktok research tool, social media scraper, tiktok content analysis, tiktok video downloader, download tiktok video without watermark, tiktok video viewer, tiktok video search engine, tiktok video search tool, tiktok video search by keywords.

---

🔗 Related Actor

• TikTok Trending Videos Scraper
• TikTok Media Downloader
• TikTok Comments Scraper

⭐ Star this actor if it helps you scrape TikTok content efficiently!

Built with ❤️ using Apify Platform