Platform Support

Influtics API supports video tracking across TikTok, Instagram, and YouTube with comprehensive analytics for each platform.

🎯 Supported Platforms

TikTok 📱

Track videos, engagement metrics, and creator statistics across all TikTok content.

Supported URL Formats

✅ https://www.tiktok.com/@username/video/1234567890123456789
✅ https://vm.tiktok.com/ZMNdYPzKT/
✅ https://m.tiktok.com/@username/video/1234567890123456789
✅ https://tiktok.com/@username/video/1234567890123456789

Available Metrics

📊 Views: Total video views
❤️ Likes: Like count and engagement rate
💬 Comments: Comment count and activity
🔄 Shares: Share count and viral potential
👤 Creator Stats: Follower count, verification status

Platform Features

Real-time engagement tracking
Viral content detection
Creator influence scoring
Hashtag performance analysis

Instagram 📸

Monitor Reels, Stories, and Posts with detailed performance insights.

Supported URL Formats

✅ https://www.instagram.com/reel/CqABCDEFGHI/
✅ https://instagram.com/reel/CqABCDEFGHI/
✅ https://www.instagram.com/p/CqABCDEFGHI/
✅ https://instagram.com/p/CqABCDEFGHI/
✅ https://ig.me/shortlink

Available Metrics

👀 Views: Reel and video views
💖 Likes: Like count and ratio
💭 Comments: Comment engagement
📤 Shares: Share and save counts
📊 Creator Data: Profile stats, verification

Content Types Supported

Reels: Short-form video content
Video Posts: Standard video posts
Carousel Videos: Multi-slide video content
IGTV: Long-form video content

YouTube 🎥

Analyze Shorts, regular videos, and comprehensive performance data.

Supported URL Formats

✅ https://www.youtube.com/watch?v=dQw4w9WgXcQ
✅ https://youtu.be/dQw4w9WgXcQ
✅ https://youtube.com/shorts/dQw4w9WgXcQ
✅ https://www.youtube.com/shorts/dQw4w9WgXcQ
✅ https://m.youtube.com/watch?v=dQw4w9WgXcQ

Available Metrics

📈 Views: Total view count
👍 Likes: Like and dislike ratios
💬 Comments: Comment count and engagement
📊 Performance: View velocity and retention
🎯 Channel Data: Subscriber count, channel stats

Video Types Supported

YouTube Shorts: Vertical short-form content
Regular Videos: Standard horizontal videos
Live Streams: Real-time streaming content
Premieres: Scheduled video releases

... (rest of file unchanged) ...

🎯 Supported Platforms

TikTok 📱

Track videos, engagement metrics, and creator statistics across all TikTok content.

Supported URL Formats

✅ https://www.tiktok.com/@username/video/1234567890123456789
✅ https://vm.tiktok.com/ZMNdYPzKT/
✅ https://m.tiktok.com/@username/video/1234567890123456789
✅ https://tiktok.com/@username/video/1234567890123456789

Available Metrics

📊 Views: Total video views
❤️ Likes: Like count and engagement rate
💬 Comments: Comment count and activity
🔄 Shares: Share count and viral potential
👤 Creator Stats: Follower count, verification status

Platform Features

Real-time engagement tracking
Viral content detection
Creator influence scoring
Hashtag performance analysis

Instagram 📸

Monitor Reels, Stories, and Posts with detailed performance insights.

Supported URL Formats

✅ https://www.instagram.com/reel/CqABCDEFGHI/
✅ https://instagram.com/reel/CqABCDEFGHI/
✅ https://www.instagram.com/p/CqABCDEFGHI/
✅ https://instagram.com/p/CqABCDEFGHI/
✅ https://ig.me/shortlink

Available Metrics

👀 Views: Reel and video views
💖 Likes: Like count and ratio
💭 Comments: Comment engagement
📤 Shares: Share and save counts
📊 Creator Data: Profile stats, verification

Content Types Supported

Reels: Short-form video content
Video Posts: Standard video posts
Carousel Videos: Multi-slide video content
IGTV: Long-form video content

YouTube 🎥

Analyze Shorts, regular videos, and comprehensive performance data.

Supported URL Formats

✅ https://www.youtube.com/watch?v=dQw4w9WgXcQ
✅ https://youtu.be/dQw4w9WgXcQ
✅ https://youtube.com/shorts/dQw4w9WgXcQ
✅ https://www.youtube.com/shorts/dQw4w9WgXcQ
✅ https://m.youtube.com/watch?v=dQw4w9WgXcQ

Available Metrics

📈 Views: Total view count
👍 Likes: Like and dislike ratios
💬 Comments: Comment count and engagement
📊 Performance: View velocity and retention
🎯 Channel Data: Subscriber count, channel stats

Video Types Supported

YouTube Shorts: Vertical short-form content
Regular Videos: Standard horizontal videos
Live Streams: Real-time streaming content
Premieres: Scheduled video releases

🔄 URL Processing

Automatic URL Resolution

The API automatically handles:

Shortened URLs: vm.tiktok.com, youtu.be, ig.me
Mobile URLs: m.tiktok.com, m.youtube.com
Redirects: Automatic following of redirects
Parameter Cleanup: Removes tracking parameters

URL Validation

// Example: URL validation and platform detection
const response = await fetch('/v1/videos/track', {
  method: 'POST',
  headers: { 'Authorization': 'Bearer api_key' },
  body: JSON.stringify({ url: videoUrl })
});

// Response includes detected platform
{
  "success": true,
  "data": {
    "platform": "TikTok",  // Auto-detected
    "url": "https://www.tiktok.com/@user/video/123",
    "stats": { ... }
  }
}

📊 Platform-Specific Features

TikTok Advantages

Real-time updates: Sub-hour data refresh
Viral tracking: Detect trending content early
Creator insights: Detailed influencer analytics
Hashtag analysis: Track hashtag performance

Instagram Benefits

Story tracking: Monitor story performance
Reel analytics: Comprehensive Reel insights
Engagement quality: Deep engagement analysis
Creator metrics: Profile and content stats

YouTube Strengths

Watch time data: Video retention metrics
Subscriber impact: Track subscriber growth
Search rankings: Monitor search performance
Revenue insights: Monetization analytics

⚠️ Platform Limitations

TikTok Limitations

Private accounts: Cannot track private videos
Age-restricted content: Limited access to some content
Regional blocks: Some content may be geo-restricted

Instagram Limitations

Private accounts: Cannot access private content
Story expiration: Stories disappear after 24 hours
Limited metrics: Some metrics require business accounts

YouTube Limitations

Private videos: Cannot track unlisted/private content
Age restrictions: Limited access to age-restricted videos
Channel settings: Some metrics depend on channel privacy

🎯 Content Types Matrix

Feature	TikTok	Instagram	YouTube
Short Videos	✅ All videos	✅ Reels	✅ Shorts
Long Videos	❌ N/A	✅ IGTV	✅ Regular videos
Live Streams	✅ Live videos	✅ Live streams	✅ Live streams
Stories	❌ N/A	✅ Story videos	❌ N/A
Carousel	❌ N/A	✅ Multi-slide	❌ N/A

🔧 Best Practices

URL Format Optimization

# ✅ Preferred: Use canonical URLs
https://www.tiktok.com/@username/video/1234567890

# ✅ Also works: Shortened URLs (auto-resolved)
https://vm.tiktok.com/shortlink

# ⚠️ Avoid: URLs with excessive parameters
https://www.tiktok.com/@user/video/123?utm_source=...&tracking=...

Error Handling

try {
  const result = await trackVideo(videoUrl);
  console.log('Platform:', result.data.platform);
} catch (error) {
  if (error.code === 'VIDEO_NOT_FOUND') {
    console.log('Video is private or deleted');
  } else if (error.code === 'INVALID_URL') {
    console.log('URL format not supported');
  }
}

Platform Detection

def detect_platform(url):
    if 'tiktok.com' in url:
        return 'TikTok'
    elif 'instagram.com' in url:
        return 'Instagram'  
    elif 'youtube.com' in url or 'youtu.be' in url:
        return 'YouTube'
    else:
        return 'Unknown'

📈 Performance by Platform

Update Frequency

TikTok: Every 2-6 hours
Instagram: Every 4-8 hours
YouTube: Every 6-12 hours

Data Accuracy

TikTok: 99.5% accuracy
Instagram: 98.8% accuracy
YouTube: 99.2% accuracy

Processing Speed

TikTok: ~2-3 seconds
Instagram: ~3-4 seconds
YouTube: ~4-5 seconds

🆘 Troubleshooting

Common Issues

"Video Not Found"

Video may be private or deleted
URL format might be incorrect
Platform may have regional restrictions

"Invalid URL Format"

Check supported URL patterns above
Remove unnecessary parameters
Ensure URL is publicly accessible

"Partial Data Returned"

Some metrics may not be available immediately
Try again after a few minutes
Check if the video is newly published

Platform-Specific Issues

TikTok Issues

{
  "error": "TikTok video is age-restricted",
  "code": "AGE_RESTRICTED_CONTENT",
  "solution": "Video cannot be tracked due to age restrictions"
}

Instagram Issues

{
  "error": "Instagram account is private",
  "code": "PRIVATE_ACCOUNT",
  "solution": "Cannot access content from private accounts"
}

YouTube Issues

{
  "error": "YouTube video is unlisted",
  "code": "UNLISTED_VIDEO",
  "solution": "Unlisted videos cannot be tracked"
}

Need help with a specific platform? Contact Support →