Fields of Study - Standardized Data API

  • Article

The fieldsOfStudy API provides standardized member curriculum data across the LinkedIn platform.

Supported Methods

GET | BATCH_GET | GET_ALL

Schema

Field Name Description
id Field of study ID.
$URN Standardized fieldOfStudy URN.
name Field of study name in various locales. Represented as MultiLocaleString type.
rollupIds The general standardized field of study categories. Returned as an array of fieldOfStudy URNs.

GET

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

Parameters

Field Name Sub-Field Name Description
locale The locale the field of study 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": "Culinary Arts and Related Services"
        }
    },
    "id": 100220,
    "$URN": "urn:li:fieldOfStudy:100220",
    "rollupIds": [
        "urn:li:fieldOfStudy:100203"
    ]
}

BATCH_GET

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

Parameters

Field Name Sub-Field Name Description
locale The locale the field of study 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": {
        "100001": {
            "name": {
                "localized": {
                    "en_US": "AGRICULTURE, AGRICULTURE OPERATIONS, AND RELATED SCIENCES"
                }
            },
            "id": 100001,
            "$URN": "urn:li:fieldOfStudy:100001"
        },
        "100002": {
            "name": {
                "localized": {
                    "en_US": "Agriculture, General"
                }
            },
            "id": 100002,
            "$URN": "urn:li:fieldOfStudy:100002",
            "rollupIds": [
                "urn:li:fieldOfStudy:100001"
            ]
        },
        "100004": {
            "name": {
                "localized": {
                    "en_US": "Agribusiness/Agricultural Business Operations"
                }
            },
            "id": 100004,
            "$URN": "urn:li:fieldOfStudy:100004",
            "rollupIds": [
                "urn:li:fieldOfStudy:100003",
                "urn:li:fieldOfStudy:100001"
            ]
        }
    },
    "errors": {}
}

GET_ALL

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

Parameters

Field Name Sub-Field Name Description
locale The locale the field of study 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": "Cosmetology, Barber/Styling, and Nail Instructor"
                }
            },
            "id": 100218,
            "$URN": "urn:li:fieldOfStudy:100218",
            "rollupIds": [
                "urn:li:fieldOfStudy:100207",
                "urn:li:fieldOfStudy:100203"
            ]
        },
        {
            "name": {
                "localized": {
                    "en_US": "Master Aesthetician/Esthetician"
                }
            },
            "id": 100219,
            "$URN": "urn:li:fieldOfStudy:100219",
            "rollupIds": [
                "urn:li:fieldOfStudy:100207",
                "urn:li:fieldOfStudy:100203"
            ]
        },
        {
            "name": {
                "localized": {
                    "en_US": "Culinary Arts and Related Services"
                }
            },
            "id": 100220,
            "$URN": "urn:li:fieldOfStudy:100220",
            "rollupIds": [
                "urn:li:fieldOfStudy:100203"
            ]
        }
    ],
    "paging": {
        "count": 10,
        "links": [],
        "start": 0
    }
}