Developers
Open Swarmhit
Smart APIRaw API
API referenceLinkedin users and invitations
GET
/api/v1/users/{identifier}

identifier is a public identifier (jane-doe) or a provider id (ACoA…). notify=true makes the read a visit the member sees (counted in the visit cap, once a day per profile). open_profile=1 also reads whether the member takes free InMails (is_open_profile): the member's own setting, also for a connection, when the account has a Sales Navigator seat; without one, known only for a member you are not connected to (LinkedIn shows a connection's setting nowhere else), else null.

Authorization

X-API-KEY<token>

Your API key from the console (gw_live_…).

In: header

Path Parameters

identifier*string

The member: a public identifier (jane-doe, as in their profile URL) or a provider id (ACoA…).

Query Parameters

account_id*string

The LinkedIn account (lg_…) to act as.

Length1 <= length
notify?string

true or 1 makes the read a profile visit the member sees, counted in the visit daily cap. Default false: a plain read, no visit.

Value in

  • "true"
  • "false"
  • "1"
  • "0"
open_profile?string

true or 1 also reads is_open_profile (whether the member takes free InMails), one more LinkedIn read. Default false: is_open_profile is null.

Value in

  • "true"
  • "false"
  • "1"
  • "0"

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/api/v1/users/jane-doe?account_id=lg_3f9c2a7b1d"
{  "object": "UserProfile",  "provider": "LINKEDIN",  "provider_id": "ACoAAB1a2b3c4d5e6f",  "public_identifier": "jane-doe",  "first_name": "Jane",  "last_name": "Doe",  "full_name": "Jane Doe",  "headline": "Head of Sales at Example Corp",  "location": "Paris, France",  "profile_picture_url": null,  "network_distance": "SECOND_DEGREE",  "is_open_profile": null,  "follower_count": null,  "connections_count": null,  "public_profile_url": "https://www.linkedin.com/in/jane-doe"}

The signed-in member GET

The account's own profile and plans. Cached for an hour; a plan bought or ended shows within it (and as a `gateway.plan_changed` event).

Followers GET

The account's own followers, as LinkedIn lists them (newest first), a page of `limit` (at most 100), read from LinkedIn 10 at a time with a short pause between, so a full page takes several seconds. Pass `cursor` back for the next page; `null` on the last. A company that follows the member is left out. `user_id` may only name the account itself (422 otherwise): LinkedIn shows no one else's followers; another member's are a people search with the `followerOf` filter.