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 apisupport@emsibg.com.

December 2025

1.22.0 (December 16)

Extra input locales available in /lot/classify endpoint Starting with release 2025.12, the /lot/classify endpoint can accept the following new inputLocale values:

es-ES
fr-FR
de-DE
en-XX (meaning any locale whose language is English) Request Example:

POST

https://classification.emsicloud.com/classifications/2025.13/lot/classify

{
  "title": "Ingénieur logiciel",
  "description": "Un ingénieur logiciel est responsable de la conception, du développement, de l’implémentation et de la maintenance d’applications logicielles. Ses missions comprennent l’analyse des besoins, la définition d’architectures logicielles adaptées, ainsi que l’écriture, les tests et la documentation du code. Il collabore étroitement avec d’autres équipes, telles que la gestion de produit, l’assurance qualité et les opérations, afin de garantir des solutions stables, sécurisées et performantes. Le diagnostic et la correction des anomalies, l’optimisation des systèmes existants ainsi que l’amélioration continue des applications font également partie de ses responsabilités principales.",
  "fields": [
    "level",
    "id",
    "name",
    "parentId"
  ],
  "confidenceThreshold": 0.7,
  "inputLocale":"fr-FR"
}

Response Example

{
    "data": [
        {
            "confidence": 1.0,
            "concept": {
                "id": "23171541",
                "levelName": "specializedOccupation",
                "name": "Software Developer / Engineer",
                "parentId": "231715",
                "level": 3
            }
        }
    ],
    "warnings": []
}

October 2025

1.21.0 (October 21)

`benefits` output available in `/postings/classify` endpoint

Starting with release 2025.11, the /postings/classify endpoint can return benefits data from a text body using the new benefits output value.

Request Example:

POST

https://classification.emsicloud.com/classifications/2025.11/postings/classify

{
  "context": {
    "company": "Trellis IO",
    "title": "Software Engineer",
    "body": "Join our growing engineering team and help build reliable, scalable systems used by thousands of customers worldwide. You’ll work alongside talented developers who value clean code, collaboration, and continuous learning.\n\nWhy you’ll love working here:\n\n Competitive salary with annual performance bonuses\n\n Comprehensive health insurance\n\n Flexible hybrid schedule — work from home 3 days a week\n\n Professional growth budget for conferences, courses, or certifications\n\n Generous PTO\n\n Cutting-edge tech stack and opportunities to explore new tools\n\nIf you’re passionate about building great software and want to grow in a supportive, innovative environment, we’d love to hear from you."
  },
    "findConceptNames": true,
  "outputs": [
    "benefits"
  ]
}

Response Example:

{
    "data": {
        "benefits": [
            {
                "id": "1010",
                "name": "Health Insurance"
            },
            {
                "id": "1024",
                "name": "Paid Time Off (PTO)"
            },
            {
                "id": "1041",
                "name": "Remote/Hybrid Work"
            }
        ]
    },
    "warnings": []
}

1.20.0 (October 9)

`/skills/classify` endpoint publicly released

The /skills/classify endpoint is available for all releases of 2025 and further. It classifies a list of skills, each with a name and an optional description.

Request Example:

POST

https://classification.emsicloud.com/classifications/2025.10/skills/classify

{
    "skills": [
        {
            "name": "Docker",
            "description": "A type of container for software"
        },
        {
            "name": "Framing",
            "description": "Constructing the frame of a house"
        },
        {
            "name": "Framing",
            "description": "Putting pictures in a frame"
        }
    ],
    "limit": 2,
    "fields": [
        "id",
        "name",
        "levelName",
        "level",
        "parentId"
    ]
}

Response Example:

{
    "data": [
        {
            "term": "Docker",
            "count": 2,
            "results": [
                {
                    "confidence": 1.0,
                    "concept": {
                        "id": "KSY4WFI1S164RQUBSPCC",
                        "levelName": "Skill",
                        "name": "Docker (Software)",
                        "parentId": "476",
                        "level": 2
                    }
                },
                {
                    "confidence": 0.7516252398490906,
                    "concept": {
                        "id": "KS6J3XWZEB5IQYXJE27M",
                        "levelName": "Skill",
                        "name": "Docker Container",
                        "parentId": "476",
                        "level": 2
                    }
                }
            ]
        },
        {
            "term": "Framing",
            "count": 2,
            "results": [
                {
                    "confidence": 0.7239595055580139,
                    "concept": {
                        "id": "KS124376BRZDJ0CZ79VT",
                        "levelName": "Skill",
                        "name": "Framing (Construction)",
                        "parentId": "140",
                        "level": 2
                    }
                },
                {
                    "confidence": 0.7095146179199219,
                    "concept": {
                        "id": "ES43860FADFFC025A09D",
                        "levelName": "Skill",
                        "name": "Framing And Trim",
                        "parentId": "131",
                        "level": 2
                    }
                }
            ]
        },
        {
            "term": "Framing",
            "count": 2,
            "results": [
                {
                    "confidence": 0.7729793787002563,
                    "concept": {
                        "id": "KS127TX62KW7J6C5SJK2",
                        "levelName": "Skill",
                        "name": "Picture Framing",
                        "parentId": "539",
                        "level": 2
                    }
                },
                {
                    "confidence": 0.6218518614768982,
                    "concept": {
                        "id": "ES43860FADFFC025A09D",
                        "levelName": "Skill",
                        "name": "Framing And Trim",
                        "parentId": "131",
                        "level": 2
                    }
                }
            ]
        }
    ],
    "warnings": []
}

The meta endpoint can be used to determine which locales are available.

Request Example:

GET

https://classification.emsicloud.com/classifications/2025.10/skills/classify

Response Example:

{
    "data": {
        "locales": {
            "inputs": [
                "en-US"
            ],
            "outputs": [
                "cs-CZ",
                "da-DK",
                "de-DE",
                "en-CA",
                "en-GB",
                "en-US",
                "es-ES",
                "fr-FR",
                "hr-HR",
                "hu-HU",
                "it-IT",
                "ja-JP",
                "ko-KR",
                "nl-NL",
                "pl-PL",
                "pt-PT",
                "ro-RO",
                "sv-SE",
                "zh-CN"
            ]
        }
    }
}

September 2025

1.19.0 (September 22)

`/skills/extract` endpoint can extract from Chinese, Japanese, and Korean text starting with release `2025.10`

The /skills/extract endpoint of release 2025.10 can accept the following new inputLocale values:

ja-JP
ko-KR
zh-CN
zh-HK
zh-TW

Note: Document position tracing is not currently available for these new languages. Setting a value of true to the trace parameter will yield an empty response.

Request Example:

POST

https://classification.emsicloud.com/classifications/2025.10/skills/extract

{
    "text": "瑞典食品屋及小餐馆主管/成都成华 3.7 3.7 星，满分 5 星 成都市 全职 IKEA 12,584个点评 查看来自员工的点评 >职位详情 此处显示了职位详情与您 的匹配情况。 职位类型 全职 地点 成都市 完整的职位描述 Job ID: 20291CN Date posted: 27/07/2024 你需要拥有什么 \n'- 具备餐饮服务经验3年，并曾承担过团队管>理角色 喜欢快节奏的工作氛围，乐于学习发展，积极 以销售和服务顾客为导向，具备一定的商业思维 具备良好的沟通协作能力 有基本英文读写能力 \n你的工作职责 \n'- 为宜家瑞典食品屋及小餐馆区域制>定商业战略，以最大限度地提高销售和盈利能力。 发起商业活动，吸引商场访客，提高访问率，或者采取其他活动来保证生产率。 确保遵循“宜家食品质量与安全”政策和流程。 确保我的区域得到有效管理，>保证该区域干净及富有吸引力，为顾客提供良好的的购物体验 以身作则，积极沟通，赋予团队伙伴独立行动的能力，支持高绩效团队的发展 \n关于这个职能 \n吸引访客光临宜家商场，力求吸引他们在宜家商>场内停留更长时间、享受更多乐趣；并为他们营造轻松愉悦的氛围；通过提供物美价廉的食物，令访客因美味的回忆不断光临宜家商场； 您必须先创建 Indeed 账户，才能继续访问公司网站进行申请",
    "confidenceThreshold": 0.6,
    "inputLocale": "zh-CN",
    "outputLocale": "en-US"
}

Response Example:

{
    "data": {
        "concepts": [
            {
                "confidence": 1.0,
                "concept": {
                    "id": "ES2F6F5F8B1B5385A9A5",
                    "parentId": "351",
                    "level": 2,
                    "levelName": "Skill",
                    "name": "Meal Service",
                    "skillType": "Specialized Skill",
                    "isSoftware": false,
                    "isLanguage": false,
                    "description": "Meal service is the skill of delivering meals to people in a professional and efficient manner. It requires knowledge of food safety, nutritional guidelines, portion control, customer service, and time management. Meal service can be performed in various settings, such as restaurants, hospitals, schools, and catering companies. This specialized skill is crucial in ensuring that people receive healthy and delicious meals that meet their dietary needs and preferences.",
                    "descriptionSource": "LIGHTCAST"
                }
            },
            {
                "confidence": 1.0,
                "concept": {
                    "id": "ESBF952629C36426E564",
                    "parentId": "578",
                    "level": 2,
                    "levelName": "Skill",
                    "name": "Willingness To Learn",
                    "skillType": "Common Skill",
                    "isSoftware": false,
                    "isLanguage": false,
                    "wikipediaLink": "https://en.wikipedia.org/wiki/Learning",
                    "wikipediaExtract": "Learning is the process of acquiring new understanding, knowledge, behaviors, skills, values, attitudes, and preferences. The ability to learn is possessed by humans, animals, and some machines; there is also evidence for some kind of learning in certain plants. Some learning is immediate, induced by a single event, but much skill and knowledge accumulate from repeated experiences. The changes induced by learning often last a lifetime, and it is hard to distinguish learned material that seems to be \"lost\" from that which cannot be retrieved.",
                    "description": "Willingness to learn is a soft skill that refers to a person's eagerness and openness to learning new skills, knowledge, and experiences. It is considered essential for personal and professional growth and development. Being willing to learn allows individuals to adapt to changing situations and helps them to be more effective in their roles. It involves being open-minded, curious, and eager to acquire new skills and knowledge through self-directed learning, continuous professional development, and constructive feedback. Developing a willingness to learn is also key to being a lifelong learner.",
                    "descriptionSource": "LIGHTCAST"
                }
            },
            {
                "confidence": 1.0,
                "concept": {
                    "id": "KS122556LMQ829GZCCRV",
                    "parentId": "576",
                    "level": 2,
                    "levelName": "Skill",
                    "name": "Communication",
                    "skillType": "Common Skill",
                    "isSoftware": false,
                    "isLanguage": false,
                    "wikipediaLink": "https://en.wikipedia.org/wiki/Communication",
                    "wikipediaExtract": "Communication is the act of developing meaning among entities or groups through the use of sufficiently mutually understood signs, symbols, and semiotic conventions.",
                    "description": "Communication is the ability to effectively interact, convey information, and collaborate with others in a clear and understandable manner. It involves the skill of translating complex data and information into a format that is comprehensible to diverse audiences. This skill is crucial in professional, personal, and academic settings, enabling individuals to exchange ideas, solve problems, and work together harmoniously. Effective communication fosters understanding and cooperation, making it an essential component of successful relationships and organizations.",
                    "descriptionSource": "LIGHTCAST"
                }
            },
            {
                "confidence": 1.0,
                "concept": {
                    "id": "KS7AASDV6UOE7VFBGF4D",
                    "parentId": "576",
                    "level": 2,
                    "levelName": "Skill",
                    "name": "Collaboration",
                    "skillType": "Common Skill",
                    "isSoftware": false,
                    "isLanguage": false,
                    "wikipediaLink": "https://en.wikipedia.org/wiki/Collaboration",
                    "wikipediaExtract": "Collaboration is the process of two or more people, entities or organizations working together to complete a task or achieve a goal. Collaboration is similar to cooperation. Most collaboration requires leadership, although the form of leadership can be social within a decentralized and egalitarian group. Teams that work collaboratively often access greater resources, recognition and rewards when facing competition for finite resources.",
                    "description": "Collaboration is a common skill that is essential for success in many fields. It involves working together with others to achieve a common goal, communicating effectively, and being open to new ideas and perspectives. Collaboration skills can be learned and improved through practice, and are highly valued by employers and organizations. Collaboration can be achieved through various tools and methods, such as virtual collaboration software, team building exercises, and group brainstorming sessions.",
                    "descriptionSource": "LIGHTCAST"
                }
            },
            {
                "confidence": 1.0,
                "concept": {
                    "id": "KS123K75YYK8VGH90NCS",
                    "parentId": "498",
                    "level": 2,
                    "levelName": "Skill",
                    "name": "English Language",
                    "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": "KS120886PW26CKLQ11T1",
                    "parentId": "498",
                    "level": 2,
                    "levelName": "Skill",
                    "name": "Literacy",
                    "skillType": "Common Skill",
                    "isSoftware": false,
                    "isLanguage": false,
                    "wikipediaLink": "https://en.wikipedia.org/wiki/Literacy",
                    "wikipediaExtract": "Literacy is popularly understood as an ability to read and write in at least one method of writing, an understanding reflected by mainstream dictionaries.",
                    "description": "Literacy is the ability to read, write, and comprehend information. It is considered a common skill that is essential for individuals to be successful in both their personal and professional lives. It provides a foundation for communication, knowledge acquisition, and critical thinking skills. Literacy skills are typically developed during early childhood education and continue to be refined throughout a person's lifetime.",
                    "descriptionSource": "LIGHTCAST"
                }
            }
        ]
    },
    "warnings": []
}

May 2025

1.18.0 (May 20)

`/postings/classify` endpoint can return concept names

The /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`

The /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.

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

New 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

Request 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

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": "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

Request 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

Request 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

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

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

Request 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

New 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

New 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

New /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

Request 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

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

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

Affecting 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": []
}

Changelog

Aggregate CA Profiles Changelog

Global Profiles Changelog

Talent Benchmark Changelog

Classification Changelog