Skip to main content
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>" } ], "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>" } ], "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 }
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 for a hassle-free setup.
Fields deprecated — The following output fields may be omitted or null:
  • birth_date
  • linkedin_thread_id
  • connected_at
When enabled, returns the first 5 companies’ experiences (count varies by profile). For full work history, use linkedin-extract-people-experiences.
FieldDescription
dateEmployment date ranges only — e.g. Sep 2024 - Present, Sep 2005 - Aug 2008
titleJob title
company_nameCompany name
When enabled, returns one or two skills (varies by profile). For full skills list, use linkedin-extract-people-skills.
When enabled, returns optional profile sections:education · languages · volunteer_experiences · summary · company_name · job_title · linkedin_company_urlEducation fields (when education is included):
FieldDescription
titledegreeName + fieldOfStudy (e.g. Bachelor of Science, Computer Science)
degree_nameFirst part of title when comma-separated; otherwise empty
field_of_studySecond part of title when comma-separated; otherwise empty
When enabled, returns:linkedin_company_url · connection_degree · number_followers · number_connections
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
​
parameters
object
​
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.

​
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[]
​
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.

​
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