Extract LinkedIn People

Run linkedin-extract-people action live

curl --request POST \
  --url https://api.edges.run/v1/actions/linkedin-extract-people/run/live \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "input": {
    "linkedin_profile_url": "<string>",
    "custom_data": {}
  },
  "parameters": {},
  "identity_ids": [
    "44444444-4444-4444-4444-444444444444"
  ],
  "identity_mode": "direct"
}
'

const options = {
  method: 'POST',
  headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    input: {linkedin_profile_url: '<string>', custom_data: {}},
    parameters: {},
    identity_ids: ['44444444-4444-4444-4444-444444444444'],
    identity_mode: 'direct'
  })
};

fetch('https://api.edges.run/v1/actions/linkedin-extract-people/run/live', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.edges.run/v1/actions/linkedin-extract-people/run/live"

payload = {
    "input": {
        "linkedin_profile_url": "<string>",
        "custom_data": {}
    },
    "parameters": {},
    "identity_ids": ["44444444-4444-4444-4444-444444444444"],
    "identity_mode": "direct"
}
headers = {
    "X-API-Key": "<api-key>",
    "Content-Type": "application/json"
}

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

print(response.text)

{
  "linkedin_profile_handle": "<string>",
  "first_name": "<string>",
  "last_name": "<string>",
  "full_name": "<string>",
  "birth_date": "<string>",
  "headline": "<string>",
  "summary": "<string>",
  "languages": [
    "<string>"
  ],
  "skills": [
    {
      "name": "<string>"
    }
  ],
  "has_more_skills": true,
  "sales_navigator_profile_id": "<string>",
  "linkedin_profile_id": 123,
  "linkedin_profile_url": "<string>",
  "profile_country": "<string>",
  "profile_language": "<string>",
  "location": "<string>",
  "profile_image_url": "<string>",
  "job_title": "<string>",
  "education": [
    {
      "title": "<string>",
      "school_name": "<string>",
      "school_description": "<string>",
      "linkedin_school_url": "<string>",
      "date": "<string>",
      "linkedin_school_id": 123,
      "degree_name": "<string>",
      "field_of_study": "<string>",
      "company_logo_url": "<string>"
    }
  ],
  "school_name": "<string>",
  "linkedin_school_url": "<string>",
  "volunteer_experiences": [
    {}
  ],
  "number_connections": 123,
  "experiences": [
    {
      "title": "<string>",
      "company_name": "<string>",
      "company_description": "<string>",
      "linkedin_company_url": "<string>",
      "location": "<string>",
      "linkedin_company_id": 123,
      "date": "<string>",
      "job_time_period": "<string>",
      "job_contract_type": "<string>",
      "company_logo_url": "<string>"
    }
  ],
  "has_more_experiences": true,
  "company_name": "<string>",
  "linkedin_company_url": "<string>",
  "linkedin_company_id": 123,
  "number_followers": 123,
  "linkedin_people_post_search_url": "<string>",
  "connection_degree": "<string>",
  "open_to_work": true,
  "linkedin_thread_id": "<string>",
  "past_company_name": "<string>",
  "past_job_title": "<string>",
  "past_sales_navigator_company_id": "<string>",
  "past_linkedin_company_id": 123,
  "past_linkedin_company_url": "<string>",
  "connected_at": "2023-11-07T05:31:56Z",
  "number_shared_connections": 123
}

POST

actions

linkedin-extract-people

run

live

Run linkedin-extract-people action live

curl --request POST \
  --url https://api.edges.run/v1/actions/linkedin-extract-people/run/live \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "input": {
    "linkedin_profile_url": "<string>",
    "custom_data": {}
  },
  "parameters": {},
  "identity_ids": [
    "44444444-4444-4444-4444-444444444444"
  ],
  "identity_mode": "direct"
}
'

const options = {
  method: 'POST',
  headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    input: {linkedin_profile_url: '<string>', custom_data: {}},
    parameters: {},
    identity_ids: ['44444444-4444-4444-4444-444444444444'],
    identity_mode: 'direct'
  })
};

fetch('https://api.edges.run/v1/actions/linkedin-extract-people/run/live', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.edges.run/v1/actions/linkedin-extract-people/run/live"

payload = {
    "input": {
        "linkedin_profile_url": "<string>",
        "custom_data": {}
    },
    "parameters": {},
    "identity_ids": ["44444444-4444-4444-4444-444444444444"],
    "identity_mode": "direct"
}
headers = {
    "X-API-Key": "<api-key>",
    "Content-Type": "application/json"
}

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

print(response.text)

{
  "linkedin_profile_handle": "<string>",
  "first_name": "<string>",
  "last_name": "<string>",
  "full_name": "<string>",
  "birth_date": "<string>",
  "headline": "<string>",
  "summary": "<string>",
  "languages": [
    "<string>"
  ],
  "skills": [
    {
      "name": "<string>"
    }
  ],
  "has_more_skills": true,
  "sales_navigator_profile_id": "<string>",
  "linkedin_profile_id": 123,
  "linkedin_profile_url": "<string>",
  "profile_country": "<string>",
  "profile_language": "<string>",
  "location": "<string>",
  "profile_image_url": "<string>",
  "job_title": "<string>",
  "education": [
    {
      "title": "<string>",
      "school_name": "<string>",
      "school_description": "<string>",
      "linkedin_school_url": "<string>",
      "date": "<string>",
      "linkedin_school_id": 123,
      "degree_name": "<string>",
      "field_of_study": "<string>",
      "company_logo_url": "<string>"
    }
  ],
  "school_name": "<string>",
  "linkedin_school_url": "<string>",
  "volunteer_experiences": [
    {}
  ],
  "number_connections": 123,
  "experiences": [
    {
      "title": "<string>",
      "company_name": "<string>",
      "company_description": "<string>",
      "linkedin_company_url": "<string>",
      "location": "<string>",
      "linkedin_company_id": 123,
      "date": "<string>",
      "job_time_period": "<string>",
      "job_contract_type": "<string>",
      "company_logo_url": "<string>"
    }
  ],
  "has_more_experiences": true,
  "company_name": "<string>",
  "linkedin_company_url": "<string>",
  "linkedin_company_id": 123,
  "number_followers": 123,
  "linkedin_people_post_search_url": "<string>",
  "connection_degree": "<string>",
  "open_to_work": true,
  "linkedin_thread_id": "<string>",
  "past_company_name": "<string>",
  "past_job_title": "<string>",
  "past_sales_navigator_company_id": "<string>",
  "past_linkedin_company_id": 123,
  "past_linkedin_company_url": "<string>",
  "connected_at": "2023-11-07T05:31:56Z",
  "number_shared_connections": 123
}

1 credit per result · credit_ratio 1 · Credit costs Profile enrichments 1,400–2,100 / 24 h · Action limits

Agent skill

edges-linkedin-extract-people — ready-made instructions for coding agents calling this endpoint.

To run LinkedIn actions, you must first create an identity and connect a LinkedIn account, either using our Chrome Extension, username/password login, or Managed Accounts to run without connecting an account.

Fields deprecated — The following output fields may be omitted or null:

birth_date
linkedin_thread_id
connected_at

Experiences parameter

When enabled, returns the first 5 companies’ experiences (count varies by profile). The top-level field has_more_experiences is true when LinkedIn has more experiences than this list. Use it to decide whether to call linkedin-extract-people-experiences. The field is omitted when experiences were not requested.

Field	Description
`date`	Employment date ranges only — e.g. `Sep 2024 - Present`, `Sep 2005 - Aug 2008`
`title`	Job title
`company_name`	Company name

Skills parameter

When enabled, returns one or two skills (varies by profile). The top-level field has_more_skills is true when LinkedIn has more skills than this list. Use it to decide whether to call linkedin-extract-people-skills. The field is omitted when skills were not requested.

Sections parameter

When enabled, returns optional profile sections:education · languages · volunteer_experiences · summary · company_name · job_title · linkedin_company_urlEducation fields (when education is included):

Field	Description
`title`	`degreeName` + `fieldOfStudy` (e.g. `Bachelor of Science, Computer Science`)
`degree_name`	First part of `title` when comma-separated; otherwise empty
`field_of_study`	Second part of `title` when comma-separated; otherwise empty

Highlights parameter

When enabled, returns:linkedin_company_url · connection_degree · number_followers · number_connections

Trigger further enrichment with has_more_* — has_more_experiences and has_more_skills tell you whether the arrays in this response are partial. Use them to skip unnecessary linkedin-extract-people-experiences and linkedin-extract-people-skills calls (and the LinkedIn rate-limit cost that comes with them).Treat true as a signal that additional records may be available — the value can vary by LinkedIn response source. Do not assume the returned arrays are complete when the field is true, especially if the data is not from a fresh extraction.

profile_country — Inferred from recent experience locations when LinkedIn does not expose it directly. Remote and hybrid locations are excluded.

Authorizations

X-API-Key

string

header

required

Body

application/json

input

object

required

Show child attributes

parameters

object

Show child attributes

identity_ids

string<uuid>[] | null

An array of Identity UUIDs linked to identities (e.g. LinkedIn) used to execute the Action. You must provide at least one valid UID with access to the integration. Do not use account_uid values — only user_uid is supported.

Example:

["44444444-4444-4444-4444-444444444444"]

identity_mode

enum<string> | null

default:direct

If "auto", the Action will use any identities from the current workspace (unless you have provided a list of identity_ids). "managed" will use the Edges pool of identities for an extra credit cost

Available options:

direct,

auto,

managed

Response

Successful response

linkedin_profile_handle

string

first_name

string

last_name

string

full_name

string

birth_date

string

headline

string

summary

string

languages

string[]

skills

object[]

A partial list of skills: includes only a selection of the user's main competencies, not the full set.

Show child attributes

has_more_skills

boolean

True when the profile has more skills registered on LinkedIn than returned.

sales_navigator_profile_id

string

linkedin_profile_id

integer

linkedin_profile_url

string<uri>

profile_country

string

profile_language

string

location

string

profile_image_url

string<uri>

job_title

string

education

object[]

Show child attributes

school_name

string

linkedin_school_url

string<uri>

volunteer_experiences

object[]

number_connections

number

experiences

object[]

A partial list of professional experiences: includes only the user's most recent experiences.

Show child attributes

has_more_experiences

boolean

True when the profile has more experiences registered on LinkedIn than returned.

company_name

string

linkedin_company_url

string<uri>

linkedin_company_id

integer

number_followers

number

linkedin_people_post_search_url

string<uri>

connection_degree

string

open_to_work

boolean

linkedin_thread_id

string

past_company_name

string

past_job_title

string

past_sales_navigator_company_id

string

past_linkedin_company_id

integer

past_linkedin_company_url

string<uri>

connected_at

string<date-time>

number_shared_connections

integer

API Documentation

Business API

LinkedIn API

Sales Navigator API

Extract LinkedIn People

Agent skill

Authorizations

Body

Response