LinkedIn

Get a LinkedIn profile

Returns a profile by public identifier or user id. Counts against the daily profile view allowance reported in remainingToday.

GET

/api/v1/linkedin/profiles/{identity}

Path parameters

identity

required

string

User id (ACoAAA…) or public identifier.

Query parameters

connectedAccountId

required

string · uuid

Connected account to act as

Response

200LinkedIn profile.

profile

object

publicIdentifier

string | null

profileUrl

string | null

firstName

string | null

lastName

string | null

fullName

string | null

headline

string | null

summary

string | null

location

string | null

companyName

string | null

jobTitle

string | null

imageUrl

string | null

imageUrlLarge

string | null

backgroundImageUrl

string | null

followerCount

number | null

degree

"self" | "first" | "second" | "third_plus" | "out_of_network" | "unknown"

invitationPending

boolean

An invitation from this account is awaiting an answer.

isConnected

boolean

True for a first-degree connection, who can receive a message.

remainingToday

integer

Remaining daily allowance for this action on the connected account. Each action type has its own limit.

requestId

string · uuid

Id of this request, for support and troubleshooting

Errors

  • 400: Bad request
  • 401: Unauthorized: missing or invalid API key
  • 403: Forbidden
  • 404: Not found
  • 422: Invalid request payload

Search docs

Search documentation, API reference, and MCP tools

We use cookies to enhance your experience on Needle and keep your data secure. Privacy Policy