Skip to main content
Pass strings containing LinkedIn usernames or full profile URLs. A username is the part after /in/ in a profile URL. Full URLs are normalized server-side. The response contains ranked contact info per username.

​
Parameters

​
list[str]
required
LinkedIn username or profile URL strings (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, more than 500 entries, or a non-string entry raises MinervaValidationError locally. Pass each username or URL as a string. See Validation.