Skip to content

Command reference

linkedin

A read-only, agent-friendly CLI for LinkedIn job search (unofficial Voyager API)

Synopsis

linkedin is a READ-ONLY client for LinkedIn's internal Voyager API: search jobs, fetch a job's detail, look up a company, and resolve a location to a geoId — with machine-first output (JSON/YAML/CSV, -o id, --jq) for pipelines and AI agents.

⚠ UNOFFICIAL API — USE-AT-YOUR-OWN-RISK. This drives the same private endpoints linkedin.com's web app calls, using YOUR browser session cookies. It is not sanctioned by LinkedIn and may violate the LinkedIn User Agreement. Ban-safety defaults are ON (human-paced delays, a daily fetch cap, no retry on throttles) — keep volume low, use your own account on your own machine.

Authenticate by borrowing your browser session: linkedin auth --cookie-from-browser chrome linkedin jobs search --keywords "golang" --remote --since 7d -o json linkedin jobs get 4012345678 -o json linkedin company get stripe linkedin geo "Bogota, Colombia"

Options

      --all                   page through all results (search commands)
      --base-url string       override the Voyager API host (default https://www.linkedin.com/voyager/api)
      --columns strings       comma-separated columns to show
      --count int             results per page (search commands) (default 25)
      --daily-cap int         override the ban-safety daily job-detail fetch cap (0 keeps the default of 30)
      --dry-run               print the equivalent curl and make no request
  -h, --help                  help for linkedin
      --jq string             gojq expression applied to the response before rendering
      --limit int             max items to return across pages (search commands)
      --no-color              disable colored output
  -o, --output string         output format: table|json|yaml|csv|id
      --profile string        named profile to use
      --quiet                 suppress non-essential chatter
      --show-token            reveal the session cookies in dry-run output
  -v, --verbose               verbose request logging (stderr)
      --web-base-url string   override the web host used for geo typeahead (default https://www.linkedin.com)

SEE ALSO