People Profile

curl --request POST \
  --url https://api.datamagnet.co/api/v1/person \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "url": "<string>",
  "use_cache": "<string>",
  "lang": "<string>",
  "company_interest": true,
  "top_voices_interest": true,
  "group_interest": true,
  "school_interest": true,
  "newsletter_interest": true,
  "similar_profiles": true,
  "recommendations_data": true,
  "company_interest_page": 123,
  "group_interest_page": 123,
  "school_interest_page": 123,
  "newsletter_interest_page": 123
}
'

import requests

url = "https://api.datamagnet.co/api/v1/person"

payload = {
    "url": "<string>",
    "use_cache": "<string>",
    "lang": "<string>",
    "company_interest": True,
    "top_voices_interest": True,
    "group_interest": True,
    "school_interest": True,
    "newsletter_interest": True,
    "similar_profiles": True,
    "recommendations_data": True,
    "company_interest_page": 123,
    "group_interest_page": 123,
    "school_interest_page": 123,
    "newsletter_interest_page": 123
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    url: '<string>',
    use_cache: '<string>',
    lang: '<string>',
    company_interest: true,
    top_voices_interest: true,
    group_interest: true,
    school_interest: true,
    newsletter_interest: true,
    similar_profiles: true,
    recommendations_data: true,
    company_interest_page: 123,
    group_interest_page: 123,
    school_interest_page: 123,
    newsletter_interest_page: 123
  })
};

fetch('https://api.datamagnet.co/api/v1/person', 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.datamagnet.co/api/v1/person",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'url' => '<string>',
    'use_cache' => '<string>',
    'lang' => '<string>',
    'company_interest' => true,
    'top_voices_interest' => true,
    'group_interest' => true,
    'school_interest' => true,
    'newsletter_interest' => true,
    'similar_profiles' => true,
    'recommendations_data' => true,
    'company_interest_page' => 123,
    'group_interest_page' => 123,
    'school_interest_page' => 123,
    'newsletter_interest_page' => 123
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://api.datamagnet.co/api/v1/person"

	payload := strings.NewReader("{\n  \"url\": \"<string>\",\n  \"use_cache\": \"<string>\",\n  \"lang\": \"<string>\",\n  \"company_interest\": true,\n  \"top_voices_interest\": true,\n  \"group_interest\": true,\n  \"school_interest\": true,\n  \"newsletter_interest\": true,\n  \"similar_profiles\": true,\n  \"recommendations_data\": true,\n  \"company_interest_page\": 123,\n  \"group_interest_page\": 123,\n  \"school_interest_page\": 123,\n  \"newsletter_interest_page\": 123\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.datamagnet.co/api/v1/person")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"url\": \"<string>\",\n  \"use_cache\": \"<string>\",\n  \"lang\": \"<string>\",\n  \"company_interest\": true,\n  \"top_voices_interest\": true,\n  \"group_interest\": true,\n  \"school_interest\": true,\n  \"newsletter_interest\": true,\n  \"similar_profiles\": true,\n  \"recommendations_data\": true,\n  \"company_interest_page\": 123,\n  \"group_interest_page\": 123,\n  \"school_interest_page\": 123,\n  \"newsletter_interest_page\": 123\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.datamagnet.co/api/v1/person")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"url\": \"<string>\",\n  \"use_cache\": \"<string>\",\n  \"lang\": \"<string>\",\n  \"company_interest\": true,\n  \"top_voices_interest\": true,\n  \"group_interest\": true,\n  \"school_interest\": true,\n  \"newsletter_interest\": true,\n  \"similar_profiles\": true,\n  \"recommendations_data\": true,\n  \"company_interest_page\": 123,\n  \"group_interest_page\": 123,\n  \"school_interest_page\": 123,\n  \"newsletter_interest_page\": 123\n}"

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

{
  "message": {
    "email": "",
    "full_name": "Jane Doe",
    "first_name": "Jane",
    "last_name": "Doe",
    "middle_name": "",
    "display_name": "Jane Doe",
    "unformatted_full_name": "Jane Doe",
    "username": "jane-doe-example",
    "profile_link": "https://linkedin.com/in/jane-doe-example",
    "linkedin_id": "2980124",
    "sales_id": "urn:li:fsd_profile:ACoAAAExampleUrnNotARealMember",
    "linkedin_sales_link": "",
    "phone_number": null,
    "twitter_link": "",
    "pronoun": "she/her",
    "avatar_url": "https://media.licdn.com/dms/image/.../profile-displayphoto-shrink_800_800/...",
    "background_picture": "",
    "avatar_all_dimensions": [
      {
        "width": 100,
        "height": 100,
        "expires_at": 1788998400000,
        "image": "https://media.licdn.com/dms/image/.../shrink_100_100/..."
      }
    ],
    "background_picture_all_dimensions": [],
    "profile_pictures": [
      {
        "url": "https://media.licdn.com/dms/image/.../shrink_100_100/...",
        "width": 100,
        "height": 100
      }
    ],
    "background_pictures": [],
    "profile_headline": "VP of Engineering at Acme Corp",
    "description": "I lead the platform team at Acme.",
    "location": "Austin, Texas, United States",
    "country": "United States",
    "location_city": "Austin",
    "location_state": "Texas",
    "location_county": "",
    "address": null,
    "address_with_country": "Austin, Texas, United States",
    "address_without_country": "Austin, Texas",
    "address_country_only": "United States",
    "country_code": "US",
    "primary_locale": {
      "country": "US",
      "language": "en"
    },
    "is_creator": false,
    "is_premium": true,
    "is_influencer": false,
    "is_retired": false,
    "is_openlink": false,
    "is_job_seeker": false,
    "is_verified": false,
    "is_open_to_work": false,
    "is_hiring": false,
    "is_memorialized": null,
    "geo_location_backfilled": null,
    "show_premium_badge": null,
    "temp_status": null,
    "company_name_on_profile_top_card_shown": null,
    "education_on_profile_top_card_shown": null,
    "followers": 1280,
    "connections": 500,
    "job_title": "VP of Engineering",
    "raw_job_title": "VP of Engineering",
    "job_started_on": "3-2021",
    "job_ended_on": "",
    "job_still_working": true,
    "job_location": "Austin, Texas, United States",
    "job_location_city": "Austin",
    "job_location_state": "Texas",
    "job_location_county": "",
    "job_location_country": "United States",
    "job_description": [
      "Own the platform roadmap."
    ],
    "company_id": "1337",
    "company_image": "https://media.licdn.com/dms/image/...",
    "company_website": "https://acme.example",
    "company_industry": "Software Development",
    "industry": "Software Development",
    "industry_name": "Software Development",
    "industry_urn": "urn:li:fsd_industry:4",
    "current_company_name": "Acme Corp",
    "raw_company_name": "Acme Corp",
    "current_company_linkedin_url": "https://www.linkedin.com/company/acme-corp/",
    "total_experiences": 2,
    "experience": [
      {
        "job_title": "VP of Engineering",
        "company_id": "1337",
        "company_urn": "urn:li:fsd_company:1337",
        "company_username": "acme-corp",
        "company_url": "https://www.linkedin.com/company/acme-corp/",
        "company_name": "Acme Corp",
        "job_ended_on": "",
        "job_location": "Austin, Texas, United States",
        "company_image": "",
        "raw_job_title": "VP of Engineering",
        "job_started_on": "3-2021",
        "company_website": "",
        "employment_type": "Full-time",
        "job_description": [
          "Own the platform roadmap."
        ],
        "company_industry": "",
        "raw_company_name": "Acme Corp",
        "job_location_city": "Austin",
        "job_still_working": true,
        "job_location_state": "Texas",
        "job_location_county": "",
        "job_location_country": "United States",
        "company_headcount_range": "1,001-5,000 employees",
        "company_followers": "",
        "company_employee_count": "",
        "company_description": "",
        "workplace_type": "Hybrid",
        "skills": [
          "Distributed Systems",
          "Engineering Management"
        ],
        "position_urn": "urn:li:fsd_profilePosition:(ACoAAAExampleUrnNotARealMember,2122388595)",
        "geo_urn": "urn:li:fsd_geo:104994045",
        "total_duration": "5 yrs 7 mos",
        "position_group_urn": "urn:li:fsd_profilePositionGroup:(ACoAAAExampleUrnNotARealMember,0f1e2d3c4b5a69788796a5b4c3d2e1f001122334)",
        "position_group_id": "0f1e2d3c4b5a69788796a5b4c3d2e1f001122334",
        "geo_id": "104994045",
        "is_current": true
      }
    ],
    "education": [
      {
        "logo": "",
        "grade": "",
        "ended_on": {
          "year": 2009,
          "month": 0
        },
        "social_url": "",
        "started_on": {
          "year": 2005,
          "month": 0
        },
        "description": "",
        "university_id": "3223",
        "university_urn": "urn:li:fsd_company:3223",
        "university_website": "",
        "university_industry": "",
        "university_headcount_range": "",
        "university_followers": "",
        "university_employee_count": "",
        "university_description": "",
        "degree": "Bachelor of Science",
        "fields_of_study": [
          "Computer Science"
        ],
        "activities": "",
        "activities_inferred": false,
        "raw_text": "",
        "university_name": "University of Texas at Austin",
        "raw_university_name": "University of Texas at Austin",
        "education_urn": "urn:li:fsd_profileEducation:(ACoAAAExampleUrnNotARealMember,861262212)",
        "is_current": false,
        "skills": ""
      }
    ],
    "skills": [
      "Distributed Systems",
      "Engineering Management"
    ],
    "certification": [
      {
        "name": "AWS Certified Solutions Architect",
        "issuer": "Amazon Web Services (AWS)",
        "issuer_id": "",
        "issuer_urn": "",
        "issuer_url": "",
        "issuer_logo": "",
        "issued_on": {
          "month": 6,
          "year": 2022
        },
        "expires_on": {
          "month": 0,
          "year": 0
        },
        "credential_id": "ABC123",
        "credential_url": "",
        "description": "",
        "url": "",
        "authority": "Amazon Web Services (AWS)",
        "started_on": {
          "day": null,
          "year": 2022,
          "month": 6
        },
        "company_id": "",
        "end_date": {
          "day": 0,
          "month": 0,
          "year": 0
        },
        "company_logo": "",
        "company_name": "Amazon Web Services (AWS)"
      }
    ],
    "language": [
      {
        "name": "English",
        "proficiency": "NATIVE_OR_BILINGUAL"
      }
    ],
    "publication": [],
    "project": [],
    "volunteering": [],
    "honors_and_awards": [],
    "organizations": [],
    "patents": [],
    "courses": [],
    "same_name": [],
    "associated_hashtag": [
      "#engineering"
    ],
    "birthday": {
      "day": "",
      "year": "",
      "month": ""
    },
    "join_date": {
      "month": 4,
      "year": 2011
    },
    "causes": [
      "EDUCATION"
    ],
    "featured": [],
    "also_viewed": [
      {
        "entity_urn": "urn:li:fsd_profile:ACoAAB...",
        "first_name": "John",
        "last_name": "Smith",
        "headline": "CTO at Example",
        "public_identifier": "john-smith-example",
        "url": "https://linkedin.com/in/john-smith-example",
        "profile_picture": "https://media.licdn.com/dms/image/...",
        "follower_count": 897,
        "premium": true,
        "creator": false
      }
    ],
    "recommendations_received": [
      {
        "context": "John managed Jane directly",
        "date": "January 14, 2025",
        "description": "Jane is a great leader.",
        "name": "John Smith",
        "subtitle": "CTO at Example",
        "profile_picture_url": null,
        "url": "https://www.linkedin.com/in/john-smith-example",
        "urn": null,
        "last_modified_at": "2025-01-15T09:30:00.000Z"
      }
    ],
    "recommendations_given": [],
    "websites": [
      {
        "url": "https://janedoe.example",
        "category": "PERSONAL"
      }
    ],
    "contact_info": [],
    "updates": [],
    "creator_website": "",
    "geo_urn": "urn:li:fsd_geo:104994045",
    "connection_type": "OUT_OF_NETWORK",
    "entity_type": "Person",
    "current_school_id": "3223",
    "current_school_urn": "urn:li:fsd_school:3223",
    "is_top_voice": false,
    "show_follower_count": true,
    "test_scores": [
      {
        "name": "GMAT",
        "score": "730",
        "date": {
          "month": 6,
          "year": 2013
        }
      }
    ]
  }
}

POST

api

person

People Profile

curl --request POST \
  --url https://api.datamagnet.co/api/v1/person \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "url": "<string>",
  "use_cache": "<string>",
  "lang": "<string>",
  "company_interest": true,
  "top_voices_interest": true,
  "group_interest": true,
  "school_interest": true,
  "newsletter_interest": true,
  "similar_profiles": true,
  "recommendations_data": true,
  "company_interest_page": 123,
  "group_interest_page": 123,
  "school_interest_page": 123,
  "newsletter_interest_page": 123
}
'

import requests

url = "https://api.datamagnet.co/api/v1/person"

payload = {
    "url": "<string>",
    "use_cache": "<string>",
    "lang": "<string>",
    "company_interest": True,
    "top_voices_interest": True,
    "group_interest": True,
    "school_interest": True,
    "newsletter_interest": True,
    "similar_profiles": True,
    "recommendations_data": True,
    "company_interest_page": 123,
    "group_interest_page": 123,
    "school_interest_page": 123,
    "newsletter_interest_page": 123
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    url: '<string>',
    use_cache: '<string>',
    lang: '<string>',
    company_interest: true,
    top_voices_interest: true,
    group_interest: true,
    school_interest: true,
    newsletter_interest: true,
    similar_profiles: true,
    recommendations_data: true,
    company_interest_page: 123,
    group_interest_page: 123,
    school_interest_page: 123,
    newsletter_interest_page: 123
  })
};

fetch('https://api.datamagnet.co/api/v1/person', 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.datamagnet.co/api/v1/person",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'url' => '<string>',
    'use_cache' => '<string>',
    'lang' => '<string>',
    'company_interest' => true,
    'top_voices_interest' => true,
    'group_interest' => true,
    'school_interest' => true,
    'newsletter_interest' => true,
    'similar_profiles' => true,
    'recommendations_data' => true,
    'company_interest_page' => 123,
    'group_interest_page' => 123,
    'school_interest_page' => 123,
    'newsletter_interest_page' => 123
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://api.datamagnet.co/api/v1/person"

	payload := strings.NewReader("{\n  \"url\": \"<string>\",\n  \"use_cache\": \"<string>\",\n  \"lang\": \"<string>\",\n  \"company_interest\": true,\n  \"top_voices_interest\": true,\n  \"group_interest\": true,\n  \"school_interest\": true,\n  \"newsletter_interest\": true,\n  \"similar_profiles\": true,\n  \"recommendations_data\": true,\n  \"company_interest_page\": 123,\n  \"group_interest_page\": 123,\n  \"school_interest_page\": 123,\n  \"newsletter_interest_page\": 123\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.datamagnet.co/api/v1/person")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"url\": \"<string>\",\n  \"use_cache\": \"<string>\",\n  \"lang\": \"<string>\",\n  \"company_interest\": true,\n  \"top_voices_interest\": true,\n  \"group_interest\": true,\n  \"school_interest\": true,\n  \"newsletter_interest\": true,\n  \"similar_profiles\": true,\n  \"recommendations_data\": true,\n  \"company_interest_page\": 123,\n  \"group_interest_page\": 123,\n  \"school_interest_page\": 123,\n  \"newsletter_interest_page\": 123\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.datamagnet.co/api/v1/person")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"url\": \"<string>\",\n  \"use_cache\": \"<string>\",\n  \"lang\": \"<string>\",\n  \"company_interest\": true,\n  \"top_voices_interest\": true,\n  \"group_interest\": true,\n  \"school_interest\": true,\n  \"newsletter_interest\": true,\n  \"similar_profiles\": true,\n  \"recommendations_data\": true,\n  \"company_interest_page\": 123,\n  \"group_interest_page\": 123,\n  \"school_interest_page\": 123,\n  \"newsletter_interest_page\": 123\n}"

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

{
  "message": {
    "email": "",
    "full_name": "Jane Doe",
    "first_name": "Jane",
    "last_name": "Doe",
    "middle_name": "",
    "display_name": "Jane Doe",
    "unformatted_full_name": "Jane Doe",
    "username": "jane-doe-example",
    "profile_link": "https://linkedin.com/in/jane-doe-example",
    "linkedin_id": "2980124",
    "sales_id": "urn:li:fsd_profile:ACoAAAExampleUrnNotARealMember",
    "linkedin_sales_link": "",
    "phone_number": null,
    "twitter_link": "",
    "pronoun": "she/her",
    "avatar_url": "https://media.licdn.com/dms/image/.../profile-displayphoto-shrink_800_800/...",
    "background_picture": "",
    "avatar_all_dimensions": [
      {
        "width": 100,
        "height": 100,
        "expires_at": 1788998400000,
        "image": "https://media.licdn.com/dms/image/.../shrink_100_100/..."
      }
    ],
    "background_picture_all_dimensions": [],
    "profile_pictures": [
      {
        "url": "https://media.licdn.com/dms/image/.../shrink_100_100/...",
        "width": 100,
        "height": 100
      }
    ],
    "background_pictures": [],
    "profile_headline": "VP of Engineering at Acme Corp",
    "description": "I lead the platform team at Acme.",
    "location": "Austin, Texas, United States",
    "country": "United States",
    "location_city": "Austin",
    "location_state": "Texas",
    "location_county": "",
    "address": null,
    "address_with_country": "Austin, Texas, United States",
    "address_without_country": "Austin, Texas",
    "address_country_only": "United States",
    "country_code": "US",
    "primary_locale": {
      "country": "US",
      "language": "en"
    },
    "is_creator": false,
    "is_premium": true,
    "is_influencer": false,
    "is_retired": false,
    "is_openlink": false,
    "is_job_seeker": false,
    "is_verified": false,
    "is_open_to_work": false,
    "is_hiring": false,
    "is_memorialized": null,
    "geo_location_backfilled": null,
    "show_premium_badge": null,
    "temp_status": null,
    "company_name_on_profile_top_card_shown": null,
    "education_on_profile_top_card_shown": null,
    "followers": 1280,
    "connections": 500,
    "job_title": "VP of Engineering",
    "raw_job_title": "VP of Engineering",
    "job_started_on": "3-2021",
    "job_ended_on": "",
    "job_still_working": true,
    "job_location": "Austin, Texas, United States",
    "job_location_city": "Austin",
    "job_location_state": "Texas",
    "job_location_county": "",
    "job_location_country": "United States",
    "job_description": [
      "Own the platform roadmap."
    ],
    "company_id": "1337",
    "company_image": "https://media.licdn.com/dms/image/...",
    "company_website": "https://acme.example",
    "company_industry": "Software Development",
    "industry": "Software Development",
    "industry_name": "Software Development",
    "industry_urn": "urn:li:fsd_industry:4",
    "current_company_name": "Acme Corp",
    "raw_company_name": "Acme Corp",
    "current_company_linkedin_url": "https://www.linkedin.com/company/acme-corp/",
    "total_experiences": 2,
    "experience": [
      {
        "job_title": "VP of Engineering",
        "company_id": "1337",
        "company_urn": "urn:li:fsd_company:1337",
        "company_username": "acme-corp",
        "company_url": "https://www.linkedin.com/company/acme-corp/",
        "company_name": "Acme Corp",
        "job_ended_on": "",
        "job_location": "Austin, Texas, United States",
        "company_image": "",
        "raw_job_title": "VP of Engineering",
        "job_started_on": "3-2021",
        "company_website": "",
        "employment_type": "Full-time",
        "job_description": [
          "Own the platform roadmap."
        ],
        "company_industry": "",
        "raw_company_name": "Acme Corp",
        "job_location_city": "Austin",
        "job_still_working": true,
        "job_location_state": "Texas",
        "job_location_county": "",
        "job_location_country": "United States",
        "company_headcount_range": "1,001-5,000 employees",
        "company_followers": "",
        "company_employee_count": "",
        "company_description": "",
        "workplace_type": "Hybrid",
        "skills": [
          "Distributed Systems",
          "Engineering Management"
        ],
        "position_urn": "urn:li:fsd_profilePosition:(ACoAAAExampleUrnNotARealMember,2122388595)",
        "geo_urn": "urn:li:fsd_geo:104994045",
        "total_duration": "5 yrs 7 mos",
        "position_group_urn": "urn:li:fsd_profilePositionGroup:(ACoAAAExampleUrnNotARealMember,0f1e2d3c4b5a69788796a5b4c3d2e1f001122334)",
        "position_group_id": "0f1e2d3c4b5a69788796a5b4c3d2e1f001122334",
        "geo_id": "104994045",
        "is_current": true
      }
    ],
    "education": [
      {
        "logo": "",
        "grade": "",
        "ended_on": {
          "year": 2009,
          "month": 0
        },
        "social_url": "",
        "started_on": {
          "year": 2005,
          "month": 0
        },
        "description": "",
        "university_id": "3223",
        "university_urn": "urn:li:fsd_company:3223",
        "university_website": "",
        "university_industry": "",
        "university_headcount_range": "",
        "university_followers": "",
        "university_employee_count": "",
        "university_description": "",
        "degree": "Bachelor of Science",
        "fields_of_study": [
          "Computer Science"
        ],
        "activities": "",
        "activities_inferred": false,
        "raw_text": "",
        "university_name": "University of Texas at Austin",
        "raw_university_name": "University of Texas at Austin",
        "education_urn": "urn:li:fsd_profileEducation:(ACoAAAExampleUrnNotARealMember,861262212)",
        "is_current": false,
        "skills": ""
      }
    ],
    "skills": [
      "Distributed Systems",
      "Engineering Management"
    ],
    "certification": [
      {
        "name": "AWS Certified Solutions Architect",
        "issuer": "Amazon Web Services (AWS)",
        "issuer_id": "",
        "issuer_urn": "",
        "issuer_url": "",
        "issuer_logo": "",
        "issued_on": {
          "month": 6,
          "year": 2022
        },
        "expires_on": {
          "month": 0,
          "year": 0
        },
        "credential_id": "ABC123",
        "credential_url": "",
        "description": "",
        "url": "",
        "authority": "Amazon Web Services (AWS)",
        "started_on": {
          "day": null,
          "year": 2022,
          "month": 6
        },
        "company_id": "",
        "end_date": {
          "day": 0,
          "month": 0,
          "year": 0
        },
        "company_logo": "",
        "company_name": "Amazon Web Services (AWS)"
      }
    ],
    "language": [
      {
        "name": "English",
        "proficiency": "NATIVE_OR_BILINGUAL"
      }
    ],
    "publication": [],
    "project": [],
    "volunteering": [],
    "honors_and_awards": [],
    "organizations": [],
    "patents": [],
    "courses": [],
    "same_name": [],
    "associated_hashtag": [
      "#engineering"
    ],
    "birthday": {
      "day": "",
      "year": "",
      "month": ""
    },
    "join_date": {
      "month": 4,
      "year": 2011
    },
    "causes": [
      "EDUCATION"
    ],
    "featured": [],
    "also_viewed": [
      {
        "entity_urn": "urn:li:fsd_profile:ACoAAB...",
        "first_name": "John",
        "last_name": "Smith",
        "headline": "CTO at Example",
        "public_identifier": "john-smith-example",
        "url": "https://linkedin.com/in/john-smith-example",
        "profile_picture": "https://media.licdn.com/dms/image/...",
        "follower_count": 897,
        "premium": true,
        "creator": false
      }
    ],
    "recommendations_received": [
      {
        "context": "John managed Jane directly",
        "date": "January 14, 2025",
        "description": "Jane is a great leader.",
        "name": "John Smith",
        "subtitle": "CTO at Example",
        "profile_picture_url": null,
        "url": "https://www.linkedin.com/in/john-smith-example",
        "urn": null,
        "last_modified_at": "2025-01-15T09:30:00.000Z"
      }
    ],
    "recommendations_given": [],
    "websites": [
      {
        "url": "https://janedoe.example",
        "category": "PERSONAL"
      }
    ],
    "contact_info": [],
    "updates": [],
    "creator_website": "",
    "geo_urn": "urn:li:fsd_geo:104994045",
    "connection_type": "OUT_OF_NETWORK",
    "entity_type": "Person",
    "current_school_id": "3223",
    "current_school_urn": "urn:li:fsd_school:3223",
    "is_top_voice": false,
    "show_follower_count": true,
    "test_scores": [
      {
        "name": "GMAT",
        "score": "730",
        "date": {
          "month": 6,
          "year": 2013
        }
      }
    ]
  }
}

People

Cost: 1 credit / successful request. (Extra charges might be incurred if premium optional parameters are used. Please read the description of the parameters that you intend to use) Each enrichment flag below costs an additional 2 credits, charged only when that specific enrichment succeeds. If a requested enrichment fails after retries, the base profile request still succeeds and the corresponding field is returned with a generic error — you are not charged for that failed enrichment. Get structured data of a Personal Profile.

Person profile endpoint

This endpoint allows you to get structured data of a Personal Profile.

Required attributes

string

required

The LinkedIn URL of the person.

Optional attributes

string

Alters the caching behavior.

if-present - The default behavior. Fetches profile from cache regardless of age of profile. If the profile is not available in cache, the API fetches it live.
if-recent - API will make a best effort to return a fresh profile no older than 29 days.
never - Do not ever read profile from cache.

string

The language in which you need your response.

Enrichment flags

Each of the following flags is false by default. Set a flag to true to make an additional request and append the corresponding field to the response. Every additional request that succeeds is retried automatically on transient failures, and costs an extra 2 credits on top of the base endpoint cost.

boolean

Appends the list of companies the profile follows to company_interest.Costs an additional 2 credit, subject to data availability, on top of the base endpoint cost.

boolean

Appends the list of LinkedIn Top Voices the profile follows to top_voices_interest.Costs an additional 2 credit, subject to data availability, on top of the base endpoint cost.

boolean

Appends the list of LinkedIn Groups the profile is a member of to group_interest.Costs an additional 2 credit, subject to data availability, on top of the base endpoint cost.

boolean

Appends the list of schools the profile follows to school_interest.Costs an additional 2 credit, subject to data availability, on top of the base endpoint cost.

Appends the list of LinkedIn Newsletters the profile is subscribed to newsletter_interest.Costs an additional 2 credit, subject to data availability, on top of the base endpoint cost.

boolean

Appends a list of profiles similar to this one to similar_profiles.Costs an additional 2 credit, subject to data availability, on top of the base endpoint cost.

boolean

Appends the full profile bundle plus given/received recommendations to recommendations_data.Costs an additional 2 credit, subject to data availability, on top of the base endpoint cost.

Enrichment pages

company_interest, group_interest, school_interest and newsletter_interest return one page at a time. Send the page number you want; the response carries current_page and total_pages. Each request for another page is a new request and costs the enrichment credits again.

number

Page of company_interest to return. Defaults to 1.

number

Page of group_interest to return. Defaults to 1.

number

Page of school_interest to return. Defaults to 1.

Page of newsletter_interest to return. Defaults to 1.

Error response:

{
  "company_interest": {
    "error": "Unable to fetch this data at this time."
  }
}

Response

{
  "message": {
    "email": "",
    "full_name": "Jane Doe",
    "first_name": "Jane",
    "last_name": "Doe",
    "middle_name": "",
    "display_name": "Jane Doe",
    "unformatted_full_name": "Jane Doe",
    "username": "jane-doe-example",
    "profile_link": "https://linkedin.com/in/jane-doe-example",
    "linkedin_id": "2980124",
    "sales_id": "urn:li:fsd_profile:ACoAAAExampleUrnNotARealMember",
    "linkedin_sales_link": "",
    "phone_number": null,
    "twitter_link": "",
    "pronoun": "she/her",
    "avatar_url": "https://media.licdn.com/dms/image/.../profile-displayphoto-shrink_800_800/...",
    "background_picture": "",
    "avatar_all_dimensions": [
      {
        "width": 100,
        "height": 100,
        "expires_at": 1788998400000,
        "image": "https://media.licdn.com/dms/image/.../shrink_100_100/..."
      }
    ],
    "background_picture_all_dimensions": [],
    "profile_pictures": [
      {
        "url": "https://media.licdn.com/dms/image/.../shrink_100_100/...",
        "width": 100,
        "height": 100
      }
    ],
    "background_pictures": [],
    "profile_headline": "VP of Engineering at Acme Corp",
    "description": "I lead the platform team at Acme.",
    "location": "Austin, Texas, United States",
    "country": "United States",
    "location_city": "Austin",
    "location_state": "Texas",
    "location_county": "",
    "address": null,
    "address_with_country": "Austin, Texas, United States",
    "address_without_country": "Austin, Texas",
    "address_country_only": "United States",
    "country_code": "US",
    "primary_locale": {
      "country": "US",
      "language": "en"
    },
    "is_creator": false,
    "is_premium": true,
    "is_influencer": false,
    "is_retired": false,
    "is_openlink": false,
    "is_job_seeker": false,
    "is_verified": false,
    "is_open_to_work": false,
    "is_hiring": false,
    "is_memorialized": null,
    "geo_location_backfilled": null,
    "show_premium_badge": null,
    "temp_status": null,
    "company_name_on_profile_top_card_shown": null,
    "education_on_profile_top_card_shown": null,
    "followers": 1280,
    "connections": 500,
    "job_title": "VP of Engineering",
    "raw_job_title": "VP of Engineering",
    "job_started_on": "3-2021",
    "job_ended_on": "",
    "job_still_working": true,
    "job_location": "Austin, Texas, United States",
    "job_location_city": "Austin",
    "job_location_state": "Texas",
    "job_location_county": "",
    "job_location_country": "United States",
    "job_description": [
      "Own the platform roadmap."
    ],
    "company_id": "1337",
    "company_image": "https://media.licdn.com/dms/image/...",
    "company_website": "https://acme.example",
    "company_industry": "Software Development",
    "industry": "Software Development",
    "industry_name": "Software Development",
    "industry_urn": "urn:li:fsd_industry:4",
    "current_company_name": "Acme Corp",
    "raw_company_name": "Acme Corp",
    "current_company_linkedin_url": "https://www.linkedin.com/company/acme-corp/",
    "total_experiences": 2,
    "experience": [
      {
        "job_title": "VP of Engineering",
        "company_id": "1337",
        "company_urn": "urn:li:fsd_company:1337",
        "company_username": "acme-corp",
        "company_url": "https://www.linkedin.com/company/acme-corp/",
        "company_name": "Acme Corp",
        "job_ended_on": "",
        "job_location": "Austin, Texas, United States",
        "company_image": "",
        "raw_job_title": "VP of Engineering",
        "job_started_on": "3-2021",
        "company_website": "",
        "employment_type": "Full-time",
        "job_description": [
          "Own the platform roadmap."
        ],
        "company_industry": "",
        "raw_company_name": "Acme Corp",
        "job_location_city": "Austin",
        "job_still_working": true,
        "job_location_state": "Texas",
        "job_location_county": "",
        "job_location_country": "United States",
        "company_headcount_range": "1,001-5,000 employees",
        "company_followers": "",
        "company_employee_count": "",
        "company_description": "",
        "workplace_type": "Hybrid",
        "skills": [
          "Distributed Systems",
          "Engineering Management"
        ],
        "position_urn": "urn:li:fsd_profilePosition:(ACoAAAExampleUrnNotARealMember,2122388595)",
        "geo_urn": "urn:li:fsd_geo:104994045",
        "total_duration": "5 yrs 7 mos",
        "position_group_urn": "urn:li:fsd_profilePositionGroup:(ACoAAAExampleUrnNotARealMember,0f1e2d3c4b5a69788796a5b4c3d2e1f001122334)",
        "position_group_id": "0f1e2d3c4b5a69788796a5b4c3d2e1f001122334",
        "geo_id": "104994045",
        "is_current": true
      }
    ],
    "education": [
      {
        "logo": "",
        "grade": "",
        "ended_on": {
          "year": 2009,
          "month": 0
        },
        "social_url": "",
        "started_on": {
          "year": 2005,
          "month": 0
        },
        "description": "",
        "university_id": "3223",
        "university_urn": "urn:li:fsd_company:3223",
        "university_website": "",
        "university_industry": "",
        "university_headcount_range": "",
        "university_followers": "",
        "university_employee_count": "",
        "university_description": "",
        "degree": "Bachelor of Science",
        "fields_of_study": [
          "Computer Science"
        ],
        "activities": "",
        "activities_inferred": false,
        "raw_text": "",
        "university_name": "University of Texas at Austin",
        "raw_university_name": "University of Texas at Austin",
        "education_urn": "urn:li:fsd_profileEducation:(ACoAAAExampleUrnNotARealMember,861262212)",
        "is_current": false,
        "skills": ""
      }
    ],
    "skills": [
      "Distributed Systems",
      "Engineering Management"
    ],
    "certification": [
      {
        "name": "AWS Certified Solutions Architect",
        "issuer": "Amazon Web Services (AWS)",
        "issuer_id": "",
        "issuer_urn": "",
        "issuer_url": "",
        "issuer_logo": "",
        "issued_on": {
          "month": 6,
          "year": 2022
        },
        "expires_on": {
          "month": 0,
          "year": 0
        },
        "credential_id": "ABC123",
        "credential_url": "",
        "description": "",
        "url": "",
        "authority": "Amazon Web Services (AWS)",
        "started_on": {
          "day": null,
          "year": 2022,
          "month": 6
        },
        "company_id": "",
        "end_date": {
          "day": 0,
          "month": 0,
          "year": 0
        },
        "company_logo": "",
        "company_name": "Amazon Web Services (AWS)"
      }
    ],
    "language": [
      {
        "name": "English",
        "proficiency": "NATIVE_OR_BILINGUAL"
      }
    ],
    "publication": [],
    "project": [],
    "volunteering": [],
    "honors_and_awards": [],
    "organizations": [],
    "patents": [],
    "courses": [],
    "same_name": [],
    "associated_hashtag": [
      "#engineering"
    ],
    "birthday": {
      "day": "",
      "year": "",
      "month": ""
    },
    "join_date": {
      "month": 4,
      "year": 2011
    },
    "causes": [
      "EDUCATION"
    ],
    "featured": [],
    "also_viewed": [
      {
        "entity_urn": "urn:li:fsd_profile:ACoAAB...",
        "first_name": "John",
        "last_name": "Smith",
        "headline": "CTO at Example",
        "public_identifier": "john-smith-example",
        "url": "https://linkedin.com/in/john-smith-example",
        "profile_picture": "https://media.licdn.com/dms/image/...",
        "follower_count": 897,
        "premium": true,
        "creator": false
      }
    ],
    "recommendations_received": [
      {
        "context": "John managed Jane directly",
        "date": "January 14, 2025",
        "description": "Jane is a great leader.",
        "name": "John Smith",
        "subtitle": "CTO at Example",
        "profile_picture_url": null,
        "url": "https://www.linkedin.com/in/john-smith-example",
        "urn": null,
        "last_modified_at": "2025-01-15T09:30:00.000Z"
      }
    ],
    "recommendations_given": [],
    "websites": [
      {
        "url": "https://janedoe.example",
        "category": "PERSONAL"
      }
    ],
    "contact_info": [],
    "updates": [],
    "creator_website": "",
    "geo_urn": "urn:li:fsd_geo:104994045",
    "connection_type": "OUT_OF_NETWORK",
    "entity_type": "Person",
    "current_school_id": "3223",
    "current_school_urn": "urn:li:fsd_school:3223",
    "is_top_voice": false,
    "show_follower_count": true,
    "test_scores": [
      {
        "name": "GMAT",
        "score": "730",
        "date": {
          "month": 6,
          "year": 2013
        }
      }
    ]
  }
}

The person model

Every response carries all of the keys below, regardless of the profile. A value the profile does not have is an empty string (""), an empty array ([]) or 0 for the parts of a date; where a key can also be null, its type says so. Entries inside a list carry every key listed for that list. Types are written as string, number, boolean, object, array of strings, array of objects. X | null means the key is null when the value is not available for the profile. That is different from an empty value: followers: null means the count could not be read, followers: 0 means the profile has none.

Properties

Basic information

string

First name.

string

Middle name. Empty when none.

string

Last name.

string

Full name.

string

Name as displayed on LinkedIn.

string

Full name before any cleanup.

string

Pronouns the member set, e.g. she/her. Empty when not set.

string

LinkedIn username (the vanity name in the profile URL).

string

Numeric LinkedIn member ID, digits only. Derived from the profile URN.

string

Profile URL, https://linkedin.com/in/<username>.

string

LinkedIn profile URN, e.g. urn:li:fsd_profile:ACoAA....

string

Sales Navigator link to the profile.

string

LinkedIn’s network-distance label for the profile. In practice always OUT_OF_NETWORK, because requests are not made from a LinkedIn account connected to the member. Empty when not available for the profile.

string

Type of the LinkedIn entity. In practice always Person. Empty when not available for the profile.

Headline and summary

string

Headline under the name.

string

The About section.

Current role

string

Title of the current role.

string

Title exactly as shown on the profile.

array of strings

Description of the current role, one string per paragraph.

string

Start of the current role as M-YYYY. A role dated by year only is 0-YYYY. Empty when undated.

string

End of the role as M-YYYY. Empty while current.

boolean | null

Whether the current role is still held. null when the role has neither a start nor an end date. false when the profile has no roles.

string

Location of the current role.

string

City.

string

State or region.

string

County. Profiles do not show one, so this is empty.

string

Country.

number | null

Number of roles on the profile. null when the total is not available for the profile.

Current company

string

Employer in the current role.

string

Employer name exactly as shown.

string

LinkedIn URL of the employer.

string

LinkedIn company ID of the employer.

string

Employer logo URL.

string

Employer website.

string

Employer industry.

string

Industry the member lists on the profile.

string

Same as industry.

string

LinkedIn URN of the industry.

Location

string

Location as shown on the profile, e.g. Austin, Texas, United States or Berlin Metropolitan Area.

string

Country name, e.g. United States.

string

Two-letter country code, e.g. US. Empty when not available.

string

City, or the metro area name.

string

State or region. Empty for a city-only or country-only location.

string

County. Profiles do not show one, so this is empty.

string | null

Street address. Profiles do not show one, so this is null.

string

Location with the country last.

string

Location without the country.

string

The country alone.

string

LinkedIn URN of the profile’s location, e.g. urn:li:fsd_geo:100495523. Empty when not available for the profile.

object

The profile’s language and country setting. {} when unknown.

Show primary_locale

string

Country code, e.g. US.

string

Language code, e.g. en.

Contact information

string

Email address, when publicly visible.

string | null

Phone number. Phone numbers are not returned, so this is null.

string

Twitter / X profile link.

array of objects

Websites listed in the member’s contact info. Empty when not available for the profile.

Show websites

string

Link.

string

LinkedIn’s category: PERSONAL, BLOG, PORTFOLIO, COMPANY, RSS, OTHER, … Empty when not stated.

array of objects

Lines of the member’s contact card. Empty when not available for the profile.

Show contact_info

string

Label, e.g. Website, Phone, Email.

string

Its value.

string

Website set in Creator mode. Empty when not a creator or none set.

Profile statistics

number | null

Number of connections. null when the count is not available for the profile, which is not the same as 0.

number | null

Number of followers. null when the count is not available for the profile, which is not the same as 0.

object

When the member joined LinkedIn. 0s when not available for the profile.

Show join_date

number

Month, 1-12. 0 when unknown.

number

Year. 0 when unknown.

Profile attributes

boolean

Has LinkedIn Premium.

boolean

Is a LinkedIn creator.

boolean

Is a LinkedIn influencer.

boolean

Is marked as a job seeker.

boolean

Uses OpenLink.

boolean

Is retired.

boolean | null

Has a verified badge. null when the provider that served this profile does not report verification at all, which is not a claim that the member is unverified.

boolean | null

Shows the Open to Work badge. null when the badge status is not available for the profile.

boolean | null

Shows the Hiring badge. null when the badge status is not available for the profile.

boolean | null

Has the LinkedIn Top Voice badge. null when not available for the profile.

boolean | null

The profile is memorialized. null when not available for the profile.

boolean | null

LinkedIn filled the location in itself. null when not available for the profile.

boolean | null

The Premium badge is shown. null when not available for the profile.

boolean | null

The member shows their follower count publicly. null when not available for the profile.

null

Reserved. Always null.

boolean | null

Company name is shown on the top card. null when not available for the profile.

boolean | null

Education is shown on the top card. null when not available for the profile.

Profile media

string

Profile picture URL (largest size).

string

Cover image URL.

array of objects

Profile picture at every size.

Show avatar_all_dimensions

string

Image URL.

number

Width in pixels.

number

Height in pixels.

number | null

When the image URL expires, in milliseconds since the Unix epoch (read from the URL’s e= parameter). null when the URL carries none.

array of objects

Cover image at every size.

Show background_picture_all_dimensions

string

Image URL.

number

Width in pixels.

number

Height in pixels.

number | null

When the image URL expires, in milliseconds since the Unix epoch (read from the URL’s e= parameter). null when the URL carries none.

array of objects

Profile picture at every size, without the expiry.

Show profile_pictures

string

Image URL.

number

Width in pixels.

number

Height in pixels.

array of objects

Cover image at every size, without the expiry.

Show background_pictures

string

Image URL.

number

Width in pixels.

number

Height in pixels.

Personal details

object

Birthday, when shared. Every part is an empty string when not shared.

Show birthday

string

Day.

string

Month.

string

Year.

array of strings

Causes the member cares about, e.g. ANIMAL_RIGHTS. Empty when not available for the profile.

array of strings

Hashtags the member set in Creator mode. Empty when none.

Experience

array of objects

Work experience, newest first. Every entry carries all of these keys.

Show experience

string

Name of the company.

string

Company name exactly as shown on the profile.

string

LinkedIn URL of the company page.

string

LinkedIn company ID. Empty when the company has no LinkedIn page.

string

LinkedIn company URN, e.g. urn:li:fsd_company:1337. Empty when there is no company ID.

string

Company’s LinkedIn universal name (the slug in its page URL).

string

Company logo URL.

string

Industry of the company, when we have company data for it.

string

Company website, when we have company data for it.

string

Company size band, e.g. 1,001-5,000 employees. Empty when unknown.

string

Followers of the company page, when we have company data for it.

string

Employee count, when we have company data for it.

string

Company description, when we have company data for it.

string

Job title.

string

Job title exactly as shown on the profile.

string

LinkedIn’s employment type, e.g. Full-time, Part-time, Contract, Self-employed, Freelance, Internship. Empty when the profile shows none.

string

On-site, Remote or Hybrid. Empty when unknown.

array of strings

Skills attached to this role. Empty when not available for the profile.

string

LinkedIn URN of this position, e.g. urn:li:fsd_profilePosition:(ACoAAA...,2122388595). Empty when not available for the profile.

string

LinkedIn URN of the role’s location, e.g. urn:li:fsd_geo:90009761. Empty when not available for the profile.

string

Length of the role as LinkedIn words it, e.g. 4 yrs 10 mos. Empty when not available for the profile.

array of strings

Role description, one string per paragraph.

string

Location of the role as shown on the profile. Falls back to the profile’s own location when the role shows none.

string

City of the role.

string

State or region of the role.

string

County of the role. Profiles do not show one, so this is empty.

string

Country of the role.

string

Start date as M-YYYY, e.g. 3-2021. A role dated by year only is 0-YYYY. Empty when the role has no date.

string

End date as M-YYYY. Empty for a current role or when the role has no date.

boolean | null

Whether this is a current role. null when the role has neither a start nor an end date, so it is not known.

string

LinkedIn URN that groups the roles held at one company, e.g. urn:li:fsd_profilePositionGroup:(ACoAAA...,fd67192250d4aaf2095f46be4b3b42dd1e363727). Roles with the same value are at the same company. Empty when not available for the profile.

string

The identifier inside position_group_urn. Empty when not available for the profile.

string

The number inside geo_urn, e.g. 90009761. Empty when not available for the profile.

boolean | null

LinkedIn’s own current-role flag. null when not available for the profile.

Education

array of objects

Education entries. Every entry carries all of these keys.

Show education

string

Name of the school.

string

School name exactly as shown on the profile.

string

LinkedIn school ID.

string

LinkedIn school URN.

LinkedIn URL of the school page.

string

School logo URL.

string

School website, when we have company data for it.

string

Industry of the school, when we have company data for it.

string

School size band, when we have company data for it.

string

Followers of the school page, when we have company data for it.

string

Employee count, when we have company data for it.

string

School description, when we have company data for it.

string

Degree, e.g. Bachelor of Science.

array of strings

Fields of study.

string

Grade.

string

Activities and societies.

boolean

true when activities was recovered from the description rather than sent as its own field.

string

Description of the education entry.

object

Start date.

Show started_on

number

Month, 1-12. 0 when unknown.

number

Year. 0 when unknown.

object

End date, or expected end date.

Show ended_on

number

Month, 1-12. 0 when unknown.

number

Year. 0 when unknown.

string

The unsplit original line exactly as it appears on the profile.

string

LinkedIn URN of this education entry, e.g. urn:li:fsd_profileEducation:(ACoAAA...,861262212). Empty when not available for the profile.

boolean | null

LinkedIn’s own current flag for the entry. null when not available for the profile.

string

The skills line LinkedIn shows under the entry, as text, e.g. Optimal Control, Simulink and +3 skills. It is not a complete list. Empty when not available for the profile.

string

LinkedIn ID of the school of the profile’s top education. Empty when not available for the profile.

string

LinkedIn URN of that school, e.g. urn:li:fsd_school:12260. Empty when not available for the profile.

Skills, languages and credentials

array of strings

Skill names.

array of objects

Languages.

Show language

string

Language name.

string

One of ELEMENTARY, LIMITED_WORKING, PROFESSIONAL_WORKING, FULL_PROFESSIONAL, NATIVE_OR_BILINGUAL. Empty when not stated.

array of objects

Licenses and certifications.

Show certification

string

Certification name.

string

Issuing organization.

string

LinkedIn ID of the issuer.

string

LinkedIn URN of the issuer.

string

LinkedIn page of the issuer.

string

Issuer logo URL.

object

Issue date.

Show issued_on

number

Month, 1-12. 0 when unknown.

number

Year. 0 when unknown.

object

Expiry date. 0s when the certification does not expire.

Show expires_on

number

Month, 1-12. 0 when unknown.

number

Year. 0 when unknown.

string

Credential ID.

string

Credential URL.

string

Description.

string

Same as credential_url.

string

Same as issuer.

object

Same date as issued_on; month and year are null when unknown.

Show started_on

null

Always null.

number | null

Month.

number | null

Year.

string

Same as issuer_id.

string

Same as issuer.

string

Same as issuer_logo.

object

Same date as expires_on, with a day.

Show end_date

number

Day. 0 when unknown.

number

Month, 1-12. 0 when unknown.

number

Year. 0 when unknown.

array of objects

Honors and awards.

Show honors_and_awards

string

Title of the honor or award.

string

Issuer.

string

Description.

object

Date issued.

Show issued_on

number

Day. 0 when unknown.

number

Month, 1-12. 0 when unknown.

number

Year. 0 when unknown.

string

LinkedIn URN of this honor, e.g. urn:li:fsd_profileHonor:(ACoAAA...,298568186). Empty when not available for the profile.

string

LinkedIn URN of the role this entry is attached to, matching position_urn on an experience entry. Empty when not available for the profile.

string

LinkedIn URN of the education entry this is attached to, matching education_urn on an education entry. Empty when not available for the profile.

array of objects

Organization memberships.

Show organizations

string

Organization name.

string

Same as title.

string

Position held.

string

Same as subtitle.

string

Description.

object

Start date.

Show start

number

Day. 0 when unknown.

number

Month, 1-12. 0 when unknown.

number

Year. 0 when unknown.

object

End date. 0s when ongoing or unknown.

Show end

number

Day. 0 when unknown.

number

Month, 1-12. 0 when unknown.

number

Year. 0 when unknown.

string

LinkedIn URN of this organization entry, e.g. urn:li:fsd_profileOrganization:(ACoAAA...,894021540). Empty when not available for the profile.

string

LinkedIn URN of the role this entry is attached to, matching position_urn on an experience entry. Empty when not available for the profile.

string

LinkedIn URN of the education entry this is attached to, matching education_urn on an education entry. Empty when not available for the profile.

array of objects

Courses.

Show courses

string

Course name.

string

Course number.

string

LinkedIn URN of this course, e.g. urn:li:fsd_profileCourse:(ACoAAA...,1703125625). Empty when not available for the profile.

string

LinkedIn URN of the role this entry is attached to, matching position_urn on an experience entry. Empty when not available for the profile.

string

LinkedIn URN of the education entry this is attached to, matching education_urn on an education entry. Empty when not available for the profile.

array of objects

Test scores listed on the profile. Empty when none.

Show test_scores

string

Test name.

string

Score as shown, e.g. 113.

object

Date of the test.

Show date

number

Month, 1-12. 0 when unknown.

number

Year. 0 when unknown.

Work outside employment

array of objects

Volunteer experience.

Show volunteering

string

Role.

string

Organization name.

string

Same as organization.

string

LinkedIn company ID.

string

LinkedIn company page.

string

Organization logo URL.

string

Same as company_image.

string

Cause, e.g. HEALTH.

string

Description.

string

Start as M-YYYY. Empty when unknown.

string

End as M-YYYY. Empty when current or unknown.

object

Start date.

Show start_date

number

Year. 0 when unknown.

number

Month. 0 when unknown.

object

End date.

Show end_date

number

Year. 0 when unknown.

number

Month. 0 when unknown.

boolean

true when there is a start date and no end date. An undated entry is false.

object

Length of the entry, to today when it is current.

Show duration

number

Whole years.

number

Remaining months.

string

LinkedIn URN of this volunteer entry, e.g. urn:li:fsd_profileVolunteerExperience:(ACoAAA...,1621785864). Empty when not available for the profile.

array of objects

Publications.

Show publication

string

Title.

string

Publisher.

string

Description.

string

Link to the publication.

string

Date as M/D/YYYY (M//YYYY when the day is unknown). Empty when unknown.

object

The same date as an object.

Show published_on_date

number

Day. 0 when unknown.

number

Month, 1-12. 0 when unknown.

number

Year. 0 when unknown.

string

The same date as text, e.g. Mar 4 2021.

array of objects

Co-authors.

Show authors

string

LinkedIn profile URL.

string

First name.

string

Last name.

string

Profile headline.

string

LinkedIn username (vanity name).

string

LinkedIn profile URN.

string

Profile picture URL.

string

LinkedIn URN of this publication, e.g. urn:li:fsd_profilePublication:(ACoAAA...,1798667697). Empty when not available for the profile.

array of objects

Patents.

Show patents

string

Patent title.

string

Patent number and issue date as LinkedIn shows them.

string

Description.

string

Link to the patent.

string

Patent number.

string

Application number.

string

Patent office.

boolean

true for a pending patent.

object

Filing date.

Show filed_on

number

Day. 0 when unknown.

number

Month, 1-12. 0 when unknown.

number

Year. 0 when unknown.

object

Issue date.

Show issued_on

number

Day. 0 when unknown.

number

Month, 1-12. 0 when unknown.

number

Year. 0 when unknown.

array of objects

Inventors.

Show inventors

string

LinkedIn profile URL.

string

First name.

string

Last name.

string

Profile headline.

string

LinkedIn username (vanity name).

string

LinkedIn profile URN.

string

Profile picture URL.

string

LinkedIn URN of this patent, e.g. urn:li:fsd_profilePatent:(ACoAAA...,377). Empty when not available for the profile.

array of objects

Projects.

Show project

string

Project title.

string

Date line as shown on the profile, e.g. May 2015 - Present.

string

Description.

string

Dates as M-YYYY - M-YYYY.

string

The school or role the project is associated with.

string

Project link.

object

Start date.

Show start

number

Day. 0 when unknown.

number

Month, 1-12. 0 when unknown.

number

Year. 0 when unknown.

object

End date. 0s when ongoing or unknown.

Show end

number

Day. 0 when unknown.

number

Month, 1-12. 0 when unknown.

number

Year. 0 when unknown.

array of objects

Other contributors.

Show contributors

string

LinkedIn profile URL.

string

First name.

string

Last name.

string

Profile headline.

string

LinkedIn username (vanity name).

string

LinkedIn profile URN.

string

Profile picture URL.

string

LinkedIn URN of this project, e.g. urn:li:fsd_profileProject:(ACoAAA...,109). Empty when not available for the profile.

string

LinkedIn URN of the role this entry is attached to, matching position_urn on an experience entry. Empty when not available for the profile.

string

LinkedIn URN of the education entry this is attached to, matching education_urn on an education entry. Empty when not available for the profile.

array of objects

Items pinned to the Featured section. Empty when not available for the profile.

Show featured

string

Kind of item, e.g. post, article, link, media.

string

Title.

string

Description.

string

Link.

string

Image URL.

string

Date text shown on the item, when it has one.

Engagement on the item.

Show social_counts

number | null

Likes. null when not available for the item.

number | null

Comments. null when not available for the item.

array of objects

Counts per reaction type.

Show reaction_counts

string

Reaction type, e.g. LIKE.

number

Count.

Recommendations

array of objects

Recommendations the member received. Empty when not available for the profile.

Show recommendations_received

string | null

Name of the other person: the author of a received recommendation, the recipient of a given one.

string | null

That person’s headline.

string | null

That person’s LinkedIn profile URL.

string | null

That person’s LinkedIn profile URN.

string | null

That person’s picture URL.

string | null

Text of the recommendation.

string | null

Date, e.g. January 14, 2025.

string | null

LinkedIn’s relationship line, e.g. Ryan managed Peter directly.

string | null

When the recommendation was last edited, as an ISO 8601 timestamp, e.g. 2022-12-15T19:26:33.377Z. null when not available for the profile.

array of objects

Recommendations the member gave. Empty when not available for the profile.

Show recommendations_given

string | null

Name of the other person: the author of a received recommendation, the recipient of a given one.

string | null

That person’s headline.

string | null

That person’s LinkedIn profile URL.

string | null

That person’s LinkedIn profile URN.

string | null

That person’s picture URL.

string | null

Text of the recommendation.

string | null

Date, e.g. January 14, 2025.

string | null

LinkedIn’s relationship line, e.g. Ryan managed Peter directly.

string | null

When the recommendation was last edited, as an ISO 8601 timestamp, e.g. 2022-12-15T19:26:33.377Z. null when not available for the profile.

array of objects

Profiles viewers also viewed. Empty when not available for the profile.

Show also_viewed

string

LinkedIn profile URN.

string

First name.

string

Last name.

string

Headline.

string

LinkedIn username.

string

Profile URL.

string

Picture URL.

number | null

Followers. null when not known.

boolean | null

Premium member. null when not known.

boolean | null

Creator. null when not known.

array

Reserved. Always an empty array.

array of objects

The member’s recent posts, Empty when not available for the profile. For posts use the person activity endpoint.

Show updates

string

Post URN.

string

Post URL.

string

Post text.

string

When it was posted.

string

Relative time, e.g. 2w.

boolean

Whether it is a repost.

array

Links found in the post.

number

Likes.

number

Comments.

number

Shares.

array

Counts per reaction type.

array

Images in the post.

string

Video thumbnail URL.

number

Video length in milliseconds.

object

Linked article details.

Enrichment fields

These fields are only present when the matching enrichment flag was set to true on the request. On failure the field contains { "error": "Unable to fetch this data at this time." } instead of data, and no extra credit is charged.

object

Present when company_interest is requested. Companies the profile follows.

Show Company interest object

array of objects

Followed companies.

Show items

number

LinkedIn company ID.

string

Company name.

string

LinkedIn company page URL.

array of objects

Company logo at different sizes. Empty when there is none.

Show logo

string

Image URL.

number

Width in pixels.

number

Height in pixels.

object

Employee headcount range, {} when not available.

number

Total number of followed companies.

number

Total number of pages available.

number

Page returned in this response.

object

Present when top_voices_interest is requested. LinkedIn Top Voices the profile follows. This one is not paginated.

Show Top voices interest object

array of objects | null

Followed Top Voices, or null when the profile follows none.

Show items

string

LinkedIn profile URN (without the urn:li:fsd_profile: prefix).

string

LinkedIn username.

string

LinkedIn profile URL.

string

First name.

string

Last name.

string

Full name.

string

Profile headline.

array of objects

Profile picture at different sizes. Empty when there is none.

Show profile_picture

string

Image URL.

number

Width in pixels.

number

Height in pixels.

object

Present when group_interest is requested. LinkedIn Groups the profile belongs to.

Show Group interest object

array of objects | null

Joined groups, or null when the profile has no group memberships.

Show items

string

LinkedIn group URN, e.g. urn:li:fsd_group:14780171.

string

Group name.

string

LinkedIn group URL.

number

Number of members.

array of objects

Group logo at different sizes. Empty when there is none.

Show logo

string

Image URL.

number

Width in pixels.

number

Height in pixels.

number

Total number of joined groups.

number

Total number of pages available.

number

Page returned in this response.

object

Present when school_interest is requested. Schools the profile follows.

Show School interest object

array of objects | null

Followed schools, or null when the profile follows none.

Show items

number

LinkedIn school ID.

string

School name.

string

LinkedIn school page URL.

number

Number of followers the school page has.

array of objects

School logo at different sizes. Empty when there is none.

Show logo

string

Image URL.

number

Width in pixels.

number

Height in pixels.

number

Total number of followed schools.

number

Total number of pages available.

number

Page returned in this response.

Present when newsletter_interest is requested. LinkedIn Newsletters the profile is subscribed to.

Show Newsletter interest object

array of objects

Subscribed newsletters.

Show items

string

Newsletter name.

string

LinkedIn newsletter URL.

string

Newsletter description.

string

How often it is published, e.g. Published weekly.

array of objects

Newsletter logo at different sizes. Empty when there is none.

Show logo

string

Image URL.

number

Width in pixels.

number

Height in pixels.

object

Who publishes the newsletter. first_name, last_name, username, urn and profile_picture are present when the publisher is a person.

Show publisher

string

Publisher name.

string

LinkedIn URL of the publisher.

string

First name.

string

Last name.

string

LinkedIn username.

string

LinkedIn profile URN (without the urn:li:fsd_profile: prefix).

array of objects

Publisher picture at different sizes.

Show profile_picture

string

Image URL.

number

Width in pixels.

number

Height in pixels.

number

Total number of subscribed newsletters.

number

Total number of pages available.

number

Page returned in this response.

array of objects

Present when similar_profiles is requested. Profiles similar to this one, as a plain list. Every entry carries all six keys; a value that is not available is an empty string. The list is empty when there are no similar profiles.

Show Similar profile item

string

Full name.

string

LinkedIn profile URL.

string

Profile headline.

string

Location, when available.

string

URL of the largest profile picture.

string

LinkedIn profile URN, e.g. urn:li:fsd_profile:ACoAAA....

object

Present when recommendations_data is requested. The recommendations this person gave and received.

Show Recommendations data object

number

Total number of recommendations this person has given. Can be larger than the number of entries returned.

array of objects

Recommendations this person gave.

Show given_recommendation

string

Text of the recommendation.

number

When it was written, in milliseconds since the Unix epoch.

number

When it was last edited, in milliseconds since the Unix epoch.

string

How the two people know each other. One of WORKED_IN_SAME_GROUP, WORKED_IN_DIFFERENT_GROUPS, WORKED_IN_DIFFERENT_COMPANIES, RECOMMENDER_MANAGED_RECOMMENDEE, RECOMMENDER_REPORTED_TO_RECOMMENDEE, RECOMMENDER_SENIOR_THAN_RECOMMENDEE, RECOMMENDEE_SENIOR_THAN_RECOMMENDER, RECOMMENDER_ADVISED_RECOMMENDEE, RECOMMENDER_TAUGHT_RECOMMENDEE, RECOMMENDER_STUDIED_WITH_RECOMMENDEE, RECOMMENDER_IS_CLIENT_OF_RECOMMENDEE, RECOMMENDEE_IS_CLIENT_OF_RECOMMENDER, NONE.

object

The person who received it.

Show recommendee

string

First name of the recommendee (may include a middle name).

string

Last name.

string

Their headline.

string

LinkedIn username.

array of objects

Picture at different sizes. Empty when there is none.

Show profile_pictures

string

Image URL.

number

Width in pixels.

number

Height in pixels.

number

Total number of recommendations this person has received. Can be larger than the number of entries returned.

array of objects

Recommendations this person received.

Show received_recommendation

string

Text of the recommendation.

number

When it was written, in milliseconds since the Unix epoch.

number

When it was last edited, in milliseconds since the Unix epoch.

string

object

The author.

Show recommender

string

First name of the recommender (may include a middle name).

string

Last name.

string

Their headline.

string

LinkedIn username.

array of objects

Picture at different sizes. Empty when there is none.

Show profile_pictures

string

Image URL.

number

Width in pixels.

number

Height in pixels.

People

Company

Jobs

Posts

Signals

ICP Search

Database Search

Utilities

People Profile

People

Person profile endpoint

Required attributes

Optional attributes

Enrichment flags

Enrichment pages

Response

The person model

Properties

Basic information

Headline and summary

Current role

Current company

Location

Contact information

Profile statistics

Profile attributes

Profile media

Personal details

Experience

Education

Skills, languages and credentials

Work outside employment

Recommendations

Enrichment fields

​People

​Person profile endpoint

​Required attributes

​Optional attributes

​Enrichment flags

​Enrichment pages

​Response

​The person model

​Properties

​Basic information

​Headline and summary

​Current role

​Current company

​Location

​Contact information

​Profile statistics

​Profile attributes

​Profile media

​Personal details

​Experience

​Education

​Skills, languages and credentials

​Work outside employment

​Recommendations

​Related profiles and activity

​Enrichment fields

People

Person profile endpoint

Required attributes

Optional attributes

Enrichment flags

Enrichment pages

Response

The person model

Properties

Basic information

Headline and summary

Current role

Current company

Location

Contact information

Profile statistics

Profile attributes

Profile media

Personal details

Experience

Education

Skills, languages and credentials

Work outside employment

Recommendations

Related profiles and activity

Enrichment fields