run

socialrouter run <platform>/<service> <input...> [options]

Inputs are URLs for a url-kind service and free-text queries for a query-kind one. socialrouter services <slug> tells you which, and shows the accepted shapes with examples.

Options

Flag	Type	Required	Default	Description
`-p, --provider <offer>`	`string`	No	none	Pin one offer, `source/name` (e.g. `apify/harshmaur`). Omit to let the router walk the failover chain. Pinning disables failover.
`-l, --limit <n>`	`number`	No	100	Maximum records to return (capped at 250).
`-o, --options <json>`	`string`	No	none	Typed options as a JSON object string (e.g. `'{"sort":"top"}'`). Unknown keys are rejected with a corrective error, not dropped.
`-j, --json`	`boolean`	No	false	Output raw JSON.

Examples

A LinkedIn profile

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

A batch

socialrouter run linkedin/profile.info \
  "https://linkedin.com/in/alice" \
  "https://linkedin.com/in/bob" \
  "https://linkedin.com/in/carol"

Inputs are space-separated positional arguments, so quote each one.

With typed options

socialrouter run reddit/subreddit.posts "https://www.reddit.com/r/programming" \
  -o '{"sort":"top","time":"week"}' \
  -l 50

A query-kind service

socialrouter run googlemaps/place.search \
  "coffee shops in Brooklyn" "bakeries in Brooklyn" \
  -l 50

Pin an offer (no failover)

socialrouter run reddit/subreddit.posts "https://www.reddit.com/r/programming" \
  -p apify/trudax

Pipe JSON to jq

socialrouter run linkedin/profile.info "https://linkedin.com/in/example" -j \
  | jq '.data[] | {name, company}'

Save to CSV

socialrouter run linkedin/post.likes "https://linkedin.com/posts/..." -j \
  | jq -r '.data[] | [.name, .title, .company] | @csv' > likes.csv

Output

Run ext_a1b2c3d4
Service: reddit/subreddit.posts | Served by: apify/harshmaur | Credits: $0.138

50 of 50 records returned

Served by: names the offer that answered. When the chain rolled over, it reads apify/trudax (fell over from apify/harshmaur). Only the first 10 records are printed. Use -j for the full payload.

Getting started

Commands

Options

Examples

A LinkedIn profile

A batch

With typed options

A query-kind service

Pin an offer (no failover)

Pipe JSON to jq

Save to CSV

Output

​Options

​Examples

​A LinkedIn profile

​A batch

​With typed options

​A query-kind service

​Pin an offer (no failover)

​Pipe JSON to jq

​Save to CSV

​Output

Options

Examples

A LinkedIn profile

A batch

With typed options

A query-kind service

Pin an offer (no failover)

Pipe JSON to jq

Save to CSV

Output