TikTok Media and Metadata Retriever Extract media files and comprehensive metadata from TikTok posts with high reliability and structured output. This Apify actor handles various TikTok URL formats and provides detailed information about videos, images, user profiles, and engagement statistics. ## Features - 🎥 Media Extraction: Download high-quality videos and images from TikTok posts - 📊 Rich Metadata: Get comprehensive post information including user details, statistics, and content descriptions - 🔍 Flexible URLs: Support for all TikTok URL formats (vm.tiktok.com, vt.tiktok.com, www.tiktok.com) - 📱 Raw Data Option: Access to complete TikTok API response for advanced use cases - ⚡ Fast & Reliable: Built on proven extraction technology with robust error handling - 💰 Cost-Effective: Pay-per-use pricing at just $0.005 per extraction ## Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | url | string | ✅ | TikTok post URL (supports vm.tiktok.com, vt.tiktok.com, www.tiktok.com, and other TikTok link formats) | | raw | boolean | ❌ | Include raw TikTok API response with extended metadata (default: false) | ### Example Input json { "url": "https://www.tiktok.com/@realraywilliam/video/7528477815721807134", "raw": false } ## Output Format The actor returns structured data containing: ### User Information - Profile name and display name - Follower and following counts - Profile and banner images - User region information ### Content Details - Post link and unique identifier - Video/image title and description - Publication timestamp - Content appropriateness flags - Media files (videos/images) with download URLs ### Engagement Statistics - View count - Like count - Comment count - Share count - Follow count ### Example Output json { "type": "tiktok", "user": { "name": "realraywilliam", "displayName": "Ray William Johnson", "region": "US", "followers": 5200000, "friends": 189, "pictures": { "url": "https://...", "banner": "https://...", } }, "content": { "link": "https://www.tiktok.com/@realraywilliam/video/7528477815721807134", "text": "Video description here...", "title": "TikTok Video", "description": "Extracted description", "postedDate": 1704067200, "adult": false, "media": [ { "type": "video", "url": "https://...", "width": 720, "height": 1280, "duration": 15.5 } ], "statistics": { "views": 1250000, "likes": 95000, "comments": 2100, "shares": 8500, "follows": 450 } } } ## Supported URL Formats This actor supports all TikTok URL variations: - https://www.tiktok.com/@username/video/1234567890 - https://vm.tiktok.com/ZMeAbCdEf/ - https://vt.tiktok.com/ZSeAbCdEf/ - https://m.tiktok.com/v/1234567890 - Short URLs and redirects ## Error Handling The actor handles common TikTok-related errors gracefully: | Error | Description | HTTP Status | |-------|-------------|-------------| | Invalid URL | The provided URL is not a valid TikTok link | 400 | | Post Not Found | The TikTok post has been deleted or doesn't exist | 404 | | Private Post | The post is from a private account | 404 | | Rate Limited | Too many requests to TikTok's servers | 429 | | Network Error | Connection issues or TikTok downtime | 500 | ## Pricing Pay-per-Event Model: $0.005 per actor start - No monthly fees or subscriptions - Pay only for successful extractions - Transparent, usage-based pricing ## Use Cases - Social Media Analytics: Track TikTok performance metrics - Content Aggregation: Collect TikTok content for platforms or dashboards - Market Research: Analyze trending content and user engagement - Media Archival: Backup TikTok content with metadata - Academic Research: Study social media trends and behavior - Content Creation: Gather inspiration and analyze successful posts ## Technical Details This actor is built using: - Apify SDK v3 for robust actor framework - Custom TikTok Extractors with advanced parsing capabilities - Axios for reliable HTTP requests - Node.js Runtime for optimal performance The extraction process bypasses common anti-bot measures and provides consistent results across different TikTok URL formats. ## Support For questions, bug reports, or feature requests: - Create an issue in the actor's repository - Contact support through Apify Console - Check the Apify documentation for general usage help ## License This actor is provided as-is for legitimate use cases. Please respect TikTok's Terms of Service and applicable data protection regulations when using this tool. --- Ready to extract TikTok data? Run this actor now or integrate it into your application using the examples above. ## Related Actors Explore our other social media extraction actors: - Threads Media and Metadata Extractor - Extract media and metadata from Threads posts with support for text, images, videos, and carousel posts (threads.com/@username/post/POST_ID)