CLI overview

The @socialrouter/cli package lets you run services, browse the catalogue, and check your account from the terminal. It wraps the SDK and adds formatted output with spinners.

Installation

npm install -g @socialrouter/cli

Or run without installing:

npx @socialrouter/cli run linkedin/profile.info "https://linkedin.com/in/example"

Authentication

Set your API key as an environment variable:

export SOCIALROUTER_API_KEY=sr_live_your_key

Optionally override the base URL (for self-hosted or testing):

export SOCIALROUTER_BASE_URL=https://api.socialrouter.io

Quick example

# Find a service
socialrouter services linkedin

# Run it
socialrouter run linkedin/profile.info "https://linkedin.com/in/satyanadella"

# Check your balance
socialrouter balance

All commands

run

Run a service over one or more inputs.

services & sources

Browse the catalogue: input shapes, options, offers, prices.

get

Retrieve a past run by ID.

balance & usage

Check credits and usage stats.

JSON output

Every command supports -j / --json for raw JSON, useful for piping:

socialrouter run linkedin/profile.info "https://linkedin.com/in/example" -j | jq '.data[0].company'

Migrating from 0.3.x

0.3.x	0.4.0
`extract -u <url> -p apify/linkedin/profile.info`	`run linkedin/profile.info <url>`
`extract -U "u1,u2" -p …`	`run <service> u1 u2` (space-separated)
`search -q "q1,q2" -p apify/googlemaps/place.search`	`run googlemaps/place.search "q1" "q2"`
`-p apify/reddit/group.posts:trudax`	`run reddit/subreddit.posts <url> -p apify/trudax`
`--no-fallback`	pin an offer with `-p`
`providers`	`services` (the catalogue) / `sources` (who’s behind it)

Getting started

Commands

Installation

Authentication

Quick example

All commands

run

services & sources

get

balance & usage

JSON output

Migrating from 0.3.x

​Installation

​Authentication

​Quick example

​All commands

run

services & sources

get

balance & usage

​JSON output

​Migrating from 0.3.x

Installation

Authentication

Quick example

All commands

JSON output

Migrating from 0.3.x