A command line for public LinkedIn data. linkedin reads member profiles, company pages, job postings, and the guest job search and returns rich, structured records. One pure-Go binary, no API key, no login.

Install • Commands • Usage • What works anonymously

It reads the same pages a logged-out browser sees: the JSON-LD LinkedIn marks up for machines, then precise HTML selectors for anything the structured data misses. Responses are cached on disk so a repeat call is instant. When a page is behind the sign-in wall, linkedin exits with a distinct code and you can lend a signed-in session with --cookies.

linkedin is an independent tool. It is not affiliated with, endorsed by, or sponsored by LinkedIn or Microsoft.

go install github.com/tamnd/linkedin-cli/cmd/linkedin@latest

Or grab a prebuilt binary, a Linux package (deb/rpm/apk), or a container image from the releases:

brew install tamnd/tap/linkedin
docker run --rm ghcr.io/tamnd/linkedin:latest jobs "golang" -n 5

Shell completion is built in: linkedin completion bash|zsh|fish|powershell.

Full reference and guides live at linkedin-cli.tamnd.com.

linkedin profile williamhgates                    # a member profile
linkedin profile williamhgates --posts            # the member's recent public posts
linkedin company microsoft                        # a company page
linkedin company microsoft --locations            # the company's offices
linkedin jobs "golang backend" --location Remote  # job stubs from the guest search
linkedin job 4391940951                           # a full job posting

Records come out as a table (the default on a terminal), list, markdown, JSON, JSONL, CSV, TSV, url, or raw. The output is colored on a terminal:

linkedin jobs "golang" --fields job_id,title,company,location,posted -o table
linkedin profile williamhgates -o json
linkedin jobs "data engineer" -n 50 -o jsonl | jq 'select(.location | contains("Remote"))'
linkedin jobs "golang" -o url
linkedin company microsoft -o markdown

Fetch full job records by hydrating each stub from the guest search:

linkedin jobs "golang backend" --hydrate -n 20 -o jsonl > jobs.jsonl

-o, --output      auto|list|table|markdown|json|jsonl|csv|tsv|url|raw   (auto: table on a TTY, jsonl when piped)
    --fields      comma-separated columns to include
    --no-header   omit the header row
    --template    Go text/template applied per record
-n, --limit       max records (0 = no limit)
    --cookies     Netscape cookie jar to lend a signed-in session
-q, --quiet       suppress progress output
    --color       auto|always|never
    --rate        min spacing between requests
    --timeout     per-request timeout
    --retries     retry attempts on rate limit or 5xx
    --no-cache    bypass the on-disk cache
    --refresh     force re-fetch and overwrite the cache
    --cache-ttl   cache freshness window (default 24h)
    --data-dir    override the data directory
    --db          tee every record into a store (sqlite path or postgres:// URL)
    --dry-run     print actions, do not perform them

LinkedIn serves some surfaces to anonymous visitors and gates the rest behind a sign-in wall. linkedin reads what is public and exits with code 4 when a page is walled. Pass --cookies (a Netscape cookies.txt jar from your browser) to lend a signed-in session.

Records can be upserted into a local SQLite store with --save, keyed by kind and id, so you can build a dataset across many calls and query it back:

linkedin jobs "data engineer" --hydrate -n 50 --save   # fetch and store
linkedin company microsoft --save                       # store a company
linkedin db count                                       # records by kind
linkedin db query --kind job -n 10                      # read them back

Pass --db path/to/file.db to tee records into any SQLite file while they stream, without --save.

0  success
1  error
2  usage error
3  no results
4  auth required (page is behind the sign-in wall; pass --cookies)
5  rate limited (HTTP 429 after retries)
6  not found

cmd/linkedin/   thin main entry point
cli/            cobra commands and output rendering
linkedin/       HTTP client, parsers, and models
docs/           documentation site (Hugo, tago-doks theme)

make build   # ./bin/linkedin
make test    # go test ./...
make vet     # go vet ./...
make fmt     # gofmt -s -w .

Requires Go 1.23+.

Push a version tag and GitHub Actions runs GoReleaser:

git tag -a v0.2.0 -m "v0.2.0"
git push --tags

The image tag carries no v prefix (ghcr.io/tamnd/linkedin:0.2.0).

Apache-2.0. See LICENSE.