scrapesocial-cli

Non-interactive CLI for the published scrapecreators.com endpoints.

Install

# Global install (recommended)
npm install -g scrapesocial-cli
scrapesocial --help

# Or run directly with npx (no install needed)
npx scrapesocial-cli --help

Auth

• Default: reads SCRAPECREATORS_API_KEY
• Override: --api-key <key>
• Skip requirement: SKIP_AUTH=1 or --skip-auth
• Credit guardrail: CREDIT_LIMIT=<credits> or --credit-limit <credits>
• Custom headers: --header "x-api-key: <key>"

Usage

# Basic help
scrapesocial --help

# Full help
scrapesocial --help-full

# Hide requests above 1 credit and block them at runtime
CREDIT_LIMIT=1 scrapesocial --help

# TikTok audience
SCRAPECREATORS_API_KEY=... scrapesocial tiktok users audience --user-handle shakira

# Pinterest search as JSONL
SCRAPECREATORS_API_KEY=... scrapesocial pinterest search --query "Italian Pot Roast" --format jsonl

# YouTube channel videos
SCRAPECREATORS_API_KEY=... scrapesocial youtube channels videos --handle MrBeast

With npx, replace scrapesocial with npx scrapesocial-cli:

npx scrapesocial-cli tiktok users audience --user-handle shakira