Skip to main content
GET
Get the members who endorsed a skill

Endpoint

Authentication

Include your API key in the request header:

How it works

Each skill on Get Profile and Get Profile Skills carries a skillUrn:
This endpoint returns every member who endorsed that skill, not only the few a profile displays: one page of up to 100 per call. Each endorser comes with their public identifier and profile URL, so you can trace them back to a profile with Get Profile.

Parameters

string
required
The professional profile the skill belongs to. Accepts any of:
  • Profile URN. Example: urn:li:fsd_profile:ACoAAAAteRwB-gns09UDa-RYj02ngoedsj7C9QM
  • Public identifier (slug). Example: billcorbettauthor
  • Profile URL. Example: https://www.linkedin.com/in/billcorbettauthor (a trailing slash makes no difference)
Member profiles only: a company page URL or URN is rejected with a 400 error, free of charge.
string
required
The skill, exactly as Get Profile returns it in skills[].skillUrn. Example: urn:li:fsd_skill:(ACoAAAAteRwB-gns09UDa-RYj02ngoedsj7C9QM,25)It must belong to profileUrlOrUrn. A value that is not a skill URN (a skill name, for instance), or a skill of another member when profileUrlOrUrn is a URN, is rejected with a free 400 INVALID_PARAMETER, before anything is fetched.
integer
default:"100"
Number of endorsers per page.
  • Minimum: 1 — 0 or a negative value is rejected with 400
  • Maximum: 100 — a higher value is clamped, not rejected
  • Default: 100, the most a page holds. A call costs the same whatever the count.
integer
default:"0"
Offset of the first endorser to return. Pass 0 (or omit it) for the first page, then the nextStart the previous response gave you. See Pagination.
  • Minimum: 0 — a negative value is rejected with 400
  • Maximum: 100,000 — a higher value is capped, not rejected

Response

array
The members who endorsed the skill, in the order the source lists them. Empty when nobody did, or when start is past the end of the list.
boolean
true when the source has more endorsers after this page. false on the last page.
integer
The start value to request next. Present only when hasMore is true.

Example Request

Example Response

Errors

See Error Handling for the full list of error codes and recommended handling.
  • 400 — MISSING_PARAMETER / INVALID_PARAMETER / INVALID_URN
  • 401 — INVALID_API_KEY
  • 402 — QUOTA_EXHAUSTED
  • 404 — PROFILE_NOT_FOUND
  • 429 — RATE_LIMITED
  • 500 — INTERNAL_ERROR
  • 503 — SERVICE_UNAVAILABLE. The page could not be fetched on this call: retry. A failed page is never returned as an empty list.

Pagination

The list is paged by offset, up to 100 endorsers per page.
  1. Request the first page with start=0 (or omit start).
  2. If hasMore is true, request the next page with the nextStart the response gave you.
  3. Continue until hasMore is false.

Notes

This endpoint consumes 1 credit per call, whatever the count. A skill with 250 endorsers takes three calls. Errors are free — with one exception: a 404 not found costs 1 credit. See Quotas.
Get Profile Skills tells you how many endorsers each skill has, so you can skip the skills nobody endorsed and know in advance how many pages each one needs.
The source shows the endorsements a member has received, skill by skill. It does not show the endorsements a member gave to others, nor when an endorsement was given, so neither is available.

Authorizations

X-API-Key
string
header
required

Query Parameters

profileUrlOrUrn
string
required

The professional profile. Accepts a profile URN (example urn:li:fsd_profile:ACoAAAAteRwB-gns09UDa-RYj02ngoedsj7C9QM), a public identifier/slug (example billcorbettauthor), or a full profile URL (example https://www.linkedin.com/in/billcorbettauthor; a trailing slash is ignored). Member profiles only: a company page URL or URN is rejected with a 400 error, free of charge.

Example:

"billcorbettauthor"

skillUrn
string
required

The skill, exactly as GET /api/v1/profile returns it in skills[].skillUrn. It must belong to profileUrlOrUrn. A value that is not a skill URN (a skill name, for instance), or a skill of another member when profileUrlOrUrn is a URN, returns 400 INVALID_PARAMETER at no cost, before anything is fetched.

Example:

"urn:li:fsd_skill:(ACoAAAAteRwB-gns09UDa-RYj02ngoedsj7C9QM,25)"

count
integer
default:100

Number of entries per page (default: 100, the most a page holds). A value above 100 is clamped to 100, not rejected. A call costs the same whatever the count.

Required range: 1 <= x <= 100
start
integer
default:0

Offset of the first entry to return. Pass 0 (or omit) for the first page, then the nextStart of the previous response. Keep paging while hasMore is true.

Required range: x >= 0

Response

Successfully fetched the endorsers

endorsers
object[]

The members who endorsed the skill, in the order the source lists them. Empty when nobody did, or when start is past the end of the list.

hasMore
boolean

True when the source has more entries after this page, false on the last page.

nextStart
integer

The start value to request next. Present only when hasMore is true.

Example:

100