---
name: uniqueness
description: Get sourced personal facts from a LinkedIn URL via the Uniqueness Engine CLI.
---

# uniqueness

Install: `npm install -g uniqueness`

A global install updates with `uniqueness update` (it asks first). `npx uniqueness` already resolves latest. Never run `uniqueness account rotate-key` or read a printed key.

Free check (no key, no charge): `uniqueness example --json`

Signup is named-device email verification. A human must approve. Never echo the one-time key or put it in a transcript.

```
uniqueness signup --email you@company.com
export UNIQUENESS_API_KEY=uq_live_...
```

One person: `uniqueness context --linkedin-url https://www.linkedin.com/in/<handle> --json --detail compact`

Rerun after code or extractor changes: `uniqueness context --linkedin-url https://www.linkedin.com/in/<handle> --refresh`. A same-account re-pull without `--refresh` is a cache hit and costs 0. A normal repeat lookup is not a fresh enrichment. Batch does not support `--refresh`.

Still running: `uniqueness job <job_id> --json`. Never resubmit to poll.

Lists: `uniqueness batch preflight --file people.json --json` (starts no work), then `uniqueness batch submit --file people.json --json` (starts paid batch work).

`need_topup` on an estimate is not Checkout. Do not run `billing packs` from preflight. A 402 applies only to `context` or `batch submit`. If credit is insufficient in a non-interactive terminal: print the billing links from that 402 and stop. Never open Checkout. Never buy credits or save a card by inference. Pack and plan terms: `uniqueness --help` or `GET /api/billing/catalog`.
