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

{
  "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

{
  "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)