Skip to content
  • There are no suggestions because the search field is empty.

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