Get Profile Education by URL

GEThttps://api.envoapi.com/v1/profiles/education/by-url

Retrieve a profile's education by URL, including available schools, degrees, fields of study and dates, with EnvoAPI.

Authorization headerReturns application/json

GET/v1/profiles/education/by-url

curl "https://api.envoapi.com/v1/profiles/education/by-url?url=https%3A%2F%2Fwww.linkedin.com%2Fin%2Fkentcdodds%2F" \--header "Authorization: Bearer $ENVO_API_KEY" \--header "Accept: application/json"

const response = await fetch("https://api.envoapi.com/v1/profiles/education/by-url?url=https%3A%2F%2Fwww.linkedin.com%2Fin%2Fkentcdodds%2F",{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/education/by-url",params={"url": "https://www.linkedin.com/in/kentcdodds/"},headers={"Authorization": f"Bearer {os.environ['ENVO_API_KEY']}","Accept": "application/json",},)body = response.json()

application/json · 1.6 KB

The profile's education.

{"data": {1 field},"education": [2 items]{7 fields},"school": {3 fields},"publicId": "school_Abzulk","name": "Brigham Young University","logo": [3 items]{3 fields},"url": "https://image.envoapi.com/examples/kentcdodds/education-0-school-logo-0.jpg","width": 100,"height": 100},{3 fields},"url": "https://image.envoapi.com/examples/kentcdodds/education-0-school-logo-1.jpg","width": 200,"height": 200},{3 fields}"url": "https://image.envoapi.com/examples/kentcdodds/education-0-school-logo-2.jpg","width": 400,"height": 400}]},"degree": "Master of Science Information Systems (MISM)","fieldOfStudy": "Web Development","grade": null,"activities": null,"description": null,"dateRange": {3 fields}"start": {3 fields},"year": 2007,"month": null,"day": null},"end": {3 fields},"year": 2014,"month": null,"day": null},"isCurrent": false}},{7 fields}"school": {3 fields},"publicId": "school_Abzulk","name": "Brigham Young University","logo": [3 items]{3 fields},"url": "https://image.envoapi.com/examples/kentcdodds/education-1-school-logo-0.jpg","width": 100,"height": 100},{3 fields},"url": "https://image.envoapi.com/examples/kentcdodds/education-1-school-logo-1.jpg","width": 200,"height": 200},{3 fields}"url": "https://image.envoapi.com/examples/kentcdodds/education-1-school-logo-2.jpg","width": 400,"height": 400}]},"degree": "Master of Information Systems Management","fieldOfStudy": "Information Systems","grade": null,"activities": "Men's Chorus, Association of Information Systems (AIS)","description": "Men's Chorus: Vice President of Social and Digital Media Operations\nAssociation of Information Systems: Vice President of Knowledge Management","dateRange": {3 fields}"start": {3 fields},"year": 2007,"month": null,"day": null},"end": {3 fields},"year": 2014,"month": null,"day": null},"isCurrent": false}}]},"meta": {1 field}"creditCost": 1}}

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/education/by-url

Authorizations

BearerApiKey

Parameters

Query Parameters

url

required

string format: uri

>= 1 characters <= 2048 characters

The full profile URL. The username in its /in/ path selects the profile.

Example

https://www.linkedin.com/in/kentcdodds/

Responses

200

The profile's education.

application/json

object

data

required

object

education

required

Array<object>

object

school

required

Any of:

object
null

Any of:

object

publicId

required

string

/^school_(?:0|[1-9A-Za-z][0-9A-Za-z]{0,5})$/

name

required

null

logo

required

Any of:

Array<object>
null

Array<object>

<= 16 items unique items

object

url

required

string format: uri

>= 1 characters <= 11000 characters

width

required

Any of:

integer
null

integer

>= 1 <= 8192

height

required

Any of:

integer
null

integer

>= 1 <= 8192

degree

required

Any of:

string
null

string

fieldOfStudy

required

Any of:

string
null

string

grade

required

Any of:

string
null

string

activities

required

Any of:

string
null

string

description

required

Any of:

string
null

string

dateRange

required

Any of:

object
null

Any of:

object
object

object

start

required

Any of:

object
null

Any of:

object
object

object

year

required

integer

>= 1 <= 9999

month

required

Any of:

integer
null

integer

>= 1 <= 12

day

required

null

end

required

null

isCurrent

required

boolean

not matching

school

required

null

degree

required

null

fieldOfStudy

required

null

grade

required

null

activities

required

null

description

required

null

dateRange

required

null

meta

required

object

creditCost

required

integer

<= 9007199254740991

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`.