st.openPersonPage

This action allows you to open a person page to retrieve their basic information and perform additional person-related actions if needed.

Constraints

⏺️ Root Start: allowed, when personUrl parameter is provided.

⬆️ Parent Actions: st.doForPeople, nv.openPersonPage.

⬇️ Child Actions: st.sendMessage, st.syncConversation, nv.syncConversation, st.checkConnectionStatus, st.sendConnectionRequest, st.withdrawConnectionRequest, st.removeConnection, st.retrievePersonExperience, st.retrievePersonEducation, st.retrievePersonSkills, st.endorsePersonSkill, st.retrievePersonLanguages, st.retrievePersonPosts, st.retrievePersonComments, st.retrievePersonReactions, nv.openPersonPage.

Parameters

{
  "actionType": "st.openPersonPage",
  "label": "person1",
  "personUrl": "https://www.linkedin.com/in/person1",
  "basicInfo": true,
  "then": { ... }
}

const workflow = await linkedapi.fetchPerson.execute({
  personUrl: "https://www.linkedin.com/in/person1"
});

const { data, errors } = await linkedapi.fetchPerson.result(workflow.workflowId);

from linkedapi import FetchPersonParams

workflow = linkedapi.fetch_person.execute(
    FetchPersonParams(
        person_url="https://www.linkedin.com/in/person1",
    )
)

result = linkedapi.fetch_person.result(workflow.workflow_id)

linkedin person fetch https://www.linkedin.com/in/person1

In AI assistants, the MCP server runs this action as the fetch_person tool.

const workflow = await linkedapi.fetchPerson.execute({
  personUrl: "https://www.linkedin.com/in/person1",
  retrievePosts: true,
  postsRetrievalConfig: { limit: 50, since: "2026-01-01T00:00:00Z" }
});

from linkedapi import FetchPersonParams

workflow = linkedapi.fetch_person.execute(
    FetchPersonParams(
        person_url="https://www.linkedin.com/in/person1",
        retrieve_posts=True,
        posts_retrieval_config={"limit": 50, "since": "2026-01-01T00:00:00Z"},
    )
)

linkedin person fetch <url> [flags]

• label (optional) – custom label for tracking this action in workflow completion.
• personUrl (required for root start, forbidden for parent start) – public or hashed LinkedIn URL of the person.
• basicInfo (optional, default: false) – when set to true, the action includes basic person information in the results.
• then (optional) – object or array of child actions to be executed within this action.

Result options

1. Successful page opening with basicInfo set to true:

{
  "actionType": "st.openPersonPage",
  "label": "person1",
  "success": true,
  "data": {
    "name": "John Doe",
    "urn": "urn:li:member:123456789",
    "publicUrl": "https://www.linkedin.com/in/person1",
    "hashedUrl": "https://www.linkedin.com/in/SInQBmjJ015eLr8",
    "headline": "Software Engineer at TechCorp",
    "location": "San Francisco, USA",
    "countryCode": "US",
    "position": "Software Engineer",
    "about": "Software Engineer with 8+ years of experience building scalable web applications.",
    "companyName": "TechCorp",
    "companyHashedUrl": "https://www.linkedin.com/company/12345678",
    "followersCount": 37,
    "avatarUrl": "https://media.licdn.com/dms/image/v2/D5603AQE/profile-displayphoto-shrink_100_100/0/1700000000000",
    "viewerState": { "connectionDegree": "2nd" },
    "then": { ... }
  }
}

• label – included only if specified in the action parameters.
• data – basic information about the person and results of child actions execution.
  • name – full name of the person.
  • urn – URN of the person, or null if LinkedIn does not expose it.
  • publicUrl – public LinkedIn URL of the person.
  • hashedUrl – hashed LinkedIn URL of the person.
  • headline – headline of the person.
  • location – free-form string indicating the person's location.
  • countryCode – two-character code of the person's country.
  • position – current job position of the person.
  • about – "About" section text from the person's profile.
  • companyName – name of the person's current company.
  • companyHashedUrl – hashed LinkedIn URL of the person's current company.
  • followersCount – number of followers the person has.
  • avatarUrl – URL of the person's profile photo, or null if the person has no photo.
  • viewerState – how your account relates to the person, see viewer state.
    • connectionDegree – 1st, 2nd, or 3rd+, as LinkedIn shows it next to the name, or null if LinkedIn does not show it.
  • then – results of child actions execution.

2. Successful page opening with basicInfo set to false:

{
  "actionType": "st.openPersonPage",
  "label": "person1",
  "success": true,
  "data": {
    "then": { ... }
  }
}

• label – included only if specified in the action parameters.
• data.then – results of child actions execution.

3. Failed page opening:

{
  "actionType": "st.openPersonPage",
  "label": "person1",
  "success": false,
  "error": {
    "type": "personNotFound",
    "message": "The provided URL is not an existing LinkedIn person."
  }
}

• label – included only if specified in the action parameters.
• error.type – enum with the following possible values:
  • personNotFound – provided URL is not an existing LinkedIn person.
  • personLikelyChangedPublicUrl – the provided URL no longer opens, but this person appeared in your account's network events before, so they most likely changed their public URL. Retry with their hashed URL.
  • selfProfileNotAllowed – action cannot be performed on your own profile.