Partager via


Degrees - Standardized Data API

The degrees API provides standardized member degree and diploma data across the LinkedIn platform.

Supported Methods

GET | BATCH_GET | GET_ALL

Schema

Field Name Description
id Degree ID.
$URN Standardized degree URN.
name Degree name in various locales. Represented as MultiLocaleString type.
alias All aliases to this standardized degree name. Represented as an array of MultiLocaleString.
rollup The general standardized degree category for the standardized degree. Represented as a degree URN. Optional.

GET

GET https://api.linkedin.com/v2/degrees/{id}?locale.language=en&locale.country=US

Parameters

Field Name Sub-Field Name Description
locale The locale the degree data is requested in. en_US locale is used if locale is not provided or supported.
language A lowercase, two-letter language code as defined by ISO-639.
country An uppercase, two-letter country code as defined by ISO-3166.

Sample Response

{
    "name": {
        "localized": {
            "en_US": "Bachelor of Architecture"
        }
    },
    "alias": [
        {
            "localized": {
                "en_US": "BArch"
            }
        },
        {
            "localized": {
                "en_US": "Bachelor of Architecture (B.Arch.)"
            }
        },
        {
            "localized": {
                "en_US": "Bachelor of Architecture (BArch)"
            }
        }
    ],
    "id": 258,
    "$URN": "urn:li:degree:258",
    "rollup": "urn:li:degree:200"
}

BATCH_GET

GET https://api.linkedin.com/v2/degrees?ids={id1}&ids={id2}&ids={id3}

Parameters

Field Name Sub-Field Name Description
locale The locale the degree data is requested in. en_US locale is used if locale is not provided or supported.
language A lowercase, two-letter language code as defined by ISO-639.
country An uppercase, two-letter country code as defined by ISO-3166.

Sample Response

{
    "statuses": {},
    "results": {
        "258": {
            "name": {
                "localized": {
                    "en_US": "Bachelor of Architecture"
                }
            },
            "alias": [
                {
                    "localized": {
                        "en_US": "BArch"
                    }
                },
                {
                    "localized": {
                        "en_US": "Bachelor of Architecture (B.Arch.)"
                    }
                },
                {
                    "localized": {
                        "en_US": "Bachelor of Architecture (BArch)"
                    }
                }
            ],
            "id": 258,
            "$URN": "urn:li:degree:258",
            "rollup": "urn:li:degree:200"
        },
        "259": {
            "name": {
                "localized": {
                    "en_US": "Bachelor of Applied Science"
                }
            },
            "alias": [
                {
                    "localized": {
                        "en_US": "BASc"
                    }
                },
                {
                    "localized": {
                        "en_US": "Bachelor of Applied Science (B.A.Sc.)"
                    }
                },
                {
                    "localized": {
                        "en_US": "Bachelor of Applied Science (BASc)"
                    }
                }
            ],
            "id": 259,
            "$URN": "urn:li:degree:259",
            "rollup": "urn:li:degree:200"
        }
    },
    "errors": {}
}

GET_ALL

GET https://api.linkedin.com/v2/degrees

Parameters

Field Name Sub-Field Name Description
locale The locale the degree data is requested in. en_US locale is used if locale is not provided or supported.
language A lowercase, two-letter language code as defined by ISO-639.
country An uppercase, two-letter country code as defined by ISO-3166.

Sample Response

{
    "elements": [
        {
            "name": {
                "localized": {
                    "en_US": "Bachelor of Business Administration"
                }
            },
            "alias": [
                {
                    "localized": {
                        "en_US": "BAC"
                    }
                },
                {
                    "localized": {
                        "en_US": "Bachelor of business"
                    }
                },
                {
                    "localized": {
                        "en_US": "Bachelor of business management"
                    }
                },
                {
                    "localized": {
                        "en_US": "Bachelor of science of business administration"
                    }
                },
                {
                    "localized": {
                        "en_US": "BBA"
                    }
                },
                {
                    "localized": {
                        "en_US": "BBS"
                    }
                },
                {
                    "localized": {
                        "en_US": "BBM"
                    }
                },
                {
                    "localized": {
                        "en_US": "BBus"
                    }
                },
                {
                    "localized": {
                        "en_US": "BSBA"
                    }
                },
                {
                    "localized": {
                        "en_US": "Bachelor of Business Administration (B.B.A.)"
                    }
                },
                {
                    "localized": {
                        "en_US": "Bachelor of Business Administration (BBA)"
                    }
                }
            ],
            "id": 450,
            "$URN": "urn:li:degree:450",
            "rollup": "urn:li:degree:200"
        },
        {
            "name": {
                "localized": {
                    "en_US": "Bachelor of Applied Science"
                }
            },
            "alias": [
                {
                    "localized": {
                        "en_US": "BASc"
                    }
                },
                {
                    "localized": {
                        "en_US": "Bachelor of Applied Science (B.A.Sc.)"
                    }
                },
                {
                    "localized": {
                        "en_US": "Bachelor of Applied Science (BASc)"
                    }
                }
            ],
            "id": 259,
            "$URN": "urn:li:degree:259",
            "rollup": "urn:li:degree:200"
        }
    ],
    "paging": {
        "count": 10,
        "start": 0,
        "links": []
    }
}