Skip to main content

​
Get Started in 5 Minutes

This guide will help you make your first API request and start tracking social media videos.
1

Create Your Account

Sign up at contentstats.io/auth/signupYou’ll receive $5.00 free credit (~333 free snapshots) to get started.
2

Generate an API Key

  1. Go to your Dashboard
  2. Navigate to API Keys
  3. Click “Create New Key”
  4. Copy your key (it starts with cs_live_...)
Your API key is shown only once. Store it securely and never commit it to version control.
3

Track Your First Video

Use the /api/v1/videos/track endpoint to start monitoring:
curl -X POST https://contentstats.io/api/v1/videos/track \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cs_live_YOUR_KEY" \
  -d '{
    "video_link": "https://www.tiktok.com/@user/video/123",
    "duration_days": 7
  }'

{
  "id": "cm5abc123def",
  "job_id": "job_xyz789",
  "video_link": "https://www.tiktok.com/@user/video/123",
  "platform": "tiktok",
  "status": "monitoring",
  "monitoring_duration_days": 7,
  "days_remaining": 7,
  "estimated_cost": 2.52,
  "created_at": "2024-01-29T10:00:00.000Z"
}
4

Check Video Status

Use the video id to get snapshots:
curl https://contentstats.io/api/v1/videos/cm5abc123def \
  -H "X-API-Key: cs_live_YOUR_KEY"

{
  "id": "cm5abc123def",
  "video_link": "https://www.tiktok.com/@user/video/123",
  "platform": "tiktok",
  "status": "monitoring",
  "snapshots": [
    {
      "snapshot_time": "2024-01-29T10:00:00.000Z",
      "views": "150000",
      "likes": "12500",
      "comments": "350",
      "shares": "890"
    },
    {
      "snapshot_time": "2024-01-29T11:00:00.000Z",
      "views": "165000",
      "likes": "13200",
      "comments": "380",
      "shares": "920"
    }
  ]
}

​
What Happens Next?

Once tracking starts:
  1. Hourly Snapshots: We collect metrics every hour for the duration you specified
  2. Automatic Billing: Each snapshot costs $0.015, deducted from your balance
  3. Email Updates: Get notified when tracking completes or if your balance is low
You can track videos from any of these platforms: 
https://www.tiktok.com/@username/video/1234567890
https://vm.tiktok.com/abc123/
Metrics: Views, Likes, Comments, Shares, Saves

​
Cost Calculation

Understanding your costs: 
Cost = Duration (days) × 24 hours × $0.015 per snapshot

Example for 7 days:
7 × 24 × $0.015 = $2.52
Your $5 free credit covers about 333 snapshots, or ~14 days of tracking a single video.

​
Managing Your Balance

Check your usage and balance anytime: 
curl https://contentstats.io/api/v1/usage \
  -H "X-API-Key: cs_live_YOUR_KEY"

{
  "balance_usd": 5.00,
  "total_snapshots": 0,
  "active_videos": 1,
  "uncharged_usage_usd": 0.015,
  "estimated_snapshots_remaining": 333,
  "cost_per_snapshot": 0.015
}

​
Next Steps

Authentication

Learn about API keys and security best practices

API Reference

Explore all available endpoints

TikTok Guide

Detailed guide for tracking TikTok videos

Error Handling

Handle errors and edge cases

​
Common Questions

The first snapshot is captured within the first hour of tracking. You’ll receive hourly updates after that.
Yes! Use the stop endpoint to end monitoring at any time. You’ll only pay for snapshots already collected.
Tracking will automatically pause. Add more credit to resume. Your data is saved and tracking continues from where it left off.
Absolutely! Track as many videos as you want across all platforms simultaneously.
Need help? Check our FAQ or contact support.