Fetch LinkedIn profile information

Retrieve detailed profile information for a LinkedIn member including name, headline, premium status, and profile URNs. Results are cached for 6 hours to reduce API calls. Optionally include geo location details and contact information (email, phone if visible). Rate limit: 120 unique profiles per day per LinkedIn account (cached requests do not count against limit).

POST/profile

Authentication requiredProfile

Code Examples

curl -X POST 'https://api.connectsafely.ai/linkedin/profile' \
  -H 'Authorization: Bearer <your_api_key>' \
  -H 'Content-Type: application/json' \
  -d '{"profileId":"john-doe-123"}'

Retrieve detailed profile information for a LinkedIn member including name, headline, premium status, and profile URNs. Results are cached for 6 hours to reduce API calls. Optionally include geo location details and contact information (email, phone if visible). Rate limit: 120 unique profiles per day per LinkedIn account (cached requests do not count against limit).

Parameters

No parameters.

Request Body

Field	Type	Required	Description
`accountId`	string	No	LinkedIn account ID to use. If not provided, uses the default account.
`profileId`	string	Yes	LinkedIn profile vanity URL slug (the part after linkedin.com/in/, e.g., "john-doe-123")
`includeGeoLocation`	boolean	No	Include detailed geo location data (city, country, coordinates)
`includeContact`	boolean	No	Include contact info (email, phone) if visible to viewer
`includeExperience`	boolean	No	Include work experience history
`includeEducation`	boolean	No	Include education history
`includeSkills`	boolean	No	Include skills with endorsement counts
`forceRefresh`	boolean	No	Skip cache and fetch fresh data from LinkedIn. Use sparingly as it counts against rate limit.

Example

{
  "profileId": "john-doe-123",
  "includeGeoLocation": false,
  "includeContact": false,
  "includeExperience": false,
  "includeEducation": false,
  "includeSkills": false,
  "forceRefresh": false
}

Responses

Status	Description
200	Profile information retrieved successfully
400	Bad request - Missing or invalid profileId
401	Unauthorized - Invalid or missing API key
429	Rate limit exceeded - Maximum 120 unique profiles per day

Rate Limit Headers

All responses include rate limit information in the headers:

Header	Description
`X-RateLimit-Action`	The action type being rate limited
`X-RateLimit-Limit`	Maximum actions allowed per period
`X-RateLimit-Used`	Actions used in current period
`X-RateLimit-Remaining`	Actions remaining
`X-RateLimit-Reset`	ISO 8601 timestamp when limit resets

200 Response Parameters

Name	Type	Description
`success`	boolean	Whether the request was successful
`profileId`	string	The requested profile vanity URL slug
`accountId`	string	LinkedIn account ID used for the request
`profile`	object	Profile data (empty object if profile not found)
`experience`	array	Positions, in the order the profile lists them. Always returned. Without includeExperience it holds the employers the profile page shows (the first five); with includeExperience=true it is the full history, at the cost of one more LinkedIn request. Several roles at one employer are separate entries sharing companyName and companyId.
`skills`	array	Skills. Always returned; send includeSkills=true for the full list with endorsement counts
`education`	array	Education history. Always returned; send includeEducation=true for the full list
`cached`	boolean	Whether the response was served from the 6-hour cache. Only requests without includeExperience, includeEducation and includeSkills are served from cache; those flags always fetch fresh, and that fetch refreshes the cached profile too.
`cachedAt`	string (date-time)	When the cached profile was fetched (only if cached=true). It can be a request that sent includeExperience; the cached copy holds the profile without that detail.
`expiresAt`	string (date-time)	When the cache expires
`message`	string	Status message

200 Example

{
  "success": true,
  "profileId": "anandi-devi",
  "accountId": "696ce9e780e0483585e4e553",
  "profile": {
    "firstName": "Anandi",
    "lastName": "Devi",
    "headline": "Go-To-Market (GTM) Engineer @ ConnectSafely | MBA",
    "location": {
      "countryCode": "in",
      "postalCode": null,
      "geoLocationName": null
    },
    "entityUrn": "urn:li:fsd_profile:ACoAAFpqSoMB8vTqRbg4mN_wbabO8w0gjgFu-6o",
    "publicIdentifier": "anandi-devi",
    "profilePicture": "https://media.licdn.com/dms/image/v2/D5603AQF2Iu7GGz-H2A/profile-displayphoto-shrink_100_100/...",
    "isPremium": true,
    "isVerified": true,
    "supportsFreeEmail": true,
    "connectionCount": 958,
    "followerCount": 1243,
    "isConnected": true,
    "relationshipStatus": "CONNECTED",
    "connectionDegree": "1st",
    "invitationSent": false,
    "invitationReceived": false,
    "geoLocation": {
      "city": "Delhi",
      "state": null,
      "country": "India",
      "fullLocation": "Delhi, India",
      "birthDate": null
    }
  },
  "message": "Profile information retrieved successfully"
}

400 Response Parameters

Name	Type	Description
`success`	boolean
`error`	object

400 Example

{
  "success": false,
  "error": {
    "issues": [
      {
        "code": "invalid_type",
        "expected": "string",
        "received": "undefined",
        "path": [
          "profileId"
        ],
        "message": "Required"
      }
    ],
    "name": "ZodError"
  }
}

401 Response Parameters

Name	Type	Description
`error`	string

401 Example

{
  "error": "Unauthorized - Invalid credentials"
}

429 Response Parameters

Name	Type	Description
`error`	string
`success`	boolean

429 Example

{
  "error": "Rate limit exceeded for PROFILE: 120/120 used. Resets at 2024-01-16T00:00:00.000Z",
  "success": false
}

Code Examples

On this page