Salary.com
Home API MCP
Home
API
Welcome to the Salary.com API
Data as a Service CompAnalyst and JobArchitect

Data as a Service

Introduction & AI
Behavior Request Field Definitions Response Field Definitions Match a Job POST Batch Match Jobs POST Match a Job (Verbose) POST Batch Match Jobs (Verbose) POST
Behavior Request Field Definitions Response Field Definitions Match a Job POST Match a Job (Verbose) POST

CompAnalyst

Get an Employee GET Get Employee List GET Create an Employee POST Update an Employee PUT Delete an Employee DELETE
Get a Company Job GET Get Company Job List GET Create a Company Job POST Update a Company Job PUT
Get Composite List GET Get Composite by Job Code GET

JobArchitect

Get Job Description List GET Get a Job Description Details GET
Get Skills GET

Reference

Employees Company Jobs Salary Plan Competencies Composites JobArchitect Skills
Change Log
MCP
Welcome to Salary.com MCP Authentication

CompAnalyst Market Data Tools

Overview
getMarketRate getBenchmarkJobDetails findBenchmarkMatches compareToMarket Shared Fields & Filters

SalaryIQ Labor Market Tools

Overview
getPostingTrends getTrendingSkills getHiringCompanies summarizeLaborMarket Shared Fields & Filters

Reference

Resources
×
Back
Welcome to Salary.com MCP Authentication

CompAnalyst Market Data Tools

Overview Market Data Tools
getMarketRate getBenchmarkJobDetails findBenchmarkMatches compareToMarket Shared Fields & Filters

SalaryIQ Labor Market Tools

Overview Labor Market Tools
getPostingTrends getTrendingSkills getHiringCompanies summarizeLaborMarket Shared Fields & Filters

Reference

Resources

Shared Fields and Filters

Common request and filter fields

  • jobTitle: Free-text role title used to match the request to a benchmark job.
  • jobDescription: Free-text role context used to improve benchmark matching, especially when the title alone is ambiguous or incomplete.
  • jobCode: Stable benchmark identifier for a Salary.com benchmark job. Use this when the client already knows the exact benchmark to retrieve or price.
  • country / state / city / zipCode: Geography inputs used to define the market scope for pricing and matching. The service normalizes the request to a supported geography in the response. For U.S. requests, zipCode takes priority when it is provided.
  • naicsCode: Optional industry filter used to narrow the market to a specific NAICS scope. The user may provide a 2-, 3-, 4-, 5-, or 6-digit NAICS code, and the service will roll it up or normalize it to the industry scope used in the response.
  • companySize: Optional company-size filter used to narrow the market by FTE range or revenue range. The user may provide a free-input value, and the service maps it to the appropriate supported bucket.
  • payValue: Submitted compensation amount used by CompareToMarket. In the current version, payValue supports base-salary comparison only. The user may provide any pay value.
  • requestedCompensation: Optional JSON object used by getMarketRate to specify which Salary and Comp percentiles to return, and whether BonusTarget and LTI should be included. If omitted, the default response returns P25, P50, and P75.

    Salary: Array of integer percentiles to return for salary data. Values must be multiples of 10, for example [10, 20, 30] except 25 and 75.

    Comp: Array of integer percentiles to return for total-compensation data. Values must be multiples of 10, for example [10, 20, 30, 40, 50, 60, 70, 80, 90].

    BonusTarget: Boolean indicating whether bonus target data should be included.

    LTI: Boolean indicating whether long-term incentive data should be included.

    {
      "Salary": [25, 50, 75],
      "Comp": [25, 50, 75],
      "BonusTarget": true,
      "LTI": true
    }
  • sessionId: Optional client or runtime tracking value when supported by the MCP implementation. It is useful for request tracing or client continuity, but it is not a compensation output field.

Common CAMD response fields

  • datasetRoutedTo: Identifies the dataset that served the response. CAMD tool responses return MarketData.
  • matchRating: Confidence level for the benchmark match and the returned attributes.
    Confident: greater than or equal to 90%
    Potential: between 75% and 89%
    Needs Review: less than 75%
  • normalizedGeography: The geography actually applied after request normalization. It may include country, region, state, and city.
  • normalizedIndustry: The industry scope applied after request normalization. This returns the NAICS description rather than the raw code.
  • normalizedCompanySize: The company-size scope applied after request normalization. Depending on the request, this may return an FTE bucket or a revenue bucket.
  • benchmarkJobTitle: The standardized benchmark title selected for the role.
  • socCode / socTitle: Standard Occupational Classification mapping returned for the matched benchmark when available.
  • summary / summaryText: Natural-language explanation of the result, intended to make the output easier to interpret.
  • jobFamilyName: Name of the benchmark job family associated with the matched role.
  • jobLevelName: Benchmark level or level label associated with the matched role.
  • jobSummary: Short benchmark-role overview.
  • jobDescription: Full benchmark-role description used for explanation and review workflows.
  • educationDegree: Highest education level associated with the benchmark role.
  • experienceYearMin / experienceYearMax: Minimum and maximum experience range associated with the benchmark role.
  • skills: Benchmark skill list associated with the matched role.
  • comparisonPosition: Labeled market position of the submitted pay value relative to the returned percentiles.
  • salary10–salary90: Returned salary percentile values for the requested market scope.
  • comp10–comp90: Returned total-compensation percentile values for the requested market scope.
  • percentilePosition: Estimated percentile placement of the submitted pay value within the market distribution.
  • distanceFromMedian: Numeric distance between the submitted pay value and the market median.
  • rationaleNotes: Human-readable explanation for why a benchmark candidate was returned as a match.
  • score: Numeric candidate score used to rank benchmark matches.
  • executionId: Unique identifier for the tool execution.
  • nextActions: Suggested follow-up tools that the client can invoke next.

© Copyright Salary.com 2026. All Rights Reserved.

Privacy Policy/California Privacy Rights | Legal | Accessibility | Terms of Use | Do Not Sell or Share My Information