API Reference / Look up a LinkedIn person
Look up a LinkedIn person
One person's LinkedIn relationship with each connected account, read live from LinkedIn: connected or not, any pending invite and when it was sent, and the conversation.
Last updated
curl -G -H "Authorization: Bearer $REVNU_API_TOKEN" https://revnu.com/api/v1/linkedin/person \
--data-urlencode "profile=https://www.linkedin.com/in/tom-park/"Query
| Param | Meaning |
|---|---|
profile |
Required. A linkedin.com/in/ URL, a public id such as tom-park, or a member id (ACoAA…). |
account |
The name of one connected LinkedIn account in your workspace. Without it, every connected account is checked. |
Response
{ "person": { providerId, publicIdentifier, name, headline } | null, "accounts": [account, …] }, one entry per connected LinkedIn account.
An account read in full is { account, connectedAs, state: "ok", connected, invite, revnuInvite, messages, messagesTruncated, lastReplyAt }:
connectedistruewhen this account and the person are first-degree connections.inviteis the request LinkedIn reports between them, ornull:{ direction: "sent" | "received" | null, status: "pending" | "ignored" | "withdrawn", at }, whereatis when it was sent (epoch milliseconds) if LinkedIn says.revnuInviteis Revnu's own record when Revnu sent the invite from this account:{ sentAt, acceptedAt, withdrawnAt }.acceptedAtis when Revnu first saw the person connected, not LinkedIn's exact time.messagesare the newest 50 in the conversation, oldest first:{ at, from: "you" | "them", sentBy, kind, text }.sentByis"agent"when Revnu sent it,"person"when someone replied from Revnu's inbox, andnullwhen it was typed in LinkedIn.messagesTruncatedsays older messages exist.lastReplyAtis the time of their newest message, ornull.
An account that could not be read has a state instead: not_connected, needs_reauth (reconnect it in the dashboard), paced with message and retryAt (the account's daily profile-lookup budget is spent), or error with message, including when no profile matches.
| Code | Meaning |
|---|---|
| 400 | profile is missing or is not a LinkedIn profile URL or id. |
| 404 | No connected LinkedIn account has the name in account. |
Agents: this page is also markdown at /docs/linkedin-person.md, answers Accept: text/markdown, and is listed in /docs/llms.txt.
Frequently Asked Questions
No. It only reads. Nothing on this route invites, messages or withdraws.