endorsePersonSkills

This method allows you to endorse every skill of a person whose name matches the patterns you specify, or all of their skills.

LinkedIn lets you endorse skills only of your 1st-degree connections. For anyone else, every selected skill gets connectionNotFound and nothing is endorsed.

The method never removes an endorsement. A skill you have already endorsed is left as it is and reported as a success.

To endorse one skill by its exact name, use endorsePersonSkill.

typescript

try {
  const workflow = await linkedapi.endorsePersonSkills.execute({
    personUrl: "https://www.linkedin.com/in/person1",
    skillNamePatterns: ["business", "project\\s*manage", "^(agile|scrum)$"]
  });

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

  // The list of possible execution errors is below
  if (errors && errors.length > 0) {
    console.warn('Workflow completed with execution errors:');
    errors.forEach(error => {
      console.warn(` - Type: ${error.type}, Message: ${error.message}`);
    });
  }

  // The structure of the 'data' object is below
  if (data) {
    data.forEach(endorsement => {
      if (endorsement.success) {
        console.log(`Endorsed: ${endorsement.skillName}`);
      } else if (endorsement.error) {
        console.warn(`Not endorsed: ${endorsement.skillName} - ${endorsement.error.type}`);
      }
    });
  }
} catch (e) {
  // A list of all critical errors can be found here:
  // https://linkedapi.io/sdks/handling-results-and-errors/#handling-critical-errors
  if (e instanceof LinkedApiError) {
    console.error(`Critical Error - Type: ${e.type}, Message: ${e.message}`);
  } else {
    console.error('An unexpected, non-API error occurred:', e);
  }
}

python

from linkedapi import EndorsePersonSkillsParams, LinkedApiError

try:
    workflow = linkedapi.endorse_person_skills.execute(
        EndorsePersonSkillsParams(
            person_url="https://www.linkedin.com/in/person1",
            skill_name_patterns=["business", "project\\s*manage", "^(agile|scrum)$"],
        )
    )

    result = linkedapi.endorse_person_skills.result(workflow.workflow_id)
    data = result.data
    errors = result.errors

    # The list of possible execution errors is below
    if errors:
        print("Workflow completed with execution errors:")
        for error in errors:
            print(f" - Type: {error.type}, Message: {error.message}")

    # The structure of the 'data' object is below
    if data:
        for endorsement in data:
            if endorsement.success:
                print(f"Endorsed: {endorsement.skill_name}")
            elif endorsement.error:
                print(f"Not endorsed: {endorsement.skill_name} - {endorsement.error.type}")
except LinkedApiError as e:
    # A list of all critical errors can be found here:
    # https://linkedapi.io/sdks/handling-results-and-errors/#handling-critical-errors
    print(f"Critical Error - Type: {e.type}, Message: {e.message}")
except Exception as error:
    print("An unexpected, non-API error occurred:", error)

Params

personUrl – public or hashed LinkedIn URL of the person whose skills you want to endorse.
skillNamePatterns (optional) – array of regular expressions that select skills by name. A skill is selected when any of the patterns matches its name. If omitted, every skill of the person is endorsed.
- The syntax is RE2, the dialect of Go regexp and Google Sheets REGEXMATCH. Ordinary patterns read like JavaScript or Python regular expressions, but lookaround ((?=…), (?!…), (?<=…), (?<!…)) and backreferences (\1) are not supported.
- Matching is case-insensitive and searches anywhere in the name: manage matches Project Management. To require the whole name to match, anchor the pattern with ^…$: ^scrum$ matches Scrum but not Scrum Master.
- In an ordinary string literal each backslash is written twice: "project\\s*manage" is the regular expression project\s*manage.
- Skill names are shown as the profile owner entered them, in the owner's language, whatever your own LinkedIn language. Write patterns in the language of the profiles you target, or cover several languages in one pattern, such as "proje[ck]t\\s*management".
- The array holds 1 to 20 patterns, each 1 to 200 characters long. To endorse every skill, omit the parameter rather than passing an empty array. An empty array, an invalid pattern, or patterns over the matching-cost budget throw the critical error invalidWorkflow before the workflow starts. See st.doForSkills for the full rules.

Data

Array of the skills the patterns selected, in the order they appear on the person's profile. Skills that no pattern matched are not included; if none matched, the array is empty. Each item contains:

skillName – name of the skill, as the profile owner entered it.
success – whether the skill is endorsed. A skill you had already endorsed is reported as a success.
error – object with the type and message of the reason the skill was not endorsed. Returned only when success is false. type is one of:
- connectionNotFound – person is not your 1st-degree connection, so LinkedIn doesn't let you endorse their skills. Every selected skill gets this error.
- endorsementUnavailable – LinkedIn offers no way to endorse this skill, for example because the person turned endorsements off.
- limitExceeded – the account has reached its stEndorsements limit, so the skill was not endorsed. The limit is checked before each selected skill: once it is reached, skills get this error until earlier endorsements fall outside the limit period, so a later skill can still succeed. Check success on every item.
- unexpectedError – the endorsement could not be completed or confirmed.

Selected skills are endorsed one at a time. A failed endorsement does not stop the others, and is reported only on its own item, not in errors.

Errors

These errors mean the person's skills could not be read. The method then returns no data.

personNotFound – provided URL is not an existing LinkedIn person.
personLikelyChangedPublicUrl – 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.
limitExceeded – the account has reached its stPersonProfileViews limit, so the profile was not opened.

Opening the profile counts toward stPersonProfileViews, and each successful endorsement counts toward stEndorsements.

See Endorsing skills for the workflow this method runs and its completion.

PreviousendorsePersonSkill NextretrieveSSI