Get Profile

Get profile information

curl --request GET \
  --url https://api.fetchin.io/api/v1/profile \
  --header 'X-API-Key: <api-key>'

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.fetchin.io/api/v1/profile', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.fetchin.io/api/v1/profile",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.fetchin.io/api/v1/profile"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.fetchin.io/api/v1/profile")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "id": "urn:li:fsd_profile:ACoAAA8BYqEBCGLg_vT_ca6mMEqkpp9nVffJ3hc",
  "firstName": "Bill",
  "lastName": "Gates",
  "title": "Chair, Gates Foundation and Founder, Breakthrough Energy",
  "description": "Chair of the Gates Foundation. Founder of Breakthrough Energy. Co-founder of Microsoft. Voracious reader. Avid traveler. Active blogger.",
  "location": "Seattle, Washington, United States",
  "profilePictureUrl": "https://media.licdn.com/dms/image/...",
  "coverImageUrl": "https://media.licdn.com/dms/image/...",
  "publicIdentifier": "williamhgates",
  "profileId": "ACoAAA8BYqEBCGLg_vT_ca6mMEqkpp9nVffJ3hc",
  "countryCode": "US",
  "geoLocationName": "Seattle, Washington, United States",
  "geoCountryName": "United States",
  "geoUrn": "urn:li:fsd_geo:104116203",
  "connectionType": "OUT_OF_NETWORK",
  "creatorInfo": {
    "hashTags": ["#books", "#climatechange", "#healthcare", "#innovation", "#sustainability"],
    "website": "https://gatesnot.es/tgn"
  },
  "jobTitle": "Co-chair",
  "companyName": "Gates Foundation",
  "companyPublicId": "gates-foundation",
  "companyLinkedinUrl": "https://www.linkedin.com/company/gates-foundation/",
  "currentPosition": {
    "positionUrn": "urn:li:fsd_profilePosition:(ACoAAA8BYqEBCGLg_vT_ca6mMEqkpp9nVffJ3hc,392598211)",
    "title": "Co-chair",
    "name": "Gates Foundation",
    "companyId": "8736",
    "companyUrn": "urn:li:fsd_company:8736",
    "publicIdentifier": "gates-foundation",
    "url": "https://www.linkedin.com/company/gates-foundation/"
  },
  "currentSchool": null,
  "followerCount": 40076104,
  "connectionsCount": 8,
  "creator": true,
  "influencer": true,
  "premium": true,
  "isVerified": false,
  "memberId": "251749025",
  "openToWork": false,
  "inRemembrance": false,
  "openProfile": false,
  "joinDate": { "month": 5, "year": 2013 },
  "url": "https://www.linkedin.com/in/williamhgates/",
  "pronoun": "he/him",
  "experiences": [
    {
      "name": "Gates Foundation",
      "jobTitle": "Co-chair",
      "description": "",
      "dateRange": "2000 - Present",
      "current": true,
      "positionUrn": "urn:li:fsd_profilePosition:(ACoAAA8BYqEBCGLg_vT_ca6mMEqkpp9nVffJ3hc,392598211)",
      "timePeriod": {
        "startDate": { "year": 2000 },
        "endDate": null
      },
      "company": {
        "url": "https://www.linkedin.com/company/gates-foundation/",
        "name": "Gates Foundation",
        "logo": "https://media.licdn.com/dms/image/...",
        "companyId": "8736",
        "urn": "urn:li:fsd_company:8736"
      }
    },
    {
      "name": "Microsoft",
      "jobTitle": "Co-founder",
      "description": "",
      "dateRange": "1975 - Present",
      "current": false,
      "positionUrn": "urn:li:fsd_profilePosition:(ACoAAA8BYqEBCGLg_vT_ca6mMEqkpp9nVffJ3hc,392599749)",
      "timePeriod": {
        "startDate": { "year": 1975 },
        "endDate": null
      },
      "company": {
        "url": "https://www.linkedin.com/company/microsoft/",
        "name": "Microsoft",
        "logo": "https://media.licdn.com/dms/image/...",
        "companyId": "1035",
        "urn": "urn:li:fsd_company:1035"
      }
    }
  ],
  "educations": [
    {
      "name": "Harvard University",
      "description": "",
      "dateRange": "1973 - 1975",
      "current": false,
      "educationUrn": "urn:li:fsd_profileEducation:(ACoAAA8BYqEBCGLg_vT_ca6mMEqkpp9nVffJ3hc,157656829)",
      "grade": "3.9/4.0",
      "details": "Studied mathematics and computer science before leaving to co-found Microsoft.",
      "schoolLogo": "https://media.licdn.com/dms/image/...",
      "schoolUrl": "https://www.linkedin.com/school/harvard-university/",
      "timePeriod": {
        "startDate": { "year": 1973 },
        "endDate": { "year": 1975 }
      }
    }
  ],
  "skills": [],
  "languages": [],
  "certifications": [],
  "recommendations": [
    {
      "caption": "Chairman and CEO at Microsoft",
      "description": "Bill's clarity of thought and depth of curiosity are unmatched. Every conversation with him leaves you thinking bigger.",
      "authorFullname": "Satya Nadella",
      "authorUrl": "https://www.linkedin.com/in/satyanadella/"
    }
  ],
  "testScores": [
    {
      "name": "TOEIC",
      "score": "990",
      "date": "Jun 2018"
    }
  ],
  "volunteerCauses": ["EDUCATION", "SCIENCE_AND_TECHNOLOGY"]
}

{
  "error": "Missing profileUrlOrUrn parameter",
  "code": "MISSING_PARAMETER"
}

{
  "error": "Invalid API key",
  "code": "INVALID_API_KEY"
}

{
  "error": "LinkedIn profile not found",
  "code": "PROFILE_NOT_FOUND"
}

{
  "error": "Quota exceeded. Upgrade your plan or wait for renewal.",
  "code": "QUOTA_EXHAUSTED"
}

{
  "error": "Internal server error",
  "code": "INTERNAL_ERROR"
}

{
  "error": "Service temporarily unable to serve this request. Please retry.",
  "code": "SERVICE_UNAVAILABLE"
}

GET

api

profile

Get profile information

curl --request GET \
  --url https://api.fetchin.io/api/v1/profile \
  --header 'X-API-Key: <api-key>'

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.fetchin.io/api/v1/profile', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.fetchin.io/api/v1/profile",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.fetchin.io/api/v1/profile"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.fetchin.io/api/v1/profile")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "id": "urn:li:fsd_profile:ACoAAA8BYqEBCGLg_vT_ca6mMEqkpp9nVffJ3hc",
  "firstName": "Bill",
  "lastName": "Gates",
  "title": "Chair, Gates Foundation and Founder, Breakthrough Energy",
  "description": "Chair of the Gates Foundation. Founder of Breakthrough Energy. Co-founder of Microsoft. Voracious reader. Avid traveler. Active blogger.",
  "location": "Seattle, Washington, United States",
  "profilePictureUrl": "https://media.licdn.com/dms/image/...",
  "coverImageUrl": "https://media.licdn.com/dms/image/...",
  "publicIdentifier": "williamhgates",
  "profileId": "ACoAAA8BYqEBCGLg_vT_ca6mMEqkpp9nVffJ3hc",
  "countryCode": "US",
  "geoLocationName": "Seattle, Washington, United States",
  "geoCountryName": "United States",
  "geoUrn": "urn:li:fsd_geo:104116203",
  "connectionType": "OUT_OF_NETWORK",
  "creatorInfo": {
    "hashTags": ["#books", "#climatechange", "#healthcare", "#innovation", "#sustainability"],
    "website": "https://gatesnot.es/tgn"
  },
  "jobTitle": "Co-chair",
  "companyName": "Gates Foundation",
  "companyPublicId": "gates-foundation",
  "companyLinkedinUrl": "https://www.linkedin.com/company/gates-foundation/",
  "currentPosition": {
    "positionUrn": "urn:li:fsd_profilePosition:(ACoAAA8BYqEBCGLg_vT_ca6mMEqkpp9nVffJ3hc,392598211)",
    "title": "Co-chair",
    "name": "Gates Foundation",
    "companyId": "8736",
    "companyUrn": "urn:li:fsd_company:8736",
    "publicIdentifier": "gates-foundation",
    "url": "https://www.linkedin.com/company/gates-foundation/"
  },
  "currentSchool": null,
  "followerCount": 40076104,
  "connectionsCount": 8,
  "creator": true,
  "influencer": true,
  "premium": true,
  "isVerified": false,
  "memberId": "251749025",
  "openToWork": false,
  "inRemembrance": false,
  "openProfile": false,
  "joinDate": { "month": 5, "year": 2013 },
  "url": "https://www.linkedin.com/in/williamhgates/",
  "pronoun": "he/him",
  "experiences": [
    {
      "name": "Gates Foundation",
      "jobTitle": "Co-chair",
      "description": "",
      "dateRange": "2000 - Present",
      "current": true,
      "positionUrn": "urn:li:fsd_profilePosition:(ACoAAA8BYqEBCGLg_vT_ca6mMEqkpp9nVffJ3hc,392598211)",
      "timePeriod": {
        "startDate": { "year": 2000 },
        "endDate": null
      },
      "company": {
        "url": "https://www.linkedin.com/company/gates-foundation/",
        "name": "Gates Foundation",
        "logo": "https://media.licdn.com/dms/image/...",
        "companyId": "8736",
        "urn": "urn:li:fsd_company:8736"
      }
    },
    {
      "name": "Microsoft",
      "jobTitle": "Co-founder",
      "description": "",
      "dateRange": "1975 - Present",
      "current": false,
      "positionUrn": "urn:li:fsd_profilePosition:(ACoAAA8BYqEBCGLg_vT_ca6mMEqkpp9nVffJ3hc,392599749)",
      "timePeriod": {
        "startDate": { "year": 1975 },
        "endDate": null
      },
      "company": {
        "url": "https://www.linkedin.com/company/microsoft/",
        "name": "Microsoft",
        "logo": "https://media.licdn.com/dms/image/...",
        "companyId": "1035",
        "urn": "urn:li:fsd_company:1035"
      }
    }
  ],
  "educations": [
    {
      "name": "Harvard University",
      "description": "",
      "dateRange": "1973 - 1975",
      "current": false,
      "educationUrn": "urn:li:fsd_profileEducation:(ACoAAA8BYqEBCGLg_vT_ca6mMEqkpp9nVffJ3hc,157656829)",
      "grade": "3.9/4.0",
      "details": "Studied mathematics and computer science before leaving to co-found Microsoft.",
      "schoolLogo": "https://media.licdn.com/dms/image/...",
      "schoolUrl": "https://www.linkedin.com/school/harvard-university/",
      "timePeriod": {
        "startDate": { "year": 1973 },
        "endDate": { "year": 1975 }
      }
    }
  ],
  "skills": [],
  "languages": [],
  "certifications": [],
  "recommendations": [
    {
      "caption": "Chairman and CEO at Microsoft",
      "description": "Bill's clarity of thought and depth of curiosity are unmatched. Every conversation with him leaves you thinking bigger.",
      "authorFullname": "Satya Nadella",
      "authorUrl": "https://www.linkedin.com/in/satyanadella/"
    }
  ],
  "testScores": [
    {
      "name": "TOEIC",
      "score": "990",
      "date": "Jun 2018"
    }
  ],
  "volunteerCauses": ["EDUCATION", "SCIENCE_AND_TECHNOLOGY"]
}

{
  "error": "Missing profileUrlOrUrn parameter",
  "code": "MISSING_PARAMETER"
}

{
  "error": "Invalid API key",
  "code": "INVALID_API_KEY"
}

{
  "error": "LinkedIn profile not found",
  "code": "PROFILE_NOT_FOUND"
}

{
  "error": "Quota exceeded. Upgrade your plan or wait for renewal.",
  "code": "QUOTA_EXHAUSTED"
}

{
  "error": "Internal server error",
  "code": "INTERNAL_ERROR"
}

{
  "error": "Service temporarily unable to serve this request. Please retry.",
  "code": "SERVICE_UNAVAILABLE"
}

Endpoint

GET /api/v1/profile

Authentication

Include your API key in the request header:

X-API-Key: your-api-key-here

Parameters

string

required

The professional profile to fetch. Accepts any of:

Profile URN, recommended for consistency: a profile’s public identifier (slug) can change over time, the URN does not. Example: urn:li:fsd_profile:ACoAAA8BYqEBCGLg_vT_ca6mMEqkpp9nVffJ3hc
Public identifier (slug), also fine. Example: williamhgates
Profile URL. Example: https://www.linkedin.com/in/williamhgates (a trailing slash makes no difference)

The slug is the last path segment of a profile URL (linkedin.com/in/<slug>). Pass just the slug, not the /in/ prefix.

Response

object

Professional profile information

Show Profile object

string

Professional profile URN (unique identifier)

string

Profile first name

string

Profile last name

string

Professional headline

string

About/summary section

string

Geographic location

string

Profile picture URL

string

Profile banner/background image URL (optional, not all profiles have one)

string

Public identifier (slug), e.g. “williamhgates”

string

Member identifier, e.g. “ACoAAA8BYqEBCGLg_vT…”

string

ISO country code, e.g. “US”, “FR”

string

Full geographic location string, e.g. “Paris, Île-de-France, France”

string

Country name, e.g. “United States”, “France”

string

Geo URN, e.g. “urn:li:fsd_geo:104116203”

string

Relationship to the authenticated account, e.g. “OUT_OF_NETWORK”, “CONNECTED”

string

Current job title, e.g. “Co-chair”, “CEO”

string

Current company name, e.g. “Gates Foundation”

string

Current company public identifier slug, e.g. “gates-foundation”

string

Current company profile URL

object | null

The explicit “current company” block from the top of the profile page. Always present: an object when the member displays their current company at the top of their profile, null when they don’t. Note that null only means the block is not displayed — the profile may still have an ongoing primary position (see experiences[].current).

Show CurrentPosition object

string

URN of the designated position, e.g. urn:li:fsd_profilePosition:(ACoAA…,2839633222). Matches experiences[].positionUrn, so you can join back to the full experience entry.

string

Role title of the designated position, e.g. “CTO”. Omitted when the position cannot be matched in experiences.

string

Company name, e.g. “Reverse Contact”

string

Numeric company id, e.g. “89181966”. Usable with the company endpoints.

string

Full company URN, e.g. “urn:li:fsd_company:89181966”

string

Company page slug, e.g. “reverse-contact”

string

Company page URL

object | null

The explicit “education” block from the top of the profile page. Always present: an object when the member displays their school at the top of their profile, null when they don’t.

Show CurrentSchool object

string

URN of the designated education entry, e.g. urn:li:fsd_profileEducation:(ACoAA…,363452424). Matches educations[].educationUrn.

string

School name

string

Legacy school id from urn:li:fsd_school:<id>, e.g. “42867”. Distinct from companyId.

string

Full school URN, e.g. “urn:li:fsd_school:42867”

string

Numeric organization id of the school’s page, e.g. “15142508”. Usable with the company endpoints.

string

School page slug, e.g. “esilvparis”

string

School page URL

number

Number of followers

number

Number of connections

boolean

Whether the profile has Creator mode enabled

boolean

Whether the profile is an influencer

boolean

Whether the profile has a Premium subscription

boolean

Whether the profile has a verification badge

string

Numeric internal member id, e.g. “251749025”. Distinct from id/profileId, which carry the urn:li:fsd_profile:… form.

boolean

Whether the profile shows the public #OPEN_TO_WORK photo frame. Always present (true/false). Reflects the publicly visible badge only; “open to work” set visible to recruiters only reads as false.

boolean

Whether the account is memorialized / “In Remembrance” (deceased member). Always present (true/false).

boolean

Whether the member runs an open profile: anyone can message them directly without being one of their connections, and without spending a paid message credit. Useful to tell which prospects you can reach cold.Unrelated to openToWork — a member can be open to work without an open profile, and vice versa — and not the same thing as premium: some members without a premium subscription are reachable this way too. Present (true/false) on person profiles; in the rare case the signal is unavailable the field is omitted rather than reported as false.

object

Approximate account creation date (month + year)

Show JoinDate object

number

Month (1-12), e.g. 1 for January

number

Year, e.g. 2014

string

Canonical public URL of the professional profile page, e.g. https://www.linkedin.com/in/williamhgates/

string

Publicly displayed pronouns (e.g. “she/her”). Omitted when the member doesn’t display pronouns.

object

Creator mode information (only present if profile has creator mode)

Show CreatorInfo object

array

Creator hashtags, e.g. [“#books”, “#climatechange”]

string

Creator website URL (null if not set)

array

Complete work experience history, ordered most recent first. Every position is returned in a single call — there is no pagination to follow and no cap, including for members with dozens of past employers.

Show Experience object

string

Company name

string

Job title/role

string

Role description

string

Date range (e.g., “Sep 2016 - Sep 2019”)

boolean

Whether this is the person’s current role. At most one experience is true (the primary ongoing position); false for all others.

string

URN of this position entity, e.g. urn:li:fsd_profilePosition:(ACoAA…,2839633222). Join key for the top-level currentPosition.positionUrn.

string

Job location (e.g., “Paris, Île-de-France, France”)

string

Employment type (e.g., “Freelance”, “Part-time”)

object

Structured time period with startDate and endDate

string

How long the role lasted, formatted as the profile displays it (e.g. "3 yrs 1 mo", "5 mos"). Both endpoints are counted, and an ongoing role runs to today. Omitted when the entry has no start date.

object

Company details

Show Company object

string

Company name

string

Company profile URL

string

Company logo image URL

string

Numeric company id, e.g. “8736”

string

Full company URN, e.g. “urn:li:fsd_company:8736”

array

Education history

Show Education object

string

School/University name

string

Degree type and field of study combined

string

Date range (e.g., “2016 - 2019”)

boolean

Whether this is the person’s current (ongoing) education. At most one education is true.

string

URN of this education entity, e.g. urn:li:fsd_profileEducation:(ACoAA…,363452424). Join key for the top-level currentSchool.educationUrn.

string

Degree name (e.g., “MBA”, “MSEE”, “B. Tech”)

string

Field of study (e.g., “Materials Science and Engineering”)

string

Grade or honors, as free text (e.g., “First Class Honours”)

string

The member’s own free-text description of this education entry. Distinct from description, which stays the synthesized degree + field string.

string

School logo image URL

string

School profile URL

object

Structured time period with startDate and endDate

array

Causes the member lists as ones they care about, as stable identifiers (string array, e.g. ["EDUCATION", "SCIENCE_AND_TECHNOLOGY"]). Empty when the member lists none.

array

Professional skills listed on the profile. Complete list, returned in the same single call as the rest of the profile.

Show Skill object

string

Skill name, e.g. “JavaScript”, “Leadership”

array

Languages listed on the profile

Show Language object

string

Language name, e.g. “English”, “French”

string

Proficiency level (may be empty)

array

Licenses and certifications

Show Certification object

string

Certification name

string

Issuing organization’s name

string

Issuing organization’s professional page URL, when available

string

When the certification was issued (e.g. Jun 2018)

string

deprecated

Legacy alias of organizationName, kept for backward compatibility

string

deprecated

Legacy alias of issuedDate, kept for backward compatibility

array

Recommendations received by the member. Best-effort: omitted when this section could not be fetched, empty array when the member has none.

Show Recommendation object

string

The recommendation text

string

The recommender’s headline at the time of the fetch (the context line shown under the author’s name)

string

The recommender’s full name

string

The recommender’s public profile page URL

array

Test scores listed on the profile

Show TestScore object

string

Test name, e.g. “TOEIC”

string

Score, as free text, e.g. “990”

string

When the test was taken (e.g. Jun 2018)

Example Request

curl -X GET "https://api.fetchin.io/api/v1/profile?profileUrlOrUrn=https://www.linkedin.com/in/williamhgates" \
  -H "X-API-Key: your-api-key-here"

const response = await fetch(
  'https://api.fetchin.io/api/v1/profile?profileUrlOrUrn=https://www.linkedin.com/in/williamhgates',
  {
    headers: {
      'X-API-Key': 'your-api-key-here'
    }
  }
);

const profile = await response.json();
console.log(profile);

import requests

headers = {
    'X-API-Key': 'your-api-key-here'
}

params = {
    'profileUrlOrUrn': 'https://www.linkedin.com/in/williamhgates'
}

response = requests.get(
    'https://api.fetchin.io/api/v1/profile',
    headers=headers,
    params=params
)

profile = response.json()
print(profile)

<?php

$apiKey = 'your-api-key-here';
$profileUrl = 'https://www.linkedin.com/in/williamhgates';

$url = "https://api.fetchin.io/api/v1/profile?profileUrlOrUrn=" . urlencode($profileUrl);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'X-API-Key: ' . $apiKey
]);

$response = curl_exec($ch);
$profile = json_decode($response, true);

curl_close($ch);
print_r($profile);
?>

Example Response

{
  "id": "urn:li:fsd_profile:ACoAAA8BYqEBCGLg_vT_ca6mMEqkpp9nVffJ3hc",
  "firstName": "Bill",
  "lastName": "Gates",
  "title": "Chair, Gates Foundation and Founder, Breakthrough Energy",
  "description": "Chair of the Gates Foundation. Founder of Breakthrough Energy. Co-founder of Microsoft. Voracious reader. Avid traveler. Active blogger.",
  "location": "Seattle, Washington, United States",
  "profilePictureUrl": "https://media.licdn.com/dms/image/...",
  "coverImageUrl": "https://media.licdn.com/dms/image/...",
  "publicIdentifier": "williamhgates",
  "profileId": "ACoAAA8BYqEBCGLg_vT_ca6mMEqkpp9nVffJ3hc",
  "countryCode": "US",
  "geoLocationName": "Seattle, Washington, United States",
  "geoCountryName": "United States",
  "geoUrn": "urn:li:fsd_geo:104116203",
  "connectionType": "OUT_OF_NETWORK",
  "creatorInfo": {
    "hashTags": ["#books", "#climatechange", "#healthcare", "#innovation", "#sustainability"],
    "website": "https://gatesnot.es/tgn"
  },
  "jobTitle": "Co-chair",
  "companyName": "Gates Foundation",
  "companyPublicId": "gates-foundation",
  "companyLinkedinUrl": "https://www.linkedin.com/company/gates-foundation/",
  "currentPosition": {
    "positionUrn": "urn:li:fsd_profilePosition:(ACoAAA8BYqEBCGLg_vT_ca6mMEqkpp9nVffJ3hc,392598211)",
    "title": "Co-chair",
    "name": "Gates Foundation",
    "companyId": "8736",
    "companyUrn": "urn:li:fsd_company:8736",
    "publicIdentifier": "gates-foundation",
    "url": "https://www.linkedin.com/company/gates-foundation/"
  },
  "currentSchool": null,
  "followerCount": 40076104,
  "connectionsCount": 8,
  "creator": true,
  "influencer": true,
  "premium": true,
  "isVerified": false,
  "memberId": "251749025",
  "openToWork": false,
  "inRemembrance": false,
  "openProfile": false,
  "joinDate": { "month": 5, "year": 2013 },
  "url": "https://www.linkedin.com/in/williamhgates/",
  "pronoun": "he/him",
  "experiences": [
    {
      "name": "Gates Foundation",
      "jobTitle": "Co-chair",
      "description": "",
      "dateRange": "2000 - Present",
      "current": true,
      "positionUrn": "urn:li:fsd_profilePosition:(ACoAAA8BYqEBCGLg_vT_ca6mMEqkpp9nVffJ3hc,392598211)",
      "timePeriod": {
        "startDate": { "year": 2000 },
        "endDate": null
      },
      "company": {
        "url": "https://www.linkedin.com/company/gates-foundation/",
        "name": "Gates Foundation",
        "logo": "https://media.licdn.com/dms/image/...",
        "companyId": "8736",
        "urn": "urn:li:fsd_company:8736"
      }
    },
    {
      "name": "Microsoft",
      "jobTitle": "Co-founder",
      "description": "",
      "dateRange": "1975 - Present",
      "current": false,
      "positionUrn": "urn:li:fsd_profilePosition:(ACoAAA8BYqEBCGLg_vT_ca6mMEqkpp9nVffJ3hc,392599749)",
      "timePeriod": {
        "startDate": { "year": 1975 },
        "endDate": null
      },
      "company": {
        "url": "https://www.linkedin.com/company/microsoft/",
        "name": "Microsoft",
        "logo": "https://media.licdn.com/dms/image/...",
        "companyId": "1035",
        "urn": "urn:li:fsd_company:1035"
      }
    }
  ],
  "educations": [
    {
      "name": "Harvard University",
      "description": "",
      "dateRange": "1973 - 1975",
      "current": false,
      "educationUrn": "urn:li:fsd_profileEducation:(ACoAAA8BYqEBCGLg_vT_ca6mMEqkpp9nVffJ3hc,157656829)",
      "grade": "3.9/4.0",
      "details": "Studied mathematics and computer science before leaving to co-found Microsoft.",
      "schoolLogo": "https://media.licdn.com/dms/image/...",
      "schoolUrl": "https://www.linkedin.com/school/harvard-university/",
      "timePeriod": {
        "startDate": { "year": 1973 },
        "endDate": { "year": 1975 }
      }
    }
  ],
  "skills": [],
  "languages": [],
  "certifications": [],
  "recommendations": [
    {
      "caption": "Chairman and CEO at Microsoft",
      "description": "Bill's clarity of thought and depth of curiosity are unmatched. Every conversation with him leaves you thinking bigger.",
      "authorFullname": "Satya Nadella",
      "authorUrl": "https://www.linkedin.com/in/satyanadella/"
    }
  ],
  "testScores": [
    {
      "name": "TOEIC",
      "score": "990",
      "date": "Jun 2018"
    }
  ],
  "volunteerCauses": ["EDUCATION", "SCIENCE_AND_TECHNOLOGY"]
}

This endpoint is for members. If you pass an organization URL or URN, it stays
backward-compatible and returns a minimal, person-shaped summary of that
organization — firstName holds the organization name, title its tagline, and
experiences/educations are empty.

Use /api/v1/company instead for the full organization record.

{
  "error": "Missing profileUrlOrUrn parameter",
  "code": "MISSING_PARAMETER"
}

{
  "error": "Invalid API key",
  "code": "INVALID_API_KEY"
}

{
  "error": "LinkedIn profile not found",
  "code": "PROFILE_NOT_FOUND"
}

{
  "error": "Quota exceeded. Upgrade your plan or wait for renewal.",
  "code": "QUOTA_EXHAUSTED"
}

{
  "error": "Internal server error",
  "code": "INTERNAL_ERROR"
}

{
  "error": "Service temporarily unable to serve this request. Please retry.",
  "code": "SERVICE_UNAVAILABLE"
}

Errors

See Error Handling for the full list of error codes and recommended handling.

400 MISSING_PARAMETER / INVALID_URN
401 INVALID_API_KEY
404 PROFILE_NOT_FOUND
402 QUOTA_EXHAUSTED
429 RATE_LIMITED
500 INTERNAL_ERROR
503 SERVICE_UNAVAILABLE

Notes

This endpoint consumes 1 credit from your monthly quota. Failed requests (errors) do not count against your quota.

Profile data is fetched in real-time from professional data sources. Response times may vary.

Cache profile data for frequently accessed profiles to optimize quota usage.

Use Cases

Lead enrichment

Enhance your CRM with up-to-date professional profile data

Recruitment

Build candidate profiles from professional data

Research

Analyze professional backgrounds and career paths

Verification

Verify professional credentials and work history

Authorizations

X-API-Key

string

header

required

Query Parameters

profileUrlOrUrn

string

required

The professional profile to fetch. Accepts a profile URN (recommended for consistency, since a profile's public identifier can change over time while the URN does not; example urn:li:fsd_profile:ACoAAA8BYqEBCGLg_vT_ca6mMEqkpp9nVffJ3hc), a public identifier/slug (also fine; example williamhgates), or a full profile URL (example https://www.linkedin.com/in/williamhgates; a trailing slash is ignored). The slug is the last path segment of a profile URL, so pass just the slug, not the /in/ prefix.

Example:

"urn:li:fsd_profile:ACoAAA8BYqEBCGLg_vT_ca6mMEqkpp9nVffJ3hc"

Response

Successfully fetched profile

string

Profile URN (unique identifier)

Example:

"urn:li:fsd_profile:ACoAAABCDEF"

firstName

string

lastName

string

title

string

Professional headline

description

string

About/summary section

location

string

profilePictureUrl

string

experiences

object[]

Complete work experience history, ordered most recent first. Every position is returned in a single call - there is no pagination to follow and no cap.

Show child attributes

educations

object[]

Show child attributes

volunteerCauses

string[]

Volunteer causes listed on the profile

skills

object[]

Professional skills listed on the profile. Complete list, returned in the same single call as the rest of the profile.

Show child attributes

languages

object[]

Show child attributes

certifications

object[]

Show child attributes

coverImageUrl

string

Profile banner/background image URL

publicIdentifier

string

Public identifier (slug)

profileId

string

Member identifier

countryCode

string

ISO country code

geoLocationName

string

Full geographic location string

geoCountryName

string

Country name

geoUrn

string

Geo URN

connectionType

string

Relationship to the authenticated account

creatorInfo

object

Creator mode information

Show child attributes

jobTitle

string

Current job title

companyName

string

Current company name

companyPublicId

string

Current company public identifier slug

companyLinkedinUrl

string

Current company profile URL

currentPosition

object | null

Explicit "current company" block from the top of the profile page. Object when the member displays it, null when they don't (an ongoing primary position may still exist in experiences).

Show child attributes

currentSchool

object | null

Explicit "education" block from the top of the profile page. Object when the member displays it, null when they don't.

Show child attributes

followerCount

number

Number of followers

connectionsCount

number

Number of connections

creator

boolean

Whether Creator mode is enabled

influencer

boolean

Whether the profile is an influencer

premium

boolean

Whether the profile has Premium

isVerified

boolean

Whether the profile has a verification badge

memberId

string

Numeric internal member id (e.g. "251749025"). Distinct from id/profileId, which carry the urn:li:fsd_profile:… form.

Example:

"251749025"

openToWork

boolean

Whether the profile shows the public #OPEN_TO_WORK photo frame. Reflects the publicly visible badge only; recruiter-only 'open to work' is not exposed.

inRemembrance

boolean

Whether the account is memorialized / 'In Remembrance' (deceased member).

openProfile

boolean

Whether the member runs an open profile: anyone can message them directly without being one of their connections, and without spending a paid message credit. Unrelated to openToWork, and not the same as premium (some non-premium members are reachable this way). Omitted (rather than reported as false) when the signal is unavailable.

joinDate

object

Approximate account creation date (month + year).

Show child attributes

url

string

Canonical public URL of the professional profile page

Example:

"https://www.linkedin.com/in/williamhgates/"

pronoun

string

Publicly displayed pronouns (e.g. "she/her"). Omitted when the member doesn't display pronouns.

Example:

"she/her"

recommendations

object[]

Recommendations received by the member. Best-effort: omitted when this section could not be fetched, empty array when the member has none.

Show child attributes

testScores

object[]

Test scores listed on the profile

Show child attributes

Getting Started

Core Concepts

Apify Compatibility

Account

Posts

Profile

Company

Endpoint

Authentication

Parameters

Response

Example Request

Example Response

Errors

Notes

Use Cases

Lead enrichment

Recruitment

Research

Verification

Authorizations

Query Parameters

Response

​Endpoint

​Authentication

​Parameters

​Response

​Example Request

​Example Response

​Errors

​Notes

​Use Cases

Lead enrichment

Recruitment

Research

Verification

Authorizations

Query Parameters

Response

Endpoint

Authentication

Parameters

Response

Example Request

Example Response

Errors

Notes

Use Cases