LinkedIn

Get a LinkedIn profile

GET

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

Path parameters

identity

required

string

Public identifier, provider id, or profile URL

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

A first-degree connection, so a plain message will be delivered.

remainingToday

integer

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