Get Profile Skills by username

GEThttps://api.envoapi.com/v1/profiles/skills/by-username

Retrieve a profile's skills by username, including endorsement counts, insight summaries and links to endorsers or related experience. Capped counts such as 99+ retain their original text and have no exact numeric count.

Authorization headerReturns application/json

GET/v1/profiles/skills/by-username

curl "https://api.envoapi.com/v1/profiles/skills/by-username?username=cassidoo&start=0" \--header "Authorization: Bearer $ENVO_API_KEY" \--header "Accept: application/json"

const response = await fetch("https://api.envoapi.com/v1/profiles/skills/by-username?username=cassidoo&start=0",{headers: {Authorization: `Bearer ${process.env.ENVO_API_KEY}`,Accept: "application/json",},},);const body = await response.json();

import osimport requestsresponse = requests.get("https://api.envoapi.com/v1/profiles/skills/by-username",params={"username": "cassidoo", "start": "0"},headers={"Authorization": f"Bearer {os.environ['ENVO_API_KEY']}","Accept": "application/json",},)body = response.json()

application/json · 3.2 KB

A page of profile skills. Use meta.paging.nextStart as start for the next page.

{"data": {1 field},"skills": [10 items]{6 fields},"name": "JavaScript","endorsementCount": null,"endorsementCountText": "99+ endorsements","insights": [2 items],"Endorsed by Brexton Pham and 13 others who are highly skilled at this","Endorsed by 6 colleagues at Amazon"],"endorsementsUrl": "https://api.envoapi.com/v1/profiles/skills/actions/v1.example.opaque","skillInsightsUrl": null},{6 fields},"name": "CSS","endorsementCount": null,"endorsementCountText": "99+ endorsements","insights": [2 items],"Endorsed by Camryn Williams and 8 others who are highly skilled at this","Endorsed by 5 colleagues at Amazon"],"endorsementsUrl": "https://api.envoapi.com/v1/profiles/skills/actions/v1.example.opaque","skillInsightsUrl": null},{6 fields},"name": "HTML","endorsementCount": 93,"endorsementCountText": "93 endorsements","insights": [2 items],"Endorsed by Brexton Pham and 15 others who are highly skilled at this","Endorsed by 5 colleagues at Amazon"],"endorsementsUrl": "https://api.envoapi.com/v1/profiles/skills/actions/v1.example.opaque","skillInsightsUrl": null},{6 fields},"name": "Java","endorsementCount": 83,"endorsementCountText": "83 endorsements","insights": [2 items],"Endorsed by Brexton Pham and 13 others who are highly skilled at this","Endorsed by 7 colleagues at Amazon"],"endorsementsUrl": "https://api.envoapi.com/v1/profiles/skills/actions/v1.example.opaque","skillInsightsUrl": null},{6 fields},"name": "Python","endorsementCount": 51,"endorsementCountText": "51 endorsements","insights": [2 items],"Endorsed by Brexton Pham and 5 others who are highly skilled at this","Endorsed by 3 colleagues at Amazon"],"endorsementsUrl": "https://api.envoapi.com/v1/profiles/skills/actions/v1.example.opaque","skillInsightsUrl": null},{6 fields},"name": "Public Speaking","endorsementCount": 51,"endorsementCountText": "51 endorsements","insights": [2 items],"Endorsed by 🌎 Luiza Dreasher, Ph.D. and 3 others who are highly skilled at this","Endorsed by 4 colleagues at Amazon"],"endorsementsUrl": "https://api.envoapi.com/v1/profiles/skills/actions/v1.example.opaque","skillInsightsUrl": null},{6 fields},"name": "jQuery","endorsementCount": 55,"endorsementCountText": "55 endorsements","insights": [2 items],"Endorsed by Brexton Pham and 1 other who is highly skilled at this","Endorsed by 4 colleagues at Amazon"],"endorsementsUrl": "https://api.envoapi.com/v1/profiles/skills/actions/v1.example.opaque","skillInsightsUrl": null},{6 fields},"name": "HTML 5","endorsementCount": 46,"endorsementCountText": "46 endorsements","insights": [2 items],"Endorsed by Camryn Williams who is highly skilled at this","Endorsed by 6 colleagues at Amazon"],"endorsementsUrl": "https://api.envoapi.com/v1/profiles/skills/actions/v1.example.opaque","skillInsightsUrl": null},{6 fields},"name": "Photoshop","endorsementCount": 42,"endorsementCountText": "42 endorsements","insights": [1 item],"Endorsed by 4 colleagues at Amazon"],"endorsementsUrl": "https://api.envoapi.com/v1/profiles/skills/actions/v1.example.opaque","skillInsightsUrl": null},{6 fields}"name": "Web Development","endorsementCount": 47,"endorsementCountText": "47 endorsements","insights": [2 items],"Endorsed by Misbah Ashraf and 3 others who are highly skilled at this","Endorsed by 3 colleagues at Amazon"],"endorsementsUrl": "https://api.envoapi.com/v1/profiles/skills/actions/v1.example.opaque","skillInsightsUrl": null}]},"meta": {2 fields}"creditCost": 1,"paging": {5 fields}"start": 0,"count": 10,"returned": 10,"hasMore": true,"nextStart": 10}}}

invalid_requestA parameter is missing or has a value we cannot use. Read error.details, fix the value and try again. Errors guide →

{"error": {4 fields},"code": "invalid_request","message": "A request parameter is missing or invalid.","retryable": false,"details": []},"meta": {1 field}"requestId": "example"}}

invalid_api_keyYour API key is missing, wrong or switched off. Check it in your dashboard. Errors guide →

{"error": {4 fields},"code": "invalid_api_key","message": "Your API key is invalid or inactive.","retryable": false,"details": []},"meta": {1 field}"requestId": "example"}}

insufficient_creditsYour account has no credits left. Top up, then send a new call. Errors guide →

{"error": {4 fields},"code": "insufficient_credits","message": "Your account does not have enough credits.","retryable": false,"details": []},"meta": {1 field}"requestId": "example"}}

resource_not_foundNothing matched what you sent. Check it for typos. Errors guide →

{"error": {4 fields},"code": "resource_not_found","message": "The requested resource was not found.","retryable": false,"details": []},"meta": {1 field}"requestId": "example"}}

rate_limit_exceededToo many calls in a short time. Honor Retry-After; use bounded retries with backoff and jitter. Errors guide →

{"error": {4 fields},"code": "rate_limit_exceeded","message": "Your account has sent too many requests.","retryable": true,"details": []},"meta": {1 field}"requestId": "example"}}

GET

/v1/profiles/skills/by-username

Authorizations

BearerApiKey

Parameters

Query Parameters

username

required

string

>= 1 characters <= 100 characters /^[\p{L}\p{N}][\p{L}\p{M}\p{N}_-]{0,99}$/

The username from the profile URL: the path segment after /in/.

Example

cassidoo

start

integer

0 <= 10000

Example

Responses

200

A page of profile skills. Use meta.paging.nextStart as start for the next page.

application/json

object

data

required

object

skills

required

Array<object>

<= 200 items

object

name

required

string

endorsementCount

required

Any of:

integer
null

integer

<= 9007199254740991

endorsementCountText

required

Any of:

string
null

string

>= 1 characters

insights

required

All available endorsement and related experience summaries.

Array<string>

endorsementsUrl

required

Any of:

string
null

Opaque EnvoAPI link. Opening it redirects to LinkedIn, which may require sign-in. Links remain valid until the issuing key is rotated.

string

<= 2110 characters /^https:\/\/api\.envoapi\.com\/v1\/profiles\/skills\/actions\/v1\.[A-Za-z0-9_-]{1,32}\.[A-Za-z0-9_-]+$/

skillInsightsUrl

required

Any of:

string
null

Opaque EnvoAPI link. Opening it redirects to LinkedIn, which may require sign-in. Links remain valid until the issuing key is rotated.

string

<= 2110 characters /^https:\/\/api\.envoapi\.com\/v1\/profiles\/skills\/actions\/v1\.[A-Za-z0-9_-]{1,32}\.[A-Za-z0-9_-]+$/

meta

required

object

creditCost

required

integer

<= 9007199254740991

paging

Page details. May be missing from older results.

object

start

required

integer

<= 10000

count

required

integer

>= 1 <= 10

returned

required

integer

<= 10

hasMore

required

boolean

nextStart

required

Any of:

integer
null

integer

>= 1 <= 10000

Headers

Date

string

/^(?:Mon|Tue|Wed|Thu|Fri|Sat|Sun), (?:0[1-9]|[12][0-9]|3[01]) (?:Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec) [0-9]{4} (?:[01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9] GMT$/

Required response header.

Cache-Control

string

Allowed value: private, no-store

Required response header.

X-Request-Id

string

>= 1 characters <= 64 characters /^[\x21-\x7e](?:[\x20-\x7e]*[\x21-\x7e])?$/

Required response header.

X-Credits-Remaining

integer

<= 9007199254740991

Required response header.

X-RateLimit-Limit

integer

<= 9007199254740991

Required response header.

X-RateLimit-Remaining

integer

<= 9007199254740991

Required response header.

X-RateLimit-Reset

integer

<= 9007199254740991

Required response header.

Errors

Every error returns the same body. The status and error.code tell you what went wrong. The Errors guide covers handling and retries.

Body

application/json

object

error

required

object

code

required

string

Allowed values: invalid_request invalid_api_key insufficient_credits insufficient_scope account_suspended resource_not_found method_not_allowed not_acceptable unsupported_media_type rate_limit_exceeded internal_error response_too_large upstream_error service_unavailable upstream_timeout

message

required

string

>= 1 characters <= 512 characters

retryable

required

boolean

details

required

Array<object>

<= 16 items

object

field

required

string

>= 1 characters <= 128 characters /^[\x21-\x7e](?:[\x20-\x7e]*[\x21-\x7e])?$/

code

required

string

Allowed values: identifier_count unknown_parameter repeated_parameter invalid_format invalid_value too_long

message

required

string

>= 1 characters <= 512 characters

meta

required

object

requestId

required

string

>= 1 characters <= 64 characters /^[\x21-\x7e](?:[\x20-\x7e]*[\x21-\x7e])?$/

Headers

Date

string

/^(?:Mon|Tue|Wed|Thu|Fri|Sat|Sun), (?:0[1-9]|[12][0-9]|3[01]) (?:Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec) [0-9]{4} (?:[01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9] GMT$/

Required response header.

Cache-Control

string

Allowed value: private, no-store

Required response header.

X-Request-Id

string

>= 1 characters <= 64 characters /^[\x21-\x7e](?:[\x20-\x7e]*[\x21-\x7e])?$/

Required response header.

Status	`error.code`	Meaning
400	`invalid_request`	A parameter is missing or has a value we cannot use. Read error.details, fix the value and try again.
401	`invalid_api_key`	Your API key is missing, wrong or switched off. Check it in your dashboard.
402	`insufficient_credits`	Your account has no credits left. Top up, then send a new call. Also sends `X-Credits-Remaining`, `X-RateLimit-Limit`, `X-RateLimit-Remaining`, `X-RateLimit-Reset`.
403	`insufficient_scope`, `account_suspended`	Your account is suspended or cannot use this endpoint. Resolve the account or its access first.
404	`resource_not_found`	Nothing matched what you sent. Check it for typos. Also sends `X-Credits-Remaining`, `X-RateLimit-Limit`, `X-RateLimit-Remaining`, `X-RateLimit-Reset`.
405	`method_not_allowed`	The route exists, but the request used a method other than GET. Use the method shown at the top of this page. Also sends `Allow`.
406	`not_acceptable`	The Accept header asks for a format we do not send. Ask for JSON with a supported Accept value.
415	`unsupported_media_type`	The request declared a media type we do not accept. Remove the body or use the documented media type.
429	`rate_limit_exceeded`	Too many calls in a short time. Honor Retry-After; use bounded retries with backoff and jitter. Also sends `X-RateLimit-Limit`, `X-RateLimit-Remaining`, `X-RateLimit-Reset`, `Retry-After`.
500	`internal_error`, `response_too_large`	Something failed on our side. Retry only when error.retryable is true. Also sends `X-Credits-Remaining`, `X-RateLimit-Limit`, `X-RateLimit-Remaining`, `X-RateLimit-Reset`.
502	`upstream_error`	A data source sent back something we could not use. Retry with bounded backoff. Also sends `X-Credits-Remaining`, `X-RateLimit-Limit`, `X-RateLimit-Remaining`, `X-RateLimit-Reset`.
503	`service_unavailable`	Lookups are unavailable for a moment. Follow error.retryable, and Retry-After when it is present. Also sends `Retry-After`, `X-RateLimit-Limit`, `X-RateLimit-Remaining`, `X-RateLimit-Reset`, `X-Credits-Remaining`.
504	`upstream_timeout`	The lookup ran out of time. Retry with bounded backoff. Also sends `X-Credits-Remaining`, `X-RateLimit-Limit`, `X-RateLimit-Remaining`, `X-RateLimit-Reset`.