Skills - Standardized Data API

The skills API provides standardized skills data across the LinkedIn platform.

Supported Methods

GET | BATCH_GET | GET_ALL

Schema

Field Name	Description
id	The skill ID.
$URN	Standardized skill URN.
locale	The optional locale the standardized name is in.
standardizedName	The standardized name for this skill.

GET

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

Parameters

Field Name	Sub-Field Name	Required	Description
locale		Yes	The locale the skill data is requested in.
	language	Yes	A lowercase, two-letter language code as defined by ISO-639.
	country	Yes	An uppercase, two-letter country code as defined by ISO-3166.

Sample Response

{
    "standardizedName": "Sales",
    "id": 5,
    "locale": {
        "country": "US",
        "language": "en"
    }
}

BATCH_GET

GET https://api.linkedin.com/v2/skills?ids={id1}&ids={id2}&ids={ids3}&locale.language=en&locale.country=US

Parameters

Field Name	Sub-Field Name	Required	Description
locale			The locale the skill data is requested in.
	language	Yes	A lowercase, two-letter language code as defined by ISO-639.
	country	Yes	An uppercase, two-letter country code as defined by ISO-3166.

Sample Response

{
    "statuses": {},
    "results": {
        "5": {
            "standardizedName": "Sales",
            "id": 5,
            "locale": {
                "country": "US",
                "language": "en"
            }
        },
        "17": {
            "standardizedName": "Engineers",
            "id": 17,
            "locale": {
                "country": "US",
                "language": "en"
            }
        }
    },
    "errors": {}
}

GET_ALL

GET https://api.linkedin.com/v2/skills?locale.language=en&locale.country=US

Parameters

Field Name	Sub-Field Name	Required	Description
locale			The locale the skill data is requested in.
	language	Yes	A lowercase, two-letter language code as defined by ISO-639.
	country	Yes	An uppercase, two-letter country code as defined by ISO-3166.

Sample Response

{
    "elements": [
        {
            "standardizedName": "Sales",
            "id": 5,
            "locale": {
                "country": "US",
                "language": "en"
            }
        },
        {
            "standardizedName": "Engineers",
            "id": 17,
            "locale": {
                "country": "US",
                "language": "en"
            }
        }
    ],
    "paging": {
        "count": 50,
        "start": 0,
        "links": [
            {
                "rel": "next",
                "href": "/v2/skills?count=50&locale.country=US&locale.language=en&start=50",
                "type": "application/json"
            }
        ]
    }
}

Note

This request is limited to 50 objects per response due to size limit. Use pagination to retrieve all skills. For example, https://api.linkedin.com/v2/skills?start=50.