soclip-cli

CLI tool to extract social video media direct links and metadata via Soclip API

Source

npm

Version: 0.1.0

Version published: 2 months ago

Weekly downloads: 16

Maintainers: 1

Weekly downloads

Created: 2 months ago

Source

soclip

Official CLI tool to extract social video media direct links and metadata from TikTok, YouTube, Instagram, X/Twitter, and more via soclip.dev.

Installation

npm install -g soclip

Setup API Key

Get your API key at https://soclip.dev, then configure it in your environment:

soclip config set-key <your-api-key>

Alternatively, set the SOCLIP_API_KEY environment variable:

export SOCLIP_API_KEY="your-api-key"

Usage & Examples

1. Extract Video Summary & Available Qualities

soclip "https://www.tiktok.com/@scout2015/video/6718335390841801990"

Output:

Title:     Scout's favorite game!
Source:    tiktok
Duration:  15s
Thumbnail: https://p16-sign-va.tiktokcdn.com/obj/tos-maliva-p-0068/123456789.jpg

Qualities (2):
  - 1080p [1080x1920]
  - 720p [720x1280]

Use --quality best|worst|<height> to get a direct link, or --json for the full response.

2. Output Direct Video Link (`--quality best`)

soclip "https://www.tiktok.com/@scout2015/video/6718335390841801990" --quality best

Output:

https://v16-webapp-prime.tiktok.com/video/tos/useast2a/tos-useast2a-ve-0068c001/ogB...

3. Check Account Balance

soclip balance

Output:

Balance: 100 credits

Optional: Full JSON Output

soclip "https://www.tiktok.com/@scout2015/video/6718335390841801990" --json

Supported Platforms

TikTok (Videos, Slides)
YouTube (Shorts, Standard Videos)
Instagram (Reels, Posts)
X / Twitter (Videos, GIFs)
Douyin, Bilibili, Kuaishou, and more.

Pricing

1 credit = $0.001. Each successful media extraction costs 2 credits ($0.002). Credits never expire. Get started with free trial credits at https://soclip.dev.