Skill Premium by Occupation API Guide
Skill Premium by Occupation API helps you understand the value of specific skills by revealing how much additional salary they command within a given role.
This allows you to prioritize high-value skills in training, align compensation strategies with market signals, and support meaningful career conversations.
It empowers learning, talent, and workforce strategy teams to link compensation and upskilling through data-backed decisions.
Who is this API for?
This API is designed for teams responsible for compensation planning, role design, or talent development. In particular:
-
Learning Manager – identifying which skills lead to higher earning potential to inform upskilling priorities
-
People Strategist – aligning critical skills with organizational pay strategy
-
Workforce Planner – identifying high-premium skills to future-proof roles
-
Talent Recruiter – refining job ads and sourcing strategies by focusing on market-valued skills
-
People Analyst – supporting compensation analysis and business cases with concrete salary differentials
Goals this API helps you achieve
The Skill Premium by Occupation API directly supports:
-
Analyze role-specific skills by understanding which ones drive compensation uplift
-
Standardize roles and salaries using real-time, skill-level salary benchmarks
-
Identify high-impact training targets by comparing salary gaps with and without the skill
-
Support career progression conversations with evidence of value-added skills
What’s included in the API?
For any occupation, this API returns a list of skills that offer a measurable salary premium, along with supporting metadata:
| Field | Description |
|---|---|
| Skill Name | The skill for which premium analysis is calculated |
| Median Salary with Skill | Median salary in job ads requiring this skill |
| Median Salary without Skill | Median salary in job ads not mentioning this skill |
| Salary Gap | The difference in median salary, indicating premium value |
| Job Ad Count (with/without) | Number of job ads analyzed with and without the skill |
| Confidence Level | High/Medium/Low – indicates how reliable the salary premium is based on data volume and consistency |
This helps teams spot which skills materially impact pay — and where to focus learning or hiring.
Input and Output
Input required:
-
An Occupation — selected by ontology code
-
Optional: Country (default is US)
Output includes:
-
A ranked list of skills associated with that occupation
-
Median salary with and without each skill
-
Salary gap in dollars
-
Number of job ads with and without each skill
-
Confidence level rating for each premium value
Real-world applications
Use cases include:
-
Prioritize training programs for skills with the highest ROI in compensation
-
Benchmark pay for internal roles against market expectations
-
Design differentiated job descriptions based on premium-driving skills
-
Build compensation equity by aligning pay with skill-based expectations
-
Support mobility plans by highlighting which new skills can justify raises
API Bundle
This API is available in the following bundle:
Skill Analysis & Development - Ideal for teams focused on capability-building, role architecture, and compensation analytics