Get LinkedIn Profile

Retrieve public profile information for a LinkedIn user.

Endpoint

GET /linkedin/profile/:username

Parameters

Path Parameters

Parameter	Type	Required	Description
`username`	string	Yes	The LinkedIn profile slug (the part after `/in/` in the profile URL)

Request

Headers

Header	Required	Description
`Authorization`	Yes	Bearer token with your API key

Example Request

curl -X GET "https://api.your-domain.com/linkedin/profile/satyanadella" \
  -H "Authorization: Bearer YOUR_API_KEY"

const response = await fetch(
  'https://api.your-domain.com/linkedin/profile/satyanadella',
  {
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY'
    }
  }
);

const profile = await response.json();

import requests

response = requests.get(
    'https://api.your-domain.com/linkedin/profile/satyanadella',
    headers={'Authorization': 'Bearer YOUR_API_KEY'}
)

profile = response.json()

Response

Success Response

Status Code: 200 OK

Returns the LinkedIn user profile data in JSON-LD format when available, or extracted profile information.

JSON-LD Response (when available)

{
  "@context": "http://schema.org",
  "@type": "Person",
  "name": "Satya Nadella",
  "jobTitle": "Chairman and CEO at Microsoft",
  "address": {
    "@type": "PostalAddress",
    "addressLocality": "Redmond, Washington"
  },
  "alumniOf": [
    {
      "@type": "EducationalOrganization",
      "name": "University of Wisconsin-Milwaukee"
    }
  ],
  "worksFor": [
    {
      "@type": "Organization",
      "name": "Microsoft"
    }
  ],
  "url": "https://www.linkedin.com/in/satyanadella"
}

Fallback Response

When JSON-LD data is not available, a simplified profile is returned:

{
  "name": "Satya Nadella",
  "headline": "Chairman and CEO at Microsoft",
  "url": "https://www.linkedin.com/in/satyanadella"
}

Response Fields

Field	Type	Description
`@type`	string	Schema.org type (usually "Person")
`name`	string	Full name
`jobTitle`	string	Current job title/headline
`address`	object	Location information
`alumniOf`	array	Educational history
`worksFor`	array	Current employment
`url`	string	LinkedIn profile URL

Error Responses

Status	Description
`400`	Invalid username format
`401`	Invalid or missing API key
`404`	Profile not found
`429`	Rate limit exceeded
`500`	Failed to extract profile data

See Error Handling for detailed error response formats.

Notes

LinkedIn profile slugs are typically lowercase and may contain hyphens. For example, john-doe-123456 or jane-smith.

LinkedIn heavily restricts public access to profiles. Some profiles may return limited data or require authentication. The API extracts publicly visible information only.

The response format may vary depending on how the LinkedIn profile is configured. The API attempts to return JSON-LD structured data when available, falling back to extracted visible information.

Get Profile