TikTok Keyword Search Scraper This actor searches TikTok videos by keyword and retrieves comprehensive video metadata. ## Features - Search videos by any keyword or phrase - Filter by date posted (today, this week, this month, etc.) - Sort by relevance, date, or views - Specify region for localized results - Automatic pagination support (fetches all pages by default) - Detailed video metadata including statistics, author info, and video URLs ## Input Parameters | Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | query | string | ✅ | - | Search keyword or phrase | | date_posted | string | ❌ | - | Filter by date: 'today', 'this-week', 'this-month', 'this-year' | | sort_by | string | ❌ | 'relevance' | Sort order: 'relevance', 'date', 'views' | | region | string | ❌ | 'US' | Country code for regional results (US, UK, DE, etc.) | | max_results | number | ❌ | 100 | Maximum videos to fetch (0 = unlimited) | | trim | boolean | ❌ | false | Return trimmed response with only essential fields | ## Example Input json { "query": "funny cats", "date_posted": "this-week", "sort_by": "views", "region": "US", "max_results": 50, "trim": false } ## Output Format Returns an array of video objects containing: - Video ID, description, and statistics - Author profile information - Video URLs (multiple quality options) - Creation timestamp and region - Complete metadata from TikTok API ## Usage This actor is perfect for: - Content research and trend analysis - Competitor analysis - Market research by topic - Building datasets for content strategy - Finding viral content in specific niches --- Built with ❤️ by SociaVault