Skip to main content

​
General Questions

ContentStats.io is a social media analytics API that tracks video performance across TikTok, YouTube, Instagram, and Twitter. We provide hourly snapshots and historical data through a simple REST API.Unlike official platform APIs, we don’t require approval, business accounts, or complex OAuth flows.
Official APIs (TikTok, Instagram, YouTube):
  • Require approval (weeks/months wait)
  • Complex OAuth implementation
  • Limited to your own content
  • Daily quotas and strict rate limits
ContentStats.io:
  • ✅ Instant access with API key
  • ✅ Track ANY public video
  • ✅ No quotas or approval process
  • ✅ Hourly automated tracking
We currently support:
  • TikTok: Views, likes, comments, shares, saves
  • YouTube: Views, likes, comments
  • Instagram: Likes, comments, saves
  • Twitter/X: Views, likes, retweets, replies

​
Pricing & Billing

Simple pay-per-use pricing:
  • $0.015 per snapshot
  • No subscriptions or monthly fees
  • $5 free credit for new accounts (~333 snapshots)
Example: Track a video for 7 days
7 days × 24 hours = 168 snapshots
168 × $0.015 = $2.52
  • Charged per snapshot collected
  • Snapshots collected hourly
  • Deducted from your account balance
  • Add credits anytime (minimum $10)
  • Optional auto top-up available
Example: If you track 10 videos for 7 days each:
10 videos × 168 snapshots = 1,680 snapshots
1,680 × $0.015 = $25.20 total
When balance reaches $0:
  • Active tracking automatically pauses
  • All collected data is preserved
  • Add credits to resume tracking
  • Tracking continues from where it left off
Set up auto top-up to never run out!
Yes! Unused credits can be refunded within 30 days of purchase. You’re never charged for:
  • Failed snapshots
  • Platform errors
  • Videos that were deleted
Contact support@contentstats.io for refunds.
Yes! For high-volume usage (1M+ snapshots/month), we offer:
  • Volume discounts
  • Custom rate limits
  • Dedicated infrastructure
  • Priority support
  • SLA guarantees
Contact sales@contentstats.io.

​
Technical Questions

We collect snapshots every hour for the duration you specify. This means:
  • 24 snapshots per day
  • 168 snapshots per week
  • 720 snapshots per month
First snapshot within 60 minutes of starting tracking.
Forever! All historical data is stored indefinitely at no extra cost. You can access snapshots from videos tracked months or years ago.
No. We can only track publicly accessible content:
  • ✅ Public TikTok videos
  • ✅ Public YouTube videos (and unlisted)
  • ✅ Public Instagram posts/reels
  • ✅ Public tweets/X posts
  • ❌ Private accounts
  • ❌ Age-restricted content
  • ❌ Deleted videos
Rate limits depend on your plan:
PlanRate Limit
Free60 requests/minute
Pro300 requests/minute
EnterpriseCustom
Headers included in every response:
  • X-RateLimit-Limit
  • X-RateLimit-Remaining
  • X-RateLimit-Reset
Coming soon! Webhook support is in development. You’ll be able to subscribe to:
  • snapshot.created - New snapshot collected
  • tracking.completed - Tracking finished
  • balance.low - Balance below threshold

​
Account & API Keys

  1. Sign up (free)
  2. Go to Dashboard → API Keys
  3. Click “Create New Key”
  4. Copy and save your key (shown once)
Keys start with cs_live_ for production or cs_test_ for testing.
Yes! Create multiple keys for:
  • Different environments (dev, staging, prod)
  • Team members
  • Different applications
Track usage per key in your dashboard.
If your key is exposed:
  1. Delete it immediately in dashboard
  2. Create a new key
  3. Update your application
  4. Review usage logs for unauthorized activity
Deleted keys stop working instantly.
No, API keys don’t expire automatically. However, we recommend:
  • Rotating keys every 90 days
  • Deleting unused keys
  • Using separate keys per environment

​
Use Cases

Yes! Track any public video from any account. Common uses:
  • Monitor competitor content performance
  • Analyze their engagement patterns
  • Track their posting frequency
  • Identify their top-performing content
This is impossible with official APIs (they only allow tracking your own content).
Yes! Perfect for influencer vetting:
  • Track their recent posts for 3-7 days
  • Analyze engagement patterns
  • Verify authentic engagement growth
Absolutely! Track your own videos to:
  • Monitor performance in real-time
  • Get hourly growth data
  • Build historical performance database
Much more powerful than native platform analytics.

​
Platform-Specific

See our complete guide: How to Track TikTok VideosQuick example:
curl -X POST https://contentstats.io/api/v1/videos/track \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "video_link": "https://www.tiktok.com/@user/video/123",
    "duration_days": 7
  }'
See: How to Get YouTube Video StatsNo YouTube Data API quotas or OAuth needed!
Yes! We support both:
  • Instagram posts (/p/...)
  • Instagram reels (/reel/...)
Same metrics for both: likes, comments, saves.
Not yet. Currently we only support:
  • Regular TikTok videos
  • YouTube videos (not livestreams)
  • Instagram posts/reels
  • Twitter/X posts
Live stream support coming soon!

​
Troubleshooting

Common causes:
  • Insufficient balance: Add credits
  • Invalid video URL: Check URL format
  • Private video: Only public videos work
  • Video deleted: Cannot track deleted content
Check the error message in API response for details.
  • First snapshot takes up to 1 hour
  • Platform delays (YouTube especially)
  • Video was deleted
  • Platform temporarily unavailable
Wait 60 minutes after starting tracking.
Tracking auto-stops when:
  • Balance reaches $0 (pauses until you add credits)
  • Duration completed
  • Video was deleted
  • You manually stopped it
Check video status in dashboard or via API.
Platforms cache view counts:
  • YouTube: Can cache for hours
  • TikTok: Usually real-time
  • Instagram: Updates frequently
This is platform behavior, not our limitation.

​
Still Have Questions?

Contact Support

Get help from our team

API Documentation

Technical documentation

Quickstart Guide

Get started in 5 minutes

Platform Status

Check API status