Classification Changelog
3 months ago by ReadMe API
All notable changes to this project will be documented in this file.
If you have questions, please contact us by emailing our engineering team at [email protected].
May 2025
1.18.0 (May 20)
/postings/classify endpoint can return concept names
/postings/classify endpoint can return concept namesThe /postings/classify endpoint now can take a new request parameter, findConceptNames, which will result in the API request attempting to locate the human-readable name for each concept it returns.
Request Example:
POST
https://classification.emsicloud.com/classifications/2025.5/postings/classify
{
"context": {
"company": "Southern Nuclear",
"title": "Nuclear Physicist",
"body": "This is a full-time position for a nuclear physicist. The position requires expertise in nuclear physics and spreadsheets. A Master's degree is required. Compensation is $160,000 a year."
},
"findConceptNames": true,
"outputs": [
"cip_standard",
"company",
"lot",
"canoc_lightcast",
"isco_standard",
"onet_standard",
"skill",
"soc_lightcast",
"soc_standard",
"title"
]
}
Response Example:
{
"data": {
"canoc_lightcast": {
"id": "21100",
"name": "Physicists and astronomers"
},
"cip_standard": {
"id": "40.0801",
"name": "Physics, General."
},
"company": {
"id": "75424401",
"name": "Southern Nuclear"
},
"isco_standard": {
"id": "2111",
"name": "Physicists and Astronomers"
},
"lot": {
"id": "33111410",
"name": "Physicist",
"confidence": 1.0
},
"onet_standard": {
"id": "19-2012.00",
"name": "Physicists"
},
"skill": [
{
"id": "KS127TD6X5C909DYQ765",
"name": "Physics",
"confidence": 0.7613267302513123
},
{
"id": "KS121JN70DB9VHC8T9GN",
"name": "Spreadsheets",
"confidence": 0.5428188443183899
}
],
"soc_lightcast": {
"id": "19-2012",
"name": "Physicists"
},
"soc_standard": {
"id": "19-2012",
"name": "Physicists"
},
"title": {
"id": "ET88BB4D290B084D39",
"name": "Nuclear Physicist",
"confidence": 1.0
}
},
"warnings": []
}
February 2025
1.17.0 (February 25)
/classifications endpoint returns complete taxonomy version in supportedTaxonomies
/classifications endpoint returns complete taxonomy version in supportedTaxonomiesThe /classifications endpoint now returns full taxonomy version string value under supportedTaxonomies key.
Request Example:
GET
https://classification.emsicloud.com/classifications
Response Example:
"data": [
{
"supportedOutputs": [
"canoc_lightcast",
...
],
"release": "2025.2",
"supportedTaxonomies": {
"cip_standard": "2020.0.3",
"companies": "2.75.0",
"education_level_gb": "2.3.0",
"education_level_us_ca": "2.3.0",
"lot": "7.1.0",
"skills": "9.27.0",
"titles": "5.41.0"
},
"releaseDate": "2025-02-10T18:08:41.863067Z",
"removalDate": "2025-06-10T18:08:41.863067Z"
},
...
]
1.16.0 (February 10)
Released LOT v7 classifier through release 2025.2.
Request Example:
GET
https://classification.emsicloud.com/classifications
Response Example:
"data": [
{
"supportedOutputs": [
"canoc_lightcast",
"cip_standard",
"company",
"contractType",
"educationLevel",
"employmentType",
"internship",
"isco_standard",
"lot",
"naics_standard",
"onet_standard",
"remoteType",
"salary",
"skill",
"soc_lightcast",
"soc_standard",
"title",
"yearsOfExperience"
],
"release": "2025.2",
"supportedTaxonomies": {
"cip_standard": "2020.0",
"companies": "2.75",
"education_level_gb": "2.3",
"education_level_us_ca": "2.3",
"lot": "7.1",
"skills": "9.27",
"titles": "5.41"
},
"releaseDate": "2025-02-10T18:08:41.863067Z",
"removalDate": "2025-06-10T18:08:41.863067Z"
},
...
]
January 2025
1.15.0 (January 30)
Changed maximum of limit parameter on /normalize endpoints from 5 to 25.
limit parameter on /normalize endpoints from 5 to 25.Request Example:
POST
https://classification.emsicloud.com/classifications/2025.1/companies/normalize
{
"terms": [
"Amazon",
"Alphabet Inc.",
"Wal-Mart"
],
"fields": [
"id",
"name",
"naics6",
"website",
"isStaffing",
"isFortune1000"
],
"limit": 25,
"confidenceThreshold": 0.8
}
Response Example:
{
"data": [
{
"count": 25,
"results": [
{
"concept": {
"id": "20",
"isFortune1000": true,
"isStaffing": false,
"levelName": "topLevelCompany",
"naics6": "454110",
"name": "Amazon",
"website": "https://www.amazon.com/"
},
"confidence": null
},
{
"concept": {
"id": "101875525",
"isFortune1000": null,
"isStaffing": null,
"levelName": "topLevelCompany",
"naics6": null,
"name": "Maax Ies ®",
"website": null
},
"confidence": null
},
{
"concept": {
"id": "60558122",
"isFortune1000": null,
"isStaffing": null,
"levelName": "topLevelCompany",
"naics6": "493110",
"name": "Amazon.com Services LLC / Amazon.com Services LLC - Okc5",
"website": null
},
"confidence": null
},
{
"concept": {
"id": "62525454",
"isFortune1000": null,
"isStaffing": null,
"levelName": "topLevelCompany",
"naics6": null,
"name": "Amazon.com Services LLC / Amazon.com Services LLC - Okc1",
"website": null
},
"confidence": null
},
{
"concept": {
"id": "63449815",
"isFortune1000": null,
"isStaffing": null,
"levelName": "topLevelCompany",
"naics6": "493110",
"name": "Amazon.com Services LLC / Amazon.com Services LLC Dok4",
"website": null
},
"confidence": null
},
{
"concept": {
"id": "104416758",
"isFortune1000": null,
"isStaffing": null,
"levelName": "topLevelCompany",
"naics6": null,
"name": "Amazon.com Services LLC / Amazon.com Services LLC Tul2",
"website": null
},
"confidence": null
},
{
"concept": {
"id": "107710874",
"isFortune1000": null,
"isStaffing": null,
"levelName": "topLevelCompany",
"naics6": null,
"name": "Amazon Consultant || Amazon Fba & Fbm ||",
"website": null
},
"confidence": null
},
{
"concept": {
"id": "2080928",
"isFortune1000": true,
"isStaffing": false,
"levelName": "topLevelCompany",
"naics6": "531210",
"name": "JLL",
"website": "https://www.us.jll.com/"
},
"confidence": null
},
{
"concept": {
"id": "32654576",
"isFortune1000": null,
"isStaffing": null,
"levelName": "topLevelCompany",
"naics6": null,
"name": "Amazon Systems Limited",
"website": null
},
"confidence": null
},
{
"concept": {
"id": "41312447",
"isFortune1000": null,
"isStaffing": null,
"levelName": "topLevelCompany",
"naics6": null,
"name": "Amazon Mortgage",
"website": null
},
"confidence": null
},
{
"concept": {
"id": "46986228",
"isFortune1000": null,
"isStaffing": null,
"levelName": "topLevelCompany",
"naics6": null,
"name": "Amazon Flooring",
"website": null
},
"confidence": null
},
{
"concept": {
"id": "46997767",
"isFortune1000": null,
"isStaffing": null,
"levelName": "topLevelCompany",
"naics6": null,
"name": "Amazon Goog",
"website": null
},
"confidence": null
},
{
"concept": {
"id": "51737400",
"isFortune1000": null,
"isStaffing": null,
"levelName": "topLevelCompany",
"naics6": null,
"name": "Homes Systems",
"website": null
},
"confidence": null
},
{
"concept": {
"id": "52043030",
"isFortune1000": null,
"isStaffing": null,
"levelName": "topLevelCompany",
"naics6": "813990",
"name": "Amazon Organics",
"website": null
},
"confidence": null
},
{
"concept": {
"id": "81355090",
"isFortune1000": null,
"isStaffing": null,
"levelName": "topLevelCompany",
"naics6": "561720",
"name": "Amazon Group",
"website": "https://www.amazongroup.com.pe/"
},
"confidence": null
},
{
"concept": {
"id": "642",
"isFortune1000": null,
"isStaffing": null,
"levelName": "topLevelCompany",
"naics6": "722513",
"name": "A.M. Corporation Srls",
"website": "https://www.artmat.nl/"
},
"confidence": null
},
{
"concept": {
"id": "332704",
"isFortune1000": null,
"isStaffing": null,
"levelName": "topLevelCompany",
"naics6": "238990",
"name": "Amazon Landscaping",
"website": "https://www.amazonlandscaping.com/"
},
"confidence": null
},
{
"concept": {
"id": "395141",
"isFortune1000": null,
"isStaffing": null,
"levelName": "topLevelCompany",
"naics6": "236115",
"name": "Abc Corporate Services",
"website": "https://www.thebincleaners.com/"
},
"confidence": null
},
{
"concept": {
"id": "480147",
"isFortune1000": null,
"isStaffing": null,
"levelName": "topLevelCompany",
"naics6": null,
"name": "Amazon Eavestroughing",
"website": null
},
"confidence": null
},
{
"concept": {
"id": "496560",
"isFortune1000": null,
"isStaffing": null,
"levelName": "topLevelCompany",
"naics6": null,
"name": "Amazon Insurance",
"website": "https://www.ams-formation.com/"
},
"confidence": null
},
{
"concept": {
"id": "559792",
"isFortune1000": null,
"isStaffing": null,
"levelName": "topLevelCompany",
"naics6": null,
"name": "Amazon Rejuvenators",
"website": null
},
"confidence": null
},
{
"concept": {
"id": "738539",
"isFortune1000": null,
"isStaffing": null,
"levelName": "topLevelCompany",
"naics6": "452311",
"name": "The Amazon Agency",
"website": null
},
"confidence": null
},
{
"concept": {
"id": "761278",
"isFortune1000": null,
"isStaffing": null,
"levelName": "topLevelCompany",
"naics6": null,
"name": "Amazon Bridge Ltd.",
"website": null
},
"confidence": null
},
{
"concept": {
"id": "1256585",
"isFortune1000": null,
"isStaffing": null,
"levelName": "topLevelCompany",
"naics6": "531311",
"name": "Amazon Properties",
"website": null
},
"confidence": null
},
{
"concept": {
"id": "2336558",
"isFortune1000": null,
"isStaffing": null,
"levelName": "topLevelCompany",
"naics6": "236220",
"name": "Aml",
"website": "https://www.amlcargo.nl/"
},
"confidence": null
}
],
"term": "Amazon"
},
{
"count": 25,
"results": [
{
"concept": {
"id": "9383998",
"isFortune1000": true,
"isStaffing": false,
"levelName": "topLevelCompany",
"naics6": "541511",
"name": "Alphabet",
"website": "https://www.abc.xyz/"
},
"confidence": null
},
{
"concept": {
"id": "61150251",
"isFortune1000": null,
"isStaffing": null,
"levelName": "topLevelCompany",
"naics6": null,
"name": "Alphabet Gang-alphabet Gang",
"website": null
},
"confidence": null
},
{
"concept": {
"id": "91890868",
"isFortune1000": null,
"isStaffing": null,
"levelName": "topLevelCompany",
"naics6": null,
"name": "App Mario Alphabet - Alphabet App",
"website": "https://www.appalphabet.com/"
},
"confidence": null
},
{
"concept": {
"id": "37712425",
"isFortune1000": null,
"isStaffing": null,
"levelName": "topLevelCompany",
"naics6": "624410",
"name": "Alphabet Alley",
"website": null
},
"confidence": null
},
{
"concept": {
"id": "38413520",
"isFortune1000": null,
"isStaffing": null,
"levelName": "topLevelCompany",
"naics6": "624410",
"name": "Alphabet Club",
"website": "https://www.alphabetclub.org/"
},
"confidence": null
},
{
"concept": {
"id": "48446804",
"isFortune1000": null,
"isStaffing": null,
"levelName": "topLevelCompany",
"naics6": "624410",
"name": "Alphabet Ac",
"website": null
},
"confidence": null
},
{
"concept": {
"id": "89098434",
"isFortune1000": null,
"isStaffing": null,
"levelName": "topLevelCompany",
"naics6": null,
"name": "Alphabet Formation",
"website": null
},
"confidence": null
},
{
"concept": {
"id": "1547310",
"isFortune1000": null,
"isStaffing": null,
"levelName": "topLevelCompany",
"naics6": "221310",
"name": "Abf",
"website": "https://www.abf-lab.com/"
},
"confidence": null
},
{
"concept": {
"id": "1727618",
"isFortune1000": null,
"isStaffing": null,
"levelName": "topLevelCompany",
"naics6": null,
"name": "Alphabet Accounting",
"website": null
},
"confidence": null
},
{
"concept": {
"id": "2297450",
"isFortune1000": null,
"isStaffing": null,
"levelName": "topLevelCompany",
"naics6": null,
"name": "Alphabet City",
"website": "https://www.alphabet-city.org/"
},
"confidence": null
},
{
"concept": {
"id": "4234338",
"isFortune1000": null,
"isStaffing": null,
"levelName": "topLevelCompany",
"naics6": null,
"name": "Alphabet Fuhrparkmanagement GmbH",
"website": "https://www.alphabet.ch/"
},
"confidence": null
},
{
"concept": {
"id": "27678329",
"isFortune1000": null,
"isStaffing": null,
"levelName": "topLevelCompany",
"naics6": null,
"name": "Alphabet Originals",
"website": null
},
"confidence": null
},
{
"concept": {
"id": "32169398",
"isFortune1000": null,
"isStaffing": null,
"levelName": "topLevelCompany",
"naics6": null,
"name": "Alphabet Arts",
"website": "https://www.alphabetarts.org/"
},
"confidence": null
},
{
"concept": {
"id": "32169678",
"isFortune1000": null,
"isStaffing": null,
"levelName": "topLevelCompany",
"naics6": null,
"name": "Alphabet Avenue",
"website": null
},
"confidence": null
},
{
"concept": {
"id": "32169842",
"isFortune1000": null,
"isStaffing": null,
"levelName": "topLevelCompany",
"naics6": null,
"name": "Alphabet Brewing LTD",
"website": "https://www.alphabetbrewing.co.uk/"
},
"confidence": null
},
{
"concept": {
"id": "32169852",
"isFortune1000": null,
"isStaffing": null,
"levelName": "topLevelCompany",
"naics6": null,
"name": "Alphabet Cars",
"website": "https://www.alphabetcars.co.uk/"
},
"confidence": null
},
{
"concept": {
"id": "32169858",
"isFortune1000": null,
"isStaffing": null,
"levelName": "topLevelCompany",
"naics6": null,
"name": "Alphabet Childcare",
"website": "https://www.alphabet-childcare.co.uk/"
},
"confidence": null
},
{
"concept": {
"id": "32169866",
"isFortune1000": null,
"isStaffing": null,
"levelName": "topLevelCompany",
"naics6": null,
"name": "Alphabet Communications",
"website": "https://www.alphabet.ca/"
},
"confidence": null
},
{
"concept": {
"id": "32169868",
"isFortune1000": null,
"isStaffing": null,
"levelName": "topLevelCompany",
"naics6": "238160",
"name": "Alphabet Construction",
"website": null
},
"confidence": null
},
{
"concept": {
"id": "32169870",
"isFortune1000": null,
"isStaffing": null,
"levelName": "topLevelCompany",
"naics6": null,
"name": "Alphabet Copywriting Limited",
"website": null
},
"confidence": null
},
{
"concept": {
"id": "32170044",
"isFortune1000": null,
"isStaffing": null,
"levelName": "topLevelCompany",
"naics6": null,
"name": "Alphabet Fitness Limited",
"website": null
},
"confidence": null
},
{
"concept": {
"id": "32170047",
"isFortune1000": null,
"isStaffing": null,
"levelName": "topLevelCompany",
"naics6": "531311",
"name": "Alphabet Group",
"website": null
},
"confidence": null
},
{
"concept": {
"id": "32170289",
"isFortune1000": null,
"isStaffing": null,
"levelName": "topLevelCompany",
"naics6": null,
"name": "Alphabet Holdings",
"website": null
},
"confidence": null
},
{
"concept": {
"id": "32170604",
"isFortune1000": null,
"isStaffing": null,
"levelName": "topLevelCompany",
"naics6": "519130",
"name": "Alphabet House",
"website": "https://www.alphabethouse.com/"
},
"confidence": null
},
{
"concept": {
"id": "32170909",
"isFortune1000": null,
"isStaffing": true,
"levelName": "topLevelCompany",
"naics6": "611110",
"name": "Alphabet Kidz",
"website": "https://www.alphabetkidz.co.uk/"
},
"confidence": null
}
],
"term": "Alphabet Inc."
},
{
"count": 25,
"results": [
{
"concept": {
"id": "36704772",
"isFortune1000": true,
"isStaffing": false,
"levelName": "topLevelCompany",
"naics6": "452210",
"name": "Walmart",
"website": "https://www.walmart.com/"
},
"confidence": null
},
{
"concept": {
"id": "41541381",
"isFortune1000": null,
"isStaffing": null,
"levelName": "topLevelCompany",
"naics6": "452319",
"name": "Wal-mart Stores Texas",
"website": null
},
"confidence": null
},
{
"concept": {
"id": "97913886",
"isFortune1000": null,
"isStaffing": null,
"levelName": "topLevelCompany",
"naics6": "452311",
"name": "Wal*Mart Corporation",
"website": null
},
"confidence": null
},
{
"concept": {
"id": "61184902",
"isFortune1000": null,
"isStaffing": null,
"levelName": "topLevelCompany",
"naics6": null,
"name": "Wal-mart-treatment Plant - Wal-mart",
"website": null
},
"confidence": null
},
{
"concept": {
"id": "62511949",
"isFortune1000": null,
"isStaffing": null,
"levelName": "topLevelCompany",
"naics6": null,
"name": "Wal-mart Stores, Inc. Wal-mart Store 1288",
"website": null
},
"confidence": null
},
{
"concept": {
"id": "62511951",
"isFortune1000": null,
"isStaffing": null,
"levelName": "topLevelCompany",
"naics6": null,
"name": "Wal-mart Stores, Inc., Wal-mart Store 2137",
"website": null
},
"confidence": null
},
{
"concept": {
"id": "63194109",
"isFortune1000": null,
"isStaffing": null,
"levelName": "topLevelCompany",
"naics6": null,
"name": "Wal-mart Stores Inc - Wal-mart Retail Development (laurel Store)",
"website": null
},
"confidence": null
},
{
"concept": {
"id": "64361034",
"isFortune1000": null,
"isStaffing": null,
"levelName": "topLevelCompany",
"naics6": null,
"name": "Wal-mart Store #5491/ Wal-mart Stores",
"website": null
},
"confidence": null
},
{
"concept": {
"id": "36671783",
"isFortune1000": null,
"isStaffing": null,
"levelName": "topLevelCompany",
"naics6": null,
"name": "Wal-mart #3035",
"website": null
},
"confidence": null
},
{
"concept": {
"id": "36871001",
"isFortune1000": null,
"isStaffing": null,
"levelName": "topLevelCompany",
"naics6": "221114",
"name": "SunE M5 Holdings",
"website": null
},
"confidence": null
},
{
"concept": {
"id": "59782093",
"isFortune1000": null,
"isStaffing": null,
"levelName": "topLevelCompany",
"naics6": "452311",
"name": "Wal Mart 5273",
"website": null
},
"confidence": null
},
{
"concept": {
"id": "61857486",
"isFortune1000": null,
"isStaffing": null,
"levelName": "topLevelCompany",
"naics6": "452311",
"name": "Wal-mart #882",
"website": null
},
"confidence": null
},
{
"concept": {
"id": "62040100",
"isFortune1000": null,
"isStaffing": null,
"levelName": "topLevelCompany",
"naics6": "452319",
"name": "Wal-mart #2806",
"website": null
},
"confidence": null
},
{
"concept": {
"id": "36719955",
"isFortune1000": null,
"isStaffing": null,
"levelName": "topLevelCompany",
"naics6": null,
"name": "Wal-Mart #3301",
"website": null
},
"confidence": null
},
{
"concept": {
"id": "37242097",
"isFortune1000": null,
"isStaffing": null,
"levelName": "topLevelCompany",
"naics6": null,
"name": "(ctn) Old Wal- Mart",
"website": null
},
"confidence": null
},
{
"concept": {
"id": "37283739",
"isFortune1000": null,
"isStaffing": null,
"levelName": "topLevelCompany",
"naics6": null,
"name": "Wal-mart #2282",
"website": null
},
"confidence": null
},
{
"concept": {
"id": "37610682",
"isFortune1000": null,
"isStaffing": null,
"levelName": "topLevelCompany",
"naics6": null,
"name": "Wal Mart #2897",
"website": null
},
"confidence": null
},
{
"concept": {
"id": "37783769",
"isFortune1000": null,
"isStaffing": null,
"levelName": "topLevelCompany",
"naics6": null,
"name": "Wal-Mart TRS",
"website": null
},
"confidence": null
},
{
"concept": {
"id": "37853177",
"isFortune1000": null,
"isStaffing": null,
"levelName": "topLevelCompany",
"naics6": null,
"name": "Wal*mart Subway",
"website": null
},
"confidence": null
},
{
"concept": {
"id": "41531488",
"isFortune1000": null,
"isStaffing": null,
"levelName": "topLevelCompany",
"naics6": null,
"name": "Wal-mart #2280",
"website": null
},
"confidence": null
},
{
"concept": {
"id": "42231469",
"isFortune1000": null,
"isStaffing": null,
"levelName": "topLevelCompany",
"naics6": "452210",
"name": "Wal-mart Stores East I, L.P.",
"website": null
},
"confidence": null
},
{
"concept": {
"id": "42356333",
"isFortune1000": null,
"isStaffing": null,
"levelName": "topLevelCompany",
"naics6": null,
"name": "Wal Mart Asso",
"website": null
},
"confidence": null
},
{
"concept": {
"id": "43603762",
"isFortune1000": null,
"isStaffing": null,
"levelName": "topLevelCompany",
"naics6": "332994",
"name": "Wal Mart #2242",
"website": null
},
"confidence": null
},
{
"concept": {
"id": "43924659",
"isFortune1000": null,
"isStaffing": null,
"levelName": "topLevelCompany",
"naics6": null,
"name": "Wal-Mart #1693",
"website": null
},
"confidence": null
},
{
"concept": {
"id": "44563310",
"isFortune1000": null,
"isStaffing": null,
"levelName": "topLevelCompany",
"naics6": null,
"name": "Wal-mart Properties",
"website": null
},
"confidence": null
}
],
"term": "Wal-Mart"
}
],
"warnings": [
]
}
October 2024
1.14.0 (October 30)
Changed /mappings and /mappings/{mapName}/changes endpoints to be more reflective of client permission
/mappings and /mappings/{mapName}/changes endpoints to be more reflective of client permission/mappings and /mappings/{mapName}/changes endpoints will now strictly return data based on data access permission.
1.13.0 (October 28)
Added companies and titles normalization endpoints
New endpoints receive a list of titles or companies for normalizing into corresponding Lightcast concepts.
/classifications/{release}/titles/normalize
Request Example:
POST
https://classification.emsicloud.com/classifications/2024.17/titles/normalize
{
"terms": [
"data scientist",
"software engineer",
"sysadmin"
],
"fields": [
"id",
"name"
],
"limit": 3,
"confidenceThreshold": 0.8
}
Response Example
{
"data": [
{
"term": "data scientist",
"count": 3,
"results": [
{
"confidence": 0.9999998807907104,
"concept": {
"id": "ET3B93055220D592C8",
"name": "Data Scientist",
"levelName": "title"
}
},
{
"confidence": 0.8445643782615662,
"concept": {
"id": "ETB15B6675998124CE",
"name": "Lead Data Scientist",
"levelName": "title"
}
},
{
"confidence": 0.8244964480400085,
"concept": {
"id": "ET4FCFA3780EC9B70F",
"name": "Data Scientist Consultant",
"levelName": "title"
}
}
]
},
{
"term": "software engineer",
"count": 3,
"results": [
{
"confidence": 1.0,
"concept": {
"id": "ET6850661D6AE5FA86",
"name": "Software Engineer",
"levelName": "title"
}
},
{
"confidence": 0.9008715152740479,
"concept": {
"id": "ET075A0E51EC31D29B",
"name": "IT Software Engineer",
"levelName": "title"
}
},
{
"confidence": 0.8946541547775269,
"concept": {
"id": "ET8597B2AB64F8F382",
"name": "Software Engineer in C",
"levelName": "title"
}
}
]
},
{
"term": "sysadmin",
"count": 2,
"results": [
{
"confidence": 1.0,
"concept": {
"id": "ET9CFD6A9577D1BCEF",
"name": "Systems Administrator",
"levelName": "title"
}
},
{
"confidence": 0.8440335392951965,
"concept": {
"id": "ETDF5FC25CDD76040A",
"name": "Lead Systems Administrator",
"levelName": "title"
}
}
]
}
],
"warnings": []
}
Request Example:
POST
https://classification.emsicloud.com/classifications/2024.17/companies/normalize
{
"terms": [
"Amazon",
"Alphabet Inc.",
"Wal-Mart"
],
"fields": [
"id",
"name",
"naics6",
"website",
"isStaffing",
"isFortune1000"
],
"limit": 3,
"confidenceThreshold": 0.8
}
Response Example:
{
"data": [
{
"term": "Amazon",
"count": 3,
"results": [
{
"confidence": null,
"concept": {
"id": "20",
"name": "Amazon",
"levelName": "topLevelCompany",
"naics6": "454110",
"website": "http://amazon.com",
"isStaffing": false,
"isFortune1000": true
}
},
{
"confidence": null,
"concept": {
"id": "79086311",
"name": "Amazon.Ca",
"levelName": "topLevelCompany",
"naics6": "448190",
"website": "null",
"isStaffing": null,
"isFortune1000": null
}
},
{
"confidence": null,
"concept": {
"id": "101875525",
"name": "Maax Ies ®",
"levelName": "topLevelCompany",
"naics6": null,
"website": null,
"isStaffing": null,
"isFortune1000": null
}
}
]
},
{
"term": "Alphabet Inc.",
"count": 3,
"results": [
{
"confidence": null,
"concept": {
"id": "9383998",
"name": "Alphabet",
"levelName": "topLevelCompany",
"naics6": "541511",
"website": "http://abc.xyz",
"isStaffing": false,
"isFortune1000": true
}
},
{
"confidence": null,
"concept": {
"id": "61150251",
"name": "Alphabet Gang-alphabet Gang",
"levelName": "topLevelCompany",
"naics6": null,
"website": null,
"isStaffing": null,
"isFortune1000": null
}
},
{
"confidence": null,
"concept": {
"id": "91890868",
"name": "App Mario Alphabet - Alphabet App",
"levelName": "topLevelCompany",
"website": "http://appalphabet.com",
"naics6": null,
"isStaffing": null,
"isFortune1000": null
}
}
]
},
{
"term": "Wal-Mart",
"count": 3,
"results": [
{
"confidence": null,
"concept": {
"id": "36704772",
"name": "Walmart",
"levelName": "topLevelCompany",
"naics6": "452210",
"website": "http://walmart.com",
"isStaffing": false,
"isFortune1000": true
}
},
{
"confidence": null,
"concept": {
"id": "41541381",
"name": "Wal-mart Stores Texas",
"levelName": "topLevelCompany",
"naics6": "452319",
"website": null,
"isStaffing": null,
"isFortune1000": null
}
},
{
"confidence": null,
"concept": {
"id": "97913886",
"name": "Wal*Mart Corporation",
"levelName": "topLevelCompany",
"naics6": "452311",
"website": null,
"isStaffing": null,
"isFortune1000": null
}
}
]
}
],
"warnings": []
}
Also versions exist that receive a list of companies or titles from a file. /classifications/companies/normalize/file and /classifications/titles/normalize/file endpoints use the form parameter fileUpload for uploading the file (plain text, PDF, or docx) containing terms to normalize, and query string parameters for fields, limit, and confidenceThreshold.
Added /classifications/skills/extract/file endpoint for uploading files for skill extraction
/classifications/skills/extract/file endpoint for uploading files for skill extractionNew endpoint uses fileUpload form parameter for uploading the relevant file (plain text, PDF, or docx), and query string parameters for inputLocale, outputLocale, confidenceThreshold, and trace.
September 2024
1.12.0 (September 13)
Added /mappings/{mapName}/changes endpoint to give a summary of the differences recorded in a mapping between two taxonomies
/mappings/{mapName}/changes endpoint to give a summary of the differences recorded in a mapping between two taxonomiesRequest Example:
GET
https://classification.emsicloud.com/mappings/skills_v9.7.0_skills_v9.8.0/changes
Response Example:
{
"data": {
"additions": [
{
"id": "ES10034B3F54D3592090",
"name": "Google Bard"
},
{
"id": "ES17448E404BEF7B6CED",
"name": "Lando (Software)"
},
{
"id": "ES32CE28085492CE9D9C",
"name": "Visme (Software)"
},
{
"id": "ES339417221F721DAD77",
"name": "Functional Analysis"
},
{
"id": "ES597FD60D373310FBA7",
"name": "Varnish Cache"
},
{
"id": "ES9BC2B186D503A6749A",
"name": "Chip Design"
},
{
"id": "ESB15295681AFEC25E48",
"name": "Twitch"
},
{
"id": "ESB37E2A2BE2B1137435",
"name": "Stable Diffusion"
},
{
"id": "ESC33A3BCAA3934E0E9D",
"name": "LightGBM"
},
{
"id": "ESE90CF6F01CE47D9537",
"name": "DALL-E Image Generator"
}
],
"removals": [
{
"id": "KS1243G647PT6VNYXJ66",
"name": "Fraud Prevention And Detection"
}
],
"renames": [
{
"id": "KS125TJ5YGX5NLDMPS7M",
"fromName": "LIBSVM",
"toName": "LibSVM"
},
{
"id": "KS1271Z6JS5110PHSPC6",
"fromName": "Natural Language Processing Systems",
"toName": "Natural Language Processing (NLP)"
},
{
"id": "KS9PF4263GGN98ZH61MN",
"fromName": "Predictionio",
"toName": "PredictionIO"
}
],
"consolidations": [
{
"fromId": "KS126VY6DLPDWFZD5VB8",
"fromName": "Natural Language Processing",
"toId": "KS1271Z6JS5110PHSPC6",
"toName": "Natural Language Processing (NLP)"
},
{
"fromId": "KS1769WGLXP52CXL8NVC",
"fromName": "Orgchart",
"toId": "KS127FJ60YWBR5YNW249",
"toName": "Organizational Charts"
}
]
},
"errors": [],
"warnings": []
}
July 2024
1.11.0 (July 10)
Extended removal date to 120 days from release date for releases from 2024.14 on
2024.14 onRequest Example:
GET
https://classification.emsicloud.com/classifications
Response Example:
{
"data": [
{
"supportedOutputs": [
"canoc_lightcast",
"cip_standard",
"company",
"contractType",
"educationLevel",
"employmentType",
"internship",
"isco_standard",
"lot",
"naics_standard",
"onet_standard",
"remoteType",
"salary",
"skill",
"soc_lightcast",
"soc_standard",
"title",
"yearsOfExperience"
],
"release": "2024.14",
"supportedTaxonomies": {
"cip_standard": "2020.0",
"companies": "2.67",
"education_level_gb": "2.3",
"education_level_us_ca": "2.3",
"lot": "6.29",
"skills": "9.19",
"titles": "5.33"
},
"releaseDate": "2024-07-08T20:55:09.834094Z",
"removalDate": "2024-11-05T20:55:09.834094Z"
},
{
"supportedOutputs": [
"canoc_lightcast",
"cip_standard",
"company",
"contractType",
"educationLevel",
"employmentType",
"internship",
"isco_standard",
"lot",
"naics_standard",
"onet_standard",
"remoteType",
"salary",
"skill",
"soc_lightcast",
"soc_standard",
"title",
"yearsOfExperience"
],
"release": "2024.13",
"supportedTaxonomies": {
"cip_standard": "2020.0",
"companies": "2.66",
"education_level_gb": "2.3",
"education_level_us_ca": "2.3",
"lot": "6.28",
"skills": "9.18",
"titles": "5.32"
},
"releaseDate": "2024-06-24T22:39:38.878777Z",
"removalDate": "2024-09-22T22:39:38.878777Z"
},
...
]
}
1.10.0 (July 3)
Added isco_standard as an available output for the /postings/classify endpoint
isco_standard as an available output for the /postings/classify endpointRequest Example:
POST
https://classification.emsicloud.com/classifications/2024.13/postings/classify
{
"context": {
"company": "Starpoint Solutions",
"title": "CCL Programmer Intern",
"body": "This is a sample job posting for a full-time Programmer intern. The salary starts at $25 per hour. You should have a college degree or 1 year in professional software development. Our company offers great benefits like a 401K. Employees love to work for us."
},
"outputs": [
"isco_standard",
"soc_standard",
"soc_lightcast"
]
}
Response Example:
{
"data": {
"isco_standard": {
"id": "2512"
},
"soc_lightcast": {
"id": "15-1251"
},
"soc_standard": {
"id": "15-1251"
}
},
"warnings": []
}
June 2024
1.9.0 (June 4)
Added internship as an available output for the /postings/classify endpoint
internship as an available output for the /postings/classify endpointRequest Example:
POST
https://classification.emsicloud.com/classifications/2024.11/postings/classify
{
"context": {
"company": "Starpoint Solutions",
"title": "CCL Programmer Intern",
"body": "This is a sample job posting for a full-time Programmer intern. The salary starts at $25 per hour. You should have a college degree or 1 year in professional software development. Our company offers great benefits like a 401K. Employees love to work for us."
},
"outputs": [
"skill",
"internship",
"title"
]
}
Response Example:
{
"data": {
"internship": {
"isInternship": true
},
"skill": [
{
"id": "KS120L96KMYTDJ48NRSH",
"confidence": 0.6632477045059204
}
],
"title": {
"id": "ET949A94E646EF1182",
"confidence": 0.5934706330299377
}
},
"warnings": []
}
Added originalPeriodicity to the response for the salary output of the /postings/classify endpoint
originalPeriodicity to the response for the salary output of the /postings/classify endpointRequest Example:
POST
https://classification.emsicloud.com/classifications/2024.11/postings/classify
{
"context": {
"company": "Starpoint Solutions",
"title": "CCL Programmer Intern",
"body": "This is a sample job posting for a full-time Programmer intern. The salary starts at $25 per hour. You should have a college degree or 1 year in professional software development. Our company offers great benefits like a 401K. Employees love to work for us."
},
"outputs": [
"skill",
"salary",
"title"
]
}
Response Example:
{
"data": {
"salary": {
"gte": 52000,
"lte": 52000,
"units": "USD",
"originalPeriodicity": "hour"
},
"skill": [
{
"id": "KS120L96KMYTDJ48NRSH",
"confidence": 0.6632477045059204
}
],
"title": {
"id": "ET949A94E646EF1182",
"confidence": 0.5934706330299377
}
},
"warnings": []
}
Added canoc_lightcast as an available output for the /postings/classify endpoint, starting with release 2024.11
canoc_lightcast as an available output for the /postings/classify endpoint, starting with release 2024.11Request Example:
POST
https://classification.emsicloud.com/classifications/2024.11/postings/classify
{
"context": {
"company": "Starpoint Solutions",
"title": "CCL Software Engineer II",
"body": "This is a sample job posting for a full-time Programmer. The salary starts at $70,000 per year. You should have 6 years of experience in software development, including 4 years using AWS cloud services. Our company offers great benefits like a 401K. Employees love to work for us."
},
"outputs": [
"skill",
"canoc_lightcast",
"title",
]
}
Response Example:
{
"data": {
"canoc_lightcast": {
"id": "21231"
},
"skill": [
{
"id": "ES43DB1E2DEC412F3A26",
"confidence": 1.0
},
{
"id": "KS120FG6YP8PQYYNQY9B",
"confidence": 0.9805825352668762
},
{
"id": "KS120L96KMYTDJ48NRSH",
"confidence": 0.6632477045059204
}
],
"title": {
"id": "ET6850661D6AE5FA86",
"confidence": 0.7491557002067566
}
},
"warnings": []
}
April 2024
1.8.0 (April 15)
Replaced cip,naics,onet, and soc outputs of endpoint postings/classify with cip_standard,naics_standard,onet_standard,soc_lightcast, and soc_standard, starting with release 2024.8
cip,naics,onet, and soc outputs of endpoint postings/classify with cip_standard,naics_standard,onet_standard,soc_lightcast, and soc_standard, starting with release 2024.8Request Example:
POST
https://classification.emsicloud.com/classifications/2024.8/postings/classify
{
"context": {
"company": "New Beginnings",
"title": "Mental Health Counselor",
"body": "Counsel and advise individuals and groups to promote optimum mental and emotional health, with an emphasis on prevention."
},
"outputs": [
"cip_standard",
"naics_standard",
"onet_standard",
"soc_standard",
"soc_lightcast"
]
}
Response Example:
{
"data": {
"cip_standard": null,
"naics_standard": {
"id": "621112"
},
"onet_standard": {
"id": "21-1014.00"
},
"soc_lightcast": {
"id": "21-1018"
},
"soc_standard": {
"id": "21-1014"
}
},
"warnings": []
}
January 2024
1.7.0 (January 12)
Added confidenceThreshold as an available parameter to the lot/classify endpoint
confidenceThreshold as an available parameter to the lot/classify endpointNew confidenceThreshold parameter was added to the /lot/classify endpoint.
This will set a minimum confidence value for response results to meet.
Request Example:
POST
https://classification.emsicloud.com/classifications/2024.1/lot/classify
{
"title": "CCL Software Engineer II",
"description": "This is a sample job posting for a full-time Programmer. The position is remote; successful candidates will be able to work from home. Masters degree in computer science required. The salary starts at $70,000 per year. You should have 6 years of experience in software development, including 4 years using AWS cloud services. Our company offers great benefits like a 401K. Employees love to work for us.",
"limit": 5,
"fields": [
"level",
"id",
"name",
"parentId"
],
"confidenceThreshold": 0.7
}
Response Example:
{
"data": [
{
"confidence": 1.0,
"concept": {
"id": "23171541",
"name": "Software Developer / Engineer",
"levelName": "specializedOccupation",
"parentId": "231715",
"level": 3
}
}
],
"warnings": []
}
November 2023
1.6.0 (November 9)
Added outputlocale as an available parameter to the skills/extract endpoint
outputlocale as an available parameter to the skills/extract endpointNew outputLocale parameter was added to the /skills/extract endpoint as of release 2023.19.
The metadata endpoint response will now include supported locales to which the response concepts can be translated.
Request Example:
GET
https://classification.emsicloud.com/classifications/2023.19/skills/extract
Response Example:
{
"data": {
"locales": {
"inputs": [
"cs-CZ",
"da-DK",
"de-DE",
"en",
"es-ES",
"es-MX",
"fr-FR",
"it-IT",
"nl-NL",
"pl-PL",
"pt-BR",
"pt-PT",
"ro-RO",
"sv-SE"
],
"outputs": [
"de-DE",
"en-CA",
"en-GB",
"en-US",
"es-ES",
"fr-FR",
"it-IT",
"nl-NL"
]
}
}
}
An available value can be used in making a skill extraction request to find the skill names in the desired locale.
Request Example:
POST
https://classification.emsicloud.com/classifications/2023.19/skills/extract
{
"text": "Position: Software Engineer\n\nCompany: [Company Name]\n\nLocation: [Office Location]\n\nEmployment Type: Full-time\n\nCompany Description:\n\n[Briefly describe the company and its mission.]\n\nRoles and Responsibilities:\n\nAs a Software Engineer, you will be part of a dynamic team responsible for the development, testing, and maintenance of the company's software. Key responsibilities include:\n\nDesigning, developing, and testing high-quality software.\nCollaborating with other team members to define requirements and specifications.\nSolving technical problems and providing effective solutions.\nMaintaining and updating existing code.\nThoroughly documenting software and development processes.\nParticipating in code reviews and debugging sessions.\nRequirements:\n\nBachelor's degree in computer science, software engineering, or a related field.\nProven experience in software development.\nProficiency in programming languages (e.g., Java, Python, C++) and frameworks.\nAbility to efficiently solve complex problems.\nExcellent communication skills and strong teamwork abilities.\nFamiliarity with software development tools and version control systems.\nGood knowledge of English (optional).\nOffer:\n\nWe offer a stimulating work environment and opportunities for professional growth in a growing company.",
"trace":false,
"confidenceThreshold": 0.95,
"inputLocale":"en-US",
"outputLocale":"fr-FR"
}
Response Example:
{
"data": {
"concepts": [
{
"confidence": 1.0,
"concept": {
"id": "KS122SG5Y0Q5YQM7V8KT",
"levelName": "Skill",
"parentId": "477",
"level": 2,
"name": "Débogage",
"skillType": "Specialized Skill",
"isSoftware": false,
"isLanguage": false,
"wikipediaLink": "https://en.wikipedia.org/wiki/Debugging",
"wikipediaExtract": "In computer programming and software development, debugging is the process of finding and resolving bugs within computer programs, software, or systems.",
"description": "Debugging involves finding and fixing errors, anomalies or bugs in computer software or hardware. It is a specialized skill that requires a thorough understanding of programming languages, system and network architecture, as well as problem-solving and analytical abilities. Effective debugging can help improve the performance and reliability of computer systems, and can be invaluable in ensuring the smooth functioning of complex software applications.",
"descriptionSource": "Lightcast"
}
},
{
"confidence": 1.0,
"concept": {
"id": "KS1222G6RD9GBB7Q6FY5",
"levelName": "Skill",
"parentId": "477",
"level": 2,
"name": "Révision De Code",
"skillType": "Specialized Skill",
"isSoftware": false,
"isLanguage": false,
"wikipediaLink": "https://en.wikipedia.org/wiki/Code_review",
"wikipediaExtract": "Code review is a software quality assurance activity in which one or several people check a program mainly by viewing and reading parts of its source code, and they do so after implementation or as an interruption of implementation. At least one of the persons must not be the code's author. The persons performing the checking, excluding the author, are called \"reviewers\".",
"description": "Code review is a process in which software developers review each other's code to identify bugs, suggest improvements, and ensure that the code meets quality standards. It requires specialized skills, including knowledge of programming concepts, expertise in the programming language, and an understanding of software development best practices. The code reviewer must also possess good communication skills to provide clear and constructive feedback to the developer. A well-trained code reviewer can catch errors early in the development cycle, resulting in higher-quality code and more efficient development.",
"descriptionSource": "Lightcast"
}
},
{
"confidence": 1.0,
"concept": {
"id": "KS1219W70LY1GXZDSKW5",
"levelName": "Skill",
"parentId": "379",
"level": 2,
"name": "C++ (Langage De Programmation)",
"skillType": "Specialized Skill",
"isSoftware": true,
"isLanguage": false,
"wikipediaLink": "https://en.wikipedia.org/wiki/C%2B%2B",
"wikipediaExtract": "C++ is a general-purpose programming language created by Bjarne Stroustrup as an extension of the C programming language, or \"C with Classes\". The language has expanded significantly over time, and modern C++ now has object-oriented, generic, and functional features in addition to facilities for low-level memory manipulation. It is almost always implemented as a compiled language, and many vendors provide C++ compilers, including the Free Software Foundation, LLVM, Microsoft, Intel, Oracle, and IBM, so it is available on many platforms.",
"description": "C++ is a programming language commonly used for developing operating systems, browsers, games, and other complex software applications. It is an extension of the C programming language and includes features such as object-oriented programming, templates, and exception handling. Proficiency in C++ requires knowledge of its syntax, data types, control structures, memory management, and libraries.",
"descriptionSource": "Lightcast"
}
},
{
"confidence": 1.0,
"concept": {
"id": "KS123K75YYK8VGH90NCS",
"levelName": "Skill",
"parentId": "498",
"level": 2,
"name": "Langue Anglaise",
"skillType": "Common Skill",
"isSoftware": false,
"isLanguage": true,
"wikipediaLink": "https://en.wikipedia.org/wiki/English_language",
"wikipediaExtract": "English is a West Germanic language first spoken in early medieval England, which has eventually become the leading language of international discourse in the 21st century. It is named after the Angles, one of the ancient Germanic peoples that migrated to the area of Great Britain that later took their name, England. Both names derive from Anglia, a peninsula on the Baltic Sea. English is most closely related to Frisian and Low Saxon, while its vocabulary has been significantly influenced by other Germanic languages, particularly Old Norse, as well as Latin and French.",
"description": "English language is a widely spoken language across the world and is considered a common skill. It is used as a means of communication in various areas such as education, business, and social interactions. Having a good command of English language can open up numerous opportunities and enhance one's global reach.",
"descriptionSource": "Lightcast"
}
},
{
"confidence": 1.0,
"concept": {
"id": "KS122WC71YYT5FVJT8WN",
"levelName": "Skill",
"parentId": "474",
"level": 2,
"name": "Essai De Développement",
"skillType": "Specialized Skill",
"isSoftware": false,
"isLanguage": false,
"wikipediaLink": "https://en.wikipedia.org/wiki/Development_testing",
"wikipediaExtract": "Development testing is a software development process that involves synchronized application of a broad spectrum of defect prevention and detection strategies in order to reduce software development risks, time, and costs.",
"description": "Development testing is a crucial process that involves testing software or application at various stages of the development lifecycle to ensure that it meets the desired specifications and requirements. It requires a specialized skill set, including knowledge of testing methodologies, automation tools, and programming languages. Development testers collaborate with developers, project managers, and other stakeholders to identify defects and ensure the quality of software or application under development. The ultimate goal of development testing is to deliver high-quality software products that meet the needs of end-users.",
"descriptionSource": "Lightcast"
}
},
{
"confidence": 1.0,
"concept": {
"id": "KS125LS6N7WP4S6SFTCK",
"levelName": "Skill",
"parentId": "471",
"level": 2,
"name": "Python (Langage De Programmation)",
"skillType": "Specialized Skill",
"isSoftware": true,
"isLanguage": false,
"wikipediaLink": "https://en.wikipedia.org/wiki/Python_(programming_language)",
"wikipediaExtract": "Python is an interpreted, high-level and general-purpose programming language. Python's design philosophy emphasizes code readability with its notable use of significant indentation. Its language constructs and object-oriented approach aim to help programmers write clear, logical code for small and large-scale projects.",
"description": "Python is a high-level, interpreted programming language known for its simplicity, readability, and ease of use. It is widely used for web development, scientific computing, data analysis and visualization, artificial intelligence and machine learning. It has a large ecosystem of libraries and frameworks that make it a popular choice for developers. Its syntax is easy to read and understand, making it a good first language for beginners to learn.",
"descriptionSource": "Lightcast"
}
},
{
"confidence": 1.0,
"concept": {
"id": "KS120076FGP5WGWYMP0F",
"levelName": "Skill",
"parentId": "437",
"level": 2,
"name": "Java (Langage De Programmation)",
"skillType": "Specialized Skill",
"isSoftware": true,
"isLanguage": false,
"wikipediaLink": "https://en.wikipedia.org/wiki/Java_(programming_language)",
"wikipediaExtract": "Java is a class-based, object-oriented programming language that is designed to have as few implementation dependencies as possible. It is a general-purpose programming language intended to let application developers write once, run anywhere (WORA), meaning that compiled Java code can run on all platforms that support Java without the need for recompilation. Java applications are typically compiled to bytecode that can run on any Java virtual machine (JVM) regardless of the underlying computer architecture. The syntax of Java is similar to C and C++, but has fewer low-level facilities than either of them. The Java runtime provides dynamic capabilities that are typically not available in traditional compiled languages. As of 2019, Java was one of the most popular programming languages in use according to GitHub, particularly for client-server web applications, with a reported 9 million developers.",
"description": "Java is a popular high-level programming language used for building applications and software across various platforms. It is object-oriented, robust, and secure, making it ideal for complex software development. Java is also known for its flexibility, dynamic performance, and versatility, which allow developers to create a wide range of software applications, from mobile apps to web-based services. Java is widely used in various industries, including banking, healthcare, education, and entertainment.",
"descriptionSource": "Lightcast"
}
},
{
"confidence": 1.0,
"concept": {
"id": "KS440QS66YCBN23Y8K25",
"levelName": "Skill",
"parentId": "474",
"level": 2,
"name": "Ingénierie Logicielle",
"skillType": "Specialized Skill",
"isSoftware": false,
"isLanguage": false,
"wikipediaLink": "https://en.wikipedia.org/wiki/Software_engineering",
"wikipediaExtract": "Software engineering is the systematic application of engineering approaches to the development of software.",
"description": "Software Engineering is a specialized skill that involves the design, development, and maintenance of software applications. It requires knowledge of programming languages, software development methodologies, and tools to ensure quality and efficiency in the software development process. A software engineer is responsible for creating software products that meet customer requirements and provide reliable and efficient functionality. They must also test software, troubleshoot technical issues, and ensure the security and privacy of data. It is a constantly evolving field that requires continuous learning and adaptation to new technologies and industry trends.",
"descriptionSource": "Lightcast"
}
},
{
"confidence": 1.0,
"concept": {
"id": "ES80E93EF8629D5C793C",
"levelName": "Skill",
"parentId": "580",
"level": 2,
"name": "Résolution De Problèmes Complexes",
"skillType": "Common Skill",
"isSoftware": false,
"isLanguage": false,
"wikipediaLink": "https://en.wikipedia.org/wiki/Problem_solving",
"wikipediaExtract": "Problem solving is the process of achieving a goal by overcoming obstacles, a frequent part of most activities. Problems in need of solutions range from simple personal tasks to complex issues in business and technical fields. The former is an example of simple problem solving (SPS) addressing one issue, whereas the latter is complex problem solving (CPS) with multiple interrelated obstacles. Another classification is into well-defined problems with specific obstacles and goals, and ill-defined problems in which the current situation is troublesome but it is not clear what kind of resolution to aim for. Similarly, one may distinguish formal or fact-based problems requiring psychometric intelligence, versus socio-emotional problems which depend on the changeable emotions of individuals or groups, such as tactful behavior, fashion, or gift choices.",
"description": "Complex problem solving is a skill that involves analyzing and solving problems that are difficult or complicated. It is a common skill that is required in many different fields and industries, and involves the ability to break down complex problems, identify potential solutions, and take action to resolve the issue. This skill involves critical thinking, creativity, and the ability to work well under pressure.",
"descriptionSource": "Lightcast"
}
},
{
"confidence": 1.0,
"concept": {
"id": "KS1222C6WKYWRKRXQCR0",
"levelName": "Skill",
"parentId": "486",
"level": 2,
"name": "Contrôle Des Versions",
"skillType": "Specialized Skill",
"isSoftware": false,
"isLanguage": false,
"wikipediaLink": "https://en.wikipedia.org/wiki/Version_control",
"wikipediaExtract": "In software engineering, version control is a class of systems responsible for managing changes to computer programs, documents, large web sites, or other collections of information. Version control is a component of software configuration management.",
"description": "Version Control is a specialized skill that involves managing and tracking the changes made to a software project or document over time. This process allows for collaboration and organization among a team of developers, ensuring that everyone is working on the same version of the project and that changes are properly documented and approved before being implemented. Effective version control skills are essential for successful software development projects.",
"descriptionSource": "Lightcast"
}
},
{
"confidence": 1.0,
"concept": {
"id": "KSKJX44T33B6D4UCC8CB",
"levelName": "Skill",
"parentId": "581",
"level": 2,
"name": "Travailler En Équipe",
"skillType": "Common Skill",
"isSoftware": false,
"isLanguage": false,
"wikipediaLink": "https://en.wikipedia.org/wiki/Teamwork",
"wikipediaExtract": "Teamwork is the collaborative effort of a group to achieve a common goal or to complete a task in the most effective and efficient way. This concept is seen within the greater framework of a team, which is a group of interdependent individuals who work together towards a common goal. Basic requirements for effective teamwork are an adequate team size. The context is important, and team sizes can vary depending upon the objective. A team must include at least 2 or more members, and most teams range in size from 2 to 100. Sports teams generally have fixed sizes based upon set rules, and work teams may change in size depending upon the phase and complexity of the objective. Teams need to be able to leverage resources to be productive, and clearly defined roles within the team in order for everyone to have a clear purpose. Teamwork is present in any context where a group of people are working together to achieve a common goal. These contexts include an industrial organization, athletics, a school, and the healthcare system. In each of these settings, the level of teamwork and interdependence can vary from low, to intermediate, to high, depending on the amount of communication, interaction, and collaboration present between team members. E. g. Team work coordinates the work as early as possible",
"description": "Teamwork is the ability to work effectively and harmoniously with others towards a common goal. It involves being cooperative, communicative, and collaborative, as well as being able to contribute to and participate in group decision-making processes. Teamwork is a valued skill in many workplaces and is essential for successful project completion and overall business success.",
"descriptionSource": "Lightcast"
}
},
{
"confidence": 1.0,
"concept": {
"id": "KS1226Y6DNDT05G7FJ4J",
"levelName": "Skill",
"parentId": "363",
"level": 2,
"name": "Science Informatique",
"skillType": "Specialized Skill",
"isSoftware": false,
"isLanguage": false,
"wikipediaLink": "https://en.wikipedia.org/wiki/Computer_science",
"wikipediaExtract": "Computer science is the study of algorithmic processes, computational machines and computation itself. As a discipline, computer science spans a range of topics from theoretical studies of algorithms, computation and information to the practical issues of implementing computational systems in hardware and software.",
"description": "Computer Science is a field of study and practice concerned with computer systems, software, and algorithms. It involves designing, analyzing, and programming computers to perform specific tasks, as well as developing new technologies and applications. It is a specialized skill that involves a deep understanding of both theory and practice, and is increasingly essential in many sectors of the modern economy.",
"descriptionSource": "Lightcast"
}
}
]
},
"warnings": []
}
October 2023
1.5.0 (October 17)
Added support for localized taxonomy data
Taxonomy endpoints now support locale parameters where the underlying taxonomy has localized data available. To learn more about language and/or localization support for a particular taxonomy please refer to its documentation and changelog.
Taxonomy metadata responses now include a array of supported locales. If the taxonomy contains localized data, the supported locales will be listed in the supportedLocales metadata object.
{
"data": {
"name": "skills",
"version": "9.0.0",
"releaseStatus": "public",
"releaseDate": "09/28/2023 00:00:00",
"fields": [
"description",
"descriptionSource",
"id",
"isLanguage",
"isSoftware",
"level",
"levelName",
"name",
"parentId",
"skillType",
"wikipediaExtract",
"wikipediaLink"
],
"levels": [
"Category",
"Subcategory",
"Skill"
],
"supportedLocales": [
"en-US",
"en-GB",
"de-DE",
"es-ES",
"fr-FR",
"it-IT",
"nl-NL"
]
}
}
Taxonomies without explicit localization support return an empty array.
{
"data": {
"name": "skills",
"version": "8.41.0",
"releaseStatus": "public",
"releaseDate": "09/14/2023 00:00:00",
"fields": [
"",
"id",
"isLanguage",
"isSoftware",
"level",
"levelName",
"name",
"parentId",
"skillType",
"wikipediaExtract",
"wikipediaLink"
],
"levels": [
"category",
"subCategory",
"skill"
],
"supportedLocales": []
}
}
When a taxonomy has explicit localization support the locale parameter may be used to return results in the specified locale. Please note that not all fields are necessarily available in each locale. For details please visit the relevant documentation for the taxonomy in question. In general, if a field exists in the requested locale that value will be returned. Otherwise, the closest associated locale will be returned.
Example request with locale parameter:
https://classification.emsicloud.com/taxonomies/skills/versions/9.0.0/concepts/KS1233L645QDKLXSG1XY?locale=de-DE
Example response:
{
"data": {
"id": "KS1233L645QDKLXSG1XY",
"parentId": "479",
"level": 2,
"name": "Dokument-orientierte Datenbanken",
"skillType": "Specialized Skill",
"isSoftware": true,
"isLanguage": false,
"wikipediaLink": "https://en.wikipedia.org/wiki/Document-oriented_database",
"wikipediaExtract": "A document-oriented database, or document store, is a computer program and data storage system designed for storing, retrieving and managing document-oriented information, also known as semi-structured data."
},
"warnings": [],
"errors": []
}
1.4.0 (September 18)
New classifications/{release}/skills/extract endpoint availabile
classifications/{release}/skills/extract endpoint availabileNew /skills/extract endpoint added as of release 2023.18.
Request Example:
POST
https://classification.emsicloud.com/classifications/2023.18/skills/extract
{
"text": "... Great candidates also have\n\n Experience with a particular JS MV* framework (we happen to use React)\n Experience working with databases\n Experience with AWS\n Familiarity with microservice architecture\n Familiarity with modern CSS practices, e.g. LESS, SASS, CSS-in-JS ...",
"confidenceThreshold": 0.6,
"trace": true,
"inputLocale": "en"
}
Response Example:
{
"data": {
"concepts": [
{
"confidence": 1.0,
"concept": {
"id": "KSZX7YZWNR5IDR1I2VMZ",
"name": "Microservices",
"levelName": "skill",
"parentId": "474",
"level": 2,
"skillType": "Specialized Skill",
"isSoftware": false,
"isLanguage": false,
"wikipediaExtract": "Microservice architecture – a variant of the service-oriented architecture (SOA) structural style – arranges an application as a collection of loosely coupled services. In a microservices architecture, services are fine-grained and the protocols are lightweight."
}
},
{
"confidence": 1.0,
"concept": {
"id": "ES5A281A8917181656AD",
"name": "LESS",
"levelName": "skill",
"parentId": "491",
"level": 2,
"skillType": "Specialized Skill",
"isSoftware": true,
"isLanguage": false,
"wikipediaExtract": "Less is a dynamic preprocessor style sheet language that can be compiled into Cascading Style Sheets (CSS) and run on the client side or server side.\nDesigned by Alexis Sellier, Less is influenced by Sass and has influenced the newer \"SCSS\" syntax of Sass, which adapted its CSS-like block formatting syntax. Less is an open source. Its first version was written in Ruby; however, in the later versions, use of Ruby has been deprecated and replaced by JavaScript. The indented syntax of Less is a nested metalanguage, as valid CSS is valid Less code with the same semantics. Less provides the following mechanisms: variables, nesting, mixins, operators and functions; the main difference between Less and other CSS precompilers is that Less allows real-time compilation via less.js by the browser."
}
},
{
"confidence": 1.0,
"concept": {
"id": "ESFEFEFDBA0B3BC39881",
"name": "SASS",
"levelName": "skill",
"parentId": "471",
"level": 2,
"skillType": "Specialized Skill",
"isSoftware": true,
"isLanguage": false,
"wikipediaExtract": "Sass is a preprocessor scripting language that is interpreted or compiled into Cascading Style Sheets (CSS). SassScript is the scripting language itself."
}
},
{
"confidence": 0.9999996423721313,
"concept": {
"id": "KSDJCA4E89LB98JAZ7LZ",
"name": "React.js (Javascript Library)",
"levelName": "skill",
"parentId": "438",
"level": 2,
"skillType": "Specialized Skill",
"isSoftware": true,
"isLanguage": false,
"wikipediaExtract": "React is an open-source, front end, JavaScript library for building user interfaces or UI components. It is maintained by Facebook and a community of individual developers and companies.\nReact can be used as a base in the development of single-page or mobile applications. However, React is only concerned with state management and rendering that state to the DOM, so creating React applications usually requires the use of additional libraries for routing, as well as certain client-side functionality."
}
},
{
"confidence": 0.9999019503593445,
"concept": {
"id": "KS121F45VPV8C9W3QFYH",
"name": "Cascading Style Sheets (CSS)",
"levelName": "skill",
"parentId": "491",
"level": 2,
"skillType": "Specialized Skill",
"isSoftware": true,
"isLanguage": false,
"wikipediaExtract": "Cascading Style Sheets (CSS) is a style sheet language used for describing the presentation of a document written in a markup language such as HTML. CSS is a cornerstone technology of the World Wide Web, alongside HTML and JavaScript."
}
},
{
"confidence": 0.9994209408760071,
"concept": {
"id": "KS1200771D9CR9LB4MWW",
"name": "JavaScript (Programming Language)",
"levelName": "skill",
"parentId": "471",
"level": 2,
"skillType": "Specialized Skill",
"isSoftware": true,
"isLanguage": false,
"wikipediaExtract": "JavaScript, often abbreviated as JS, is a programming language that conforms to the ECMAScript specification. JavaScript is high-level, often just-in-time compiled, and multi-paradigm. It has curly-bracket syntax, dynamic typing, prototype-based object-orientation, and first-class functions."
}
},
{
"confidence": 0.9805825352668762,
"concept": {
"id": "KS120FG6YP8PQYYNQY9B",
"name": "Amazon Web Services",
"levelName": "skill",
"parentId": "494",
"level": 2,
"skillType": "Specialized Skill",
"isSoftware": true,
"isLanguage": false,
"wikipediaExtract": "Amazon Web Services (AWS) is a subsidiary of Amazon providing on-demand cloud computing platforms and APIs to individuals, companies, and governments, on a metered pay-as-you-go basis. These cloud computing web services provide a variety of basic abstract technical infrastructure and distributed computing building blocks and tools. One of these services is Amazon Elastic Compute Cloud (EC2), which allows users to have at their disposal a virtual cluster of computers, available all the time, through the Internet. AWS's version of virtual computers emulates most of the attributes of a real computer, including hardware central processing units (CPUs) and graphics processing units (GPUs) for processing; local/RAM memory; hard-disk/SSD storage; a choice of operating systems; networking; and pre-loaded application software such as web servers, databases, and customer relationship management (CRM)."
}
}
],
"trace": [
{
"classificationData": {
"contextForms": [
{
"sourceEnd": 232,
"sourceStart": 229,
"value": "CSS"
},
{
"sourceEnd": 264,
"sourceStart": 261,
"value": "CSS"
}
],
"concepts": [
{
"id": "KS1200771D9CR9LB4MWW",
"confidence": 0.9994209408760071
}
]
},
"surfaceForm": {
"sourceEnd": 64,
"sourceStart": 62,
"value": "JS"
}
},
{
"classificationData": {
"contextForms": [
{
"sourceEnd": 64,
"sourceStart": 62,
"value": "JS"
},
{
"sourceEnd": 78,
"sourceStart": 69,
"value": "framework"
},
{
"sourceEnd": 159,
"sourceStart": 156,
"value": "AWS"
},
{
"sourceEnd": 232,
"sourceStart": 229,
"value": "CSS"
},
{
"sourceEnd": 264,
"sourceStart": 261,
"value": "CSS"
},
{
"sourceEnd": 270,
"sourceStart": 268,
"value": "JS"
}
],
"concepts": [
{
"id": "KSDJCA4E89LB98JAZ7LZ",
"confidence": 0.9999996423721313
}
]
},
"surfaceForm": {
"sourceEnd": 102,
"sourceStart": 97,
"value": "React"
}
},
{
"classificationData": {
"contextForms": [
{
"sourceEnd": 138,
"sourceStart": 129,
"value": "databases"
},
{
"sourceEnd": 203,
"sourceStart": 191,
"value": "architecture"
}
],
"concepts": [
{
"id": "KS120FG6YP8PQYYNQY9B",
"confidence": 0.9805825352668762
}
]
},
"surfaceForm": {
"sourceEnd": 159,
"sourceStart": 156,
"value": "AWS"
}
},
{
"classificationData": {
"contextForms": [],
"concepts": [
{
"id": "KSZX7YZWNR5IDR1I2VMZ",
"confidence": 1.0
}
]
},
"surfaceForm": {
"sourceEnd": 190,
"sourceStart": 178,
"value": "microservice"
}
},
{
"classificationData": {
"contextForms": [
{
"sourceEnd": 64,
"sourceStart": 62,
"value": "JS"
},
{
"sourceEnd": 102,
"sourceStart": 97,
"value": "React"
},
{
"sourceEnd": 270,
"sourceStart": 268,
"value": "JS"
}
],
"concepts": [
{
"id": "KS121F45VPV8C9W3QFYH",
"confidence": 0.9999019503593445
}
]
},
"surfaceForm": {
"sourceEnd": 232,
"sourceStart": 229,
"value": "CSS"
}
},
{
"classificationData": {
"contextForms": [],
"concepts": [
{
"id": "ES5A281A8917181656AD",
"confidence": 1.0
},
{
"id": "ESFEFEFDBA0B3BC39881",
"confidence": 1.0
}
]
},
"surfaceForm": {
"sourceEnd": 259,
"sourceStart": 249,
"value": "LESS, SASS"
}
},
{
"classificationData": {
"contextForms": [
{
"sourceEnd": 64,
"sourceStart": 62,
"value": "JS"
},
{
"sourceEnd": 102,
"sourceStart": 97,
"value": "React"
},
{
"sourceEnd": 270,
"sourceStart": 268,
"value": "JS"
}
],
"concepts": [
{
"id": "KS121F45VPV8C9W3QFYH",
"confidence": 0.9999019503593445
}
]
},
"surfaceForm": {
"sourceEnd": 264,
"sourceStart": 261,
"value": "CSS"
}
},
{
"classificationData": {
"contextForms": [
{
"sourceEnd": 232,
"sourceStart": 229,
"value": "CSS"
},
{
"sourceEnd": 264,
"sourceStart": 261,
"value": "CSS"
}
],
"concepts": [
{
"id": "KS1200771D9CR9LB4MWW",
"confidence": 0.9994209408760071
}
]
},
"surfaceForm": {
"sourceEnd": 270,
"sourceStart": 268,
"value": "JS"
}
}
]
},
"warnings": []
}
1.3.0 (September 15)
Added employmentType as an available output for the /postings/classify endpoint
employmentType as an available output for the /postings/classify endpointRequest Example:
{
"context": {
"company": "Starpoint Solutions",
"title": "CCL Software Engineer II",
"body": "This is a sample job posting for a full-time Programmer. The salary starts at $70,000 per year. You should have 6 years of experience in software development, including 4 years using AWS cloud services. Our company offers great benefits like a 401K. Employees love to work for us."
},
"outputs": [
"skill",
"employmentType",
"title",
]
}
Response Example:
{
"data": {
"employmentType": {
"provisionalId": "Full-time (> 32 hours)"
},
"skill": [
{
"id": "ES43DB1E2DEC412F3A26",
"confidence": 1
},
{
"id": "KS120FG6YP8PQYYNQY9B",
"confidence": 0.9805825352668762
},
{
"id": "KS120L96KMYTDJ48NRSH",
"confidence": 0.6632477045059204
}
],
"title": {
"id": "ET6850661D6AE5FA86",
"confidence": 0.7492184042930603
}
},
"warnings": []
}
August 2023
1.2.0 (August 17)
Added context property to mapping metadata response
context property to mapping metadata responseThe mapping metadata response was expanded to include a "context" property to facilitate disambiguation when more than one mapping between a given source and destination taxonomy are available. When no context is associated with the mapping null is returned.
April 2023
1.1.0 (April 14)
Resource name change from occupations to lot
occupations to lotThe Lightcast Occupations Taxonomy up to version 6.1.2 was referred to using the name "occupations". Starting with version 6.1.3, the name "lot" is used to refer to this resource.
March 2023
1.1.0 (March 31)
Response Structure Changes to /postings/classify
/postings/classifyAffecting releases 2023.6 and on
Classification outputs changed to consist of either an object or an array of objects.
{
"data": {
"cip": null,
"company": {
"id": "38076262"
},
"educationLevel": null,
"lot": {
"id": "23171541",
"confidence": 1
},
"naics": {
"id": "541519"
},
"onet": {
"id": "15-1252.00"
},
"remoteType": {
"provisionalId": "[None]"
},
"salary": {
"gte": 70000,
"lte": 70000,
"units": "USD"
},
"skill": [
{
"id": "ES43DB1E2DEC412F3A26",
"confidence": 1
},
{
"id": "KS120FG6YP8PQYYNQY9B",
"confidence": 0.9805825352668762
},
{
"id": "KS120L96KMYTDJ48NRSH",
"confidence": 0.6632477045059204
}
],
"soc": {
"id": "15-1250"
},
"title": {
"id": "ET6850661D6AE5FA86",
"confidence": 0.7498955726623535
},
"yearsOfExperience": {
"gte": 0,
"lte": 6,
"units": "year"
}
},
"warnings": []
}
In the event that a classification cannot be performed, the response now consists of a reference to the "unclassified" concept within a taxonomy, null or an empty array. For example,
{
"data": {
"company": null,
"educationLevel": null,
"lot": null,
"naics": null,
"remoteType": {
"provisionalId": "[None]"
},
"salary": null,
"skill": [],
"title": {
"id": "ET0000000000000000",
"confidence": 1
},
"yearsOfExperience": null
},
"warnings": []
}