Skip to main content
Pass LinkedIn usernames — the part after /in/ in a profile URL, not the URL itself — and get back ranked contact info per username. Full profile URLs are normalized server-side, so passing them works too.

​
Parameters

​
list[str]
required
LinkedIn usernames (1–500 per call). The API itself accepts up to 1000 per request; the SDK caps a single call at 500 — use batching for larger lists.
​
str
default:"\"v2\""
API version. "v1" is also accepted, but returns a different shape — see Migrating from v1.
​
bool
default:"False"
v2 only — return presence flags instead of the contact values themselves. Useful for quickly checking how much you’d get from a full lookup before spending the credit.
​
bool
default:"False"
Validate input locally without sending.

​
Response shape

Ranks are strings and confidence scores are integers on a 0–100 scale. When nothing is found for a username, is_match is False and all three contact lists are None. The response is the raw API JSON (a dict) rather than a typed pydantic model — the shape is forward-compatible, so new fields the server adds don’t break older clients.

​
presence_only (v2)

When True, each result carries booleans rather than values:

​
Validation

dry_run=True returns the validated LiContactInfoRequest without sending; an empty records list (or > 500 entries) raises MinervaValidationError locally. See Validation.