☰
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

Match a Job (Verbose)

POST /jobpostingV2/jobpricing

Match a single job and return postings data based on scope of client credentials.

This API is very similar to “Match a Job”. 

URL

https://daasjobmatchapi.salary.com/jobpostingV2/jobpricing

Method

POST

Request Headers

Authorization: Bearer {AccessToken}

Content-Type: application/json

Request Body

{    
    "JobTitle": "string", 
    "JobDesc": "string", 
    "CompanyName": "string", 
    "BaseSalary": 0, 
    "TCC": 0, 
    "TargetBonus": 0, 
    "IsSalaried": true, 
    "IsExempt": true, 
    "YearsOfExperienceMin": 0, 
    "YearsOfExperienceMax": 0, 
    "DataScope": { 
      "CountryCode": "string", 
      "State": "string", 
      "City": "string", 
      "ZipCode": "string", 
      "NAICSCode": "string", 
      "FTEValue": 0 
    }, 
    "DateRange": { 
      "Start": "string", 
      "End": "string" 
    }, 
    "OnlyPosted": true 
}

Please reference “Field Definitions” and “Behavior” sections for detailed information about the fields and API behavior.

Example Request

curl-X'POST'\
    'https://daasjobmatchapi.salary.com/jobposting/jobpricing'\
    -H'accept:*/*'\
    -H'Authorization: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJodHRwOi8vc2NoZW1hcy54bWxzb2FwLm9yZy93cy8yMDA1LzA1L2lkZW50aXR5L2NsYWltcy9uYW1laWRlbnRpZmllciI6IjA1NjE4Q0JBLTUzMzAtNEYxQi05NzI2LUY4OUQ2MkZCNTREMCIsImh0dHA6Ly9zY2hlbWFzLnhtbHNvYXAub3JnL3dzLzIwMDUvMDUvaWRlbnRpdHkvY2xhaW1zL25hbWUiOiJCRUQ0M0ZCMC1COUU1LTQ3ODAtOUNCRS01NTdFMUE2MUFDNzciLCJuYmYiOjE3MTM0NTY1OTYsImV4cCI6MTcxNDA2MTM5NiwiaXNzIjoiU2FsYXJ5IiwiYXVkIjoiSm9iTWF0Y2hBUElDbGllbnQifQ.FFGi0Xb4Tmi8Y86hMDFVuJadlIIrek-rOtLhQveYl-o'\
    -H'Content-Type:application/json'\
    -d‘{
    "JobTitle": "Accountant", 
     "JobDesc": "Maintains financial records and ensures that financial transactions are properly recorded. Ensures the accuracy of entries to ledger accounts and reconciles subsidiary ledger accounts to the general ledger. Prepares balance sheets, profit and loss statements and other financial reports. Analyzes current costs, revenues, financial commitments, and obligations incurred to predict future revenues and expenses. Requires a bachelor's degree in accounting or finance. May require eligibility to sit for Certified Public Accountant (CPA) exam. Typically reports to a supervisor or manager.", 
     "CompanyName": "", 
     "BaseSalary": 0, 
     "TCC": 0, 
     "TargetBonus": 0, 
     "IsSalaried": true, 
     "IsExempt": true, 
     "YearsOfExperienceMin": 2, 
     "YearsOfExperienceMax": 4, 
     "DataScope": { 
         "CountryCode": "USA", 
         "State": "MA", 
         "City": "Boston", 
         "ZipCode": "", 
         "NAICSCode": "", 
         "FTEValue": 1020 
     }, 
     "DateRange": { 
         "Start": "2024-06-01", 
         "End": "2024-09-10" 
     }, 
     "OnlyPosted": false
}'

Response Body

200 HTTP Status Code

This response body corresponds to the example request above.

{
   "Code": 1, 
    "Data": { 
        "MatchRating": "Confident", 
        "NumberOfPostings": 40, 
        "NumberOfClosedPostings": 99, 
        "NumberOfHiringCompanies": 16, 
        "HistoricalHiringCompanies": 35, 
        "Posting25": 79616, 
        "Posting50": 81557, 
        "Posting75": 90135, 
        "AveragePostingDuration": 31.7, 
        "PercentRemote": 0.025, 
        "PercentSignOnBonus": 0, 
        "GrowthRates": { 
            "PostingMedianRate": 0.0466, 
            "NumberOfPostingRate": -0.3419, 
            "HiringCompanyRate": -0.1886, 
            "AverageDurationRate": -0.5929 
        }, 
        "BaseDistribution": [ 
            { 
                "BaseDistributionId": 1, 
                "RangeMin": 0, 
                "RangeMax": 20389.3164, 
                "NumberOfPostings": 0, 
                "NumberOfHiringCompanies": 0 
            }, 
            { 
                "BaseDistributionId": 2, 
                "RangeMin": 20389.3164, 
                "RangeMax": 40778.6328, 
                "NumberOfPostings": 0, 
                "NumberOfHiringCompanies": 0 
            }, 
            { 
                "BaseDistributionId": 3, 
                "RangeMin": 40778.6328, 
                "RangeMax": 61167.9492, 
                "NumberOfPostings": 1, 
                "NumberOfHiringCompanies": 1 
            }, 
            { 
                "BaseDistributionId": 4, 
                "RangeMin": 61167.9492, 
                "RangeMax": 81557.2656, 
                "NumberOfPostings": 19, 
                "NumberOfHiringCompanies": 7 
            }, 
            { 
                "BaseDistributionId": 5, 
                "RangeMin": 81557.2656, 
                "RangeMax": 101946.5781, 
                "NumberOfPostings": 13, 
                "NumberOfHiringCompanies": 9 
            }, 
            { 
                "BaseDistributionId": 6, 
                "RangeMin": 101946.5781, 
                "RangeMax": 122335.8984, 
                "NumberOfPostings": 4, 
                "NumberOfHiringCompanies": 2 
            }, 
            { 
                "BaseDistributionId": 7, 
                "RangeMin": 122335.8984, 
                "RangeMax": 142725.2188, 
                "NumberOfPostings": 1, 
                "NumberOfHiringCompanies": 1 
            }, 
            { 
                "BaseDistributionId": 8, 
                "RangeMin": 142725.2188, 
                "RangeMax": 279205, 
                "NumberOfPostings": 2, 
                "NumberOfHiringCompanies": 2 
            } 
        ], 
        "CurrencyCode": "USD", 
        "DataScope_IndustryCode": "ALL", 
        "DataScope_IndustryName": "All Industries", 
        "DataScope_FTERange": "1001-3000", 
        "DataScope_CountryCode": "USA", 
        "DataScope_Region": "Northeast", 
        "DataScope_State": "MA", 
        "DataScope_City": "Boston", 
        "DateRange_Start": "2024-06-01", 
        "DateRange_End": "2024-09-10", 
     "OnlyPosted”: false 
    } 
}

Common Errors

Missing Required Fields

200 HTTP Status Code, “Code”: -1 means no data is returned

{
    "Code": -1,
    "Message": "Get postings failed."
}

Incomplete Location

200 HTTP Status Code, “Code”: -1 means no data is returned

{
    "Code": -1,
    "Message": "Location request is incomplete"
}

No postings data based on request parameters

200 HTTP Status Code, “Code”: -1 means no data is returned

{
    "Code": -1,
    "Message": "We do not have posting data for this job."
}

Date range problem

200 HTTP Status Code, “Code”: -1 means no data is returned

{
    "Code": -1,
    "Message": "Start date cannot be later than end date."
}
© Copyright Salary.com 2025. All Rights Reserved. Privacy Policy | Legal