creatorcrawl CLI

0.3 returns the new canonical response shape — see the SDK changelog for details.

Official command-line interface for CreatorCrawl. Scrape TikTok, Instagram, YouTube, LinkedIn, Twitter/X, and Reddit from your terminal or shell scripts.

npx creatorcrawl tiktok profile khaby.lame
npx creatorcrawl youtube transcript https://youtu.be/...
npx creatorcrawl linkedin company https://www.linkedin.com/company/openai

Install

Install with the hosted script on macOS or Linux:

curl -fsSL https://creatorcrawl.com/install.sh | sh

The script installs both the self-contained CLI and the agent-agnostic CreatorCrawl skill. It writes the CLI to ~/.local/bin/creatorcrawl without requiring sudo. Node.js 18 or newer is required. Override CREATORCRAWL_VERSION or CREATORCRAWL_BIN_DIR when needed.

Run instantly without installing:

npx creatorcrawl <command>

Or install globally:

npm install -g creatorcrawl
# or
pnpm add -g creatorcrawl

Authenticate

For interactive use, sign in through CreatorCrawl OAuth:

creatorcrawl auth login

The CLI opens your browser, uses Authorization Code + PKCE, stores OAuth credentials in macOS Keychain when available, and refreshes access automatically. For agents and CI, pass an API key non-interactively during installation:

curl -fsSL https://creatorcrawl.com/install.sh | CREATORCRAWL_API_KEY="sk_live_..." sh

API keys remain supported for automation:

export CREATORCRAWL_API_KEY=sk_live_...
creatorcrawl tiktok profile khaby.lame

Or pass it per command:

creatorcrawl --api-key sk_live_... tiktok profile khaby.lame

Use creatorcrawl auth status --json to check authentication and creatorcrawl auth logout to remove the saved credential.

Commands

creatorcrawl tiktok    profile|videos|video|transcript|search|users|comments
creatorcrawl instagram profile|posts|post|reels|comments|transcript
creatorcrawl youtube   channel|videos|shorts|video|search|transcript|comments|playlist
creatorcrawl linkedin  profile|company|company-posts|post|ads|ad
creatorcrawl twitter   profile|tweet|tweets|transcript|community|community-tweets
creatorcrawl reddit    search|subreddit|subreddit-posts|subreddit-search|comments

Run creatorcrawl <platform> --help for subcommand details.

Output

Default: compact JSON (greppable, pipeable).

All responses use a unified envelope: { data, page?, meta }. data holds the canonical record (Creator, Post, Comment, or a list of these). meta always includes platform and fetched_at.

creatorcrawl tiktok profile khaby.lame | jq '.data.handle, .data.follower_count'

Sample response:

{
  "data": {
    "handle": "khaby.lame",
    "follower_count": 162000000,
    "platform": "tiktok"
  },
  "meta": {
    "platform": "tiktok",
    "fetched_at": "2026-05-15T10:00:00Z"
  }
}

Pretty-print:

creatorcrawl --pretty tiktok profile khaby.lame

Examples

# Profile
creatorcrawl tiktok profile stoolpresidente

# Transcript a video and pipe to a file
creatorcrawl youtube transcript https://youtu.be/dQw4w9WgXcQ > transcript.json

# Search and extract top-5 channels
creatorcrawl youtube search "ai tools" | jq '.data[:5]'

# LinkedIn ad library lookup
creatorcrawl linkedin ads stripe

# Loop over a list of handles
for h in stoolpresidente khaby.lame zachking; do
  creatorcrawl tiktok profile "$h"
done

# Use in CI / scripts
CREATORCRAWL_API_KEY=$NPM_TOKEN \
  creatorcrawl reddit subreddit-posts ProgrammerHumor

Configuration

Flag	Env var	Description
-k, --api-key <key>	CREATORCRAWL_API_KEY	Your CreatorCrawl API key
--pretty	—	Pretty-print JSON output (default: compact)

Companion packages

• TypeScript SDK: @creatorcrawl/sdk — for code workflows
• Hosted MCP endpoint: https://app.creatorcrawl.com/api/mcp — for compatible AI agents
• Agent Skill: creatorcrawl/creatorcrawl-skill — teaches agents how to use CreatorCrawl

Pricing

Pay-as-you-go credits starting at $29 for 5,000 calls. Full pricing at creatorcrawl.com/#pricing.

License

MIT