v1.0
Powered by

Platform Support

Influtics API supports video tracking across 9 platforms with comprehensive analytics for each.

Supported Platforms

Platform Identifier Example URLs Content Types Available Metrics
TikTok tiktok https://www.tiktok.com/@user/video/<id>
https://vm.tiktok.com/<short_code>
https://m.tiktok.com/@user/video/<id>
https://tiktok.com/@user/video/<id>		 Video, Slideshow Views, Likes, Comments, Reposts, Saves
Instagram instagram https://www.instagram.com/reel/<id>/
https://instagram.com/reel/<id>/
https://www.instagram.com/p/<id>/
https://instagram.com/p/<id>/
https://ig.me/<shortlink>		 Reel, Video Post, Carousel Views, Likes, Comments, Reposts
YouTube youtube https://www.youtube.com/watch?v=<id>
https://youtu.be/<id>
https://youtube.com/shorts/<id>
https://www.youtube.com/shorts/<id>
https://m.youtube.com/watch?v=<id>		 Short, Regular Video, Premiere Views, Likes, Comments
Telegram telegram https://t.me/<channel>/<message_id>
https://t.me/c/<channel_id>/<message_id>		 Post Views, Comments, Reposts
VK vk https://vk.com/video<owner>_<id>
https://vk.com/wall<owner>_<id>		 Video Clip, Wall Video Views, Likes, Comments, Reposts
OK ok https://ok.ru/video/<id> Video Views, Likes, Reposts
Dzen dzen https://dzen.ru/video/watch/<id> Video, Article Views, Likes, Comments
Threads threads https://www.threads.net/@user/post/<id>
https://www.threads.com/@user/post/<id>		 Text Post, Video Post, Carousel Views, Likes, Comments, Reposts, Saves
Pinterest pinterest https://www.pinterest.com/pin/<id>/ Pin, Idea Pin (Video Slideshow) Views, Likes, Comments, Reposts, Saves

🔄 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 Limitations

TikTok

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

  • Example error:

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

Instagram

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

  • Example error:

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

YouTube

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

  • Example error:

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

🔧 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'

🆘 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

Need help with a specific platform? Contact Support →

© Influtics