☰
CompAnalyst
| API
×
Welcome to the Salary.com API Authentication
Data as a Service CompAnalyst and JobArchitect

DATA AS A SERVICE

Introduction & AI Market Data Job Match API
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
Posting Data Job Match API
Behavior Request Field Definitions Response Field Definitions Match a Job POST Match a Job (Verbose) POST

COMPANALYST

Employees
Get an Employee GET Get Employee List GET Create an Employee POST Update an Employee PUT Delete an Employee DELETE
Company Jobs
Get a Company Job GET Get Company Job List GET Create a Company JobPOST Update a Company Job PUT
Composites
Get Composite ListGET Get Composite by Job CodeGET

JOBARCHITECT

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

REFERENCE

Field Definitions
Employees Company Jobs Salary Plan Competencies Composites JobArchitect Skills
Change Log

Response Field Definitions

Job Match API

    "MatchRating": "Confident",
    "Salary10": 73858.3779,
    "Salary25": 81564.9073,
    "Salary50": 90029.456,
    "Salary75": 99553.8857,
    "Salary90": 108225.3813,
    "Comp10": 75005.8138,
    "Comp25": 83690.9599,
    "Comp50": 93230.3826,
    "Comp75": 104383.6451,
    "Comp90": 114538.1081,
    "BonusTarget50": 7929.7249,
    "BonusTargetAvg": 7711.5143,
    "CurrencyCode": "USD",
    "DataScope_IndustryCode": "ALL",
    "DataScope_IndustryName": "All Industries",
    "DataScope_FTERange": "51-100",
    "DataScope_CountryCode": "USA",
    "DataScope_Region": "Northeast",
    "DataScope_State": "MA",
    "DataScope_City": "Boston",
    "JobFamilyName": "Accountants and Financial Personnel",
    "JobLevelName": "Senior (III-VI)"

    Depending on the scope of the client credentials, this API can return all of the following fields.

  • Match Rating: The string field that represents our confidence in the salary ranges and job attributes we returned. We will return as “Confident”/ “Potential” /“NeedsReview” per job title/description you input.
  • Salary10-90: A numerical field that represents the different percentile 10th, 25th, 50TH, 75th, 90th of base salary. We returned per job title/description and data scopes requested. The currency of this field please refer to “CurrencyCode”.
  • Comp10-90: A numerical field that represents the different percentile 10th, 25th, 50TH, 75th, 90th of total cash compensation. We returned per job title/description and data scopes requested. The currency of this field please refer to “CurrencyCode”.
  • BonusTarget50/Avg: A numerical field that represents the different percentile 50TH/the average of target bonus compensation. We returned per job title/description and data scopes requested. The currency of this field please refer to “CurrencyCode”.
  • CurrencyCode: A three-letter code representing the currency used for monetary values, following ISO 4217 standards.
  • DataScope: The data in response is returned per below data scope
    • IndustryCode/Name: a standardized numerical representation used to classify businesses and organizations of the returned data.

      We will return the corresponding NAICS code user enter as “industrycode” with the below “industryname” per North American Industry Classification System

      • Agriculture, Forestry, Fishing and Hunting
      • Mining, Quarrying, and Oil and Gas Extraction
      • Utilities
      • Construction
      • Manufacturing
      • Wholesale Trade
      • Retail Trade
      • Transportation and Warehousing
      • Information
      • Finance and Insurance
      • Real Estate and Rental and Leasing
      • Professional, Scientific, and Technical Services
      • Management of Companies and Enterprises
      • Administrative and Support and Waste Management and Remediation Services
      • Educational Services
      • Health Care and Social Assistance
      • Arts, Entertainment, and Recreation
      • Accommodation and Food Services
      • Other Services (except Public Administration)
      • Public Administration

      If we only can find data in All industry or user did not enter NAICSCode in the request, please return as industry code “ALL” and industry name “All Industries”.

    • FTERange/RevenueRange: A range value is returned per request, each time only one of these two size ranges will return, if we cannot find data in this size or user did not enter size value, please return as “FTERange: ALL”.

    • CountryCode/Region/State/City: Geographic info returned per request. The minimum granularity is city, so if the returned data is city level, please provide location with city, state, region, country. If only state level, then return state, region, country. If only region level data, then return region, country. If we do not have specific location level data, just return with country level data.

  • JobFamilyName: A string value representing the name or label of the job family to which a specific job role belongs. This is our returned job attributes based on the request job title/description.
  • JobLevelName: A string value representing the hierarchical level or rank of a job position. This is our returned job attributes based on the request job title/description.

Job Match API (Verbose)

    "MatchRating": "Confident",
    "Salary10": 73858.3779,
    "Salary25": 81564.9073,
    "Salary50": 90029.456,
    "Salary75": 99553.8857,
    "Salary90": 108225.3813,
    "Comp10": 75005.8138,
    "Comp25": 83690.9599,
    "Comp50": 93230.3826,
    "Comp75": 104383.6451,
    "Comp90": 114538.1081,
    "BonusTarget50": 7929.7249,
    "BonusTargetAvg": 7711.5143,
    "CurrencyCode": "USD",
    "DataScope_IndustryCode": "ALL",
    "DataScope_IndustryName": "All Industries",
    "DataScope_FTERange": "51-100",
    "DataScope_CountryCode": "USA",
    "DataScope_Region": "Northeast",
    "DataScope_State": "MA",
    "DataScope_City": "Boston",
    "JobFamilyName": "Accountants and Financial Personnel",
    "JobLevelName": "Senior (III-VI)",
    "JobSummary": "Maintains financial records and ensures that financial transactions are properly recorded.",
    "ExperienceYearMin": "4",
    "ExperienceYearMax": "7",
    "EducationDegree": "Bachelor's",
    "Skills": "Account Reconciliation | Accounting Software | Balance Sheet Analysis | Bank Reconciliation | Calculate Depreciation | Financial Accounting | Financial Reporting | GAAP Standards | General Ledger Accounting | Month-End Close | Quarter-End Close | Revenue Recognition | Spreadsheet advanced | Year-End Close"

    Depending on the scope of the client credentials, this API can return all the fields defined above as well as the following.

  • Job Summary: A string value representing the highest level overview of the job, may include key responsibilities, qualifications and requirements.
  • ExperienceYearMin: An integer value representing the minimum required or preferred years of relevant work experience for the job. This is our returned job attributes based on the request job title/description/ YearsOfExperienceMin.
  • ExperienceYearMax: An integer value representing the maximum preferred or allowed years of relevant work experience for the job. This is our returned job attributes based on the request job title/description/ YearsOfExperienceMin.
  • EducationDegree: A string value representing the highest level of education or degree required or preferred for the job, such as "Bachelor's," "Master's," or "Ph.D.". This is our returned job attributes based on the request job title/description/ YearsOfExperienceMin.
  • Skills: A string list separated by a pipe “|” containing the names or identifiers of skills required or desired for the job. Skills denote the specific competencies, knowledge areas, or abilities required or desired. This is our returned job attributes based on the request job title/description/ YearsOfExperienceMin.
© Copyright Salary.com 2025. All Rights Reserved. Privacy Policy | Legal