compareToMarket

Compares a submitted pay value against market percentiles for the matched benchmark job. This tool is useful when a client already has a pay amount and wants to know where that value sits relative to the market distribution.

Tool-specific notes

• payValue supports base salary comparison only in the current version.
• The response returns market salary and compensation reference points, percentilePosition, distanceFromMedian, and comparisonPosition.
• Use this tool when you need to position an internal pay value against market rather than return only raw market percentiles.

Input Schema

{
  "type": "object",
  "properties": {
    "country": {
      "description": "Country code, e.g. 'USA'",
      "type": "string"
    },
    "payValue": {
      "description": "Employee's current pay value (base salary) in local currency",
      "type": "number"
    },
    "jobTitle": {
      "description": "Job title of the employee (provide at least one of jobTitle, jobDescription, or jobCode)",
      "type": [
        "string",
        "null"
      ],
      "default": null
    },
    "jobDescription": {
      "description": "Free-text job description to improve matching (optional, alternative to jobTitle)",
      "type": [
        "string",
        "null"
      ],
      "default": null
    },
    "jobCode": {
      "description": "CAMD job code to bypass AI matching (optional, alternative to jobTitle)",
      "type": [
        "string",
        "null"
      ],
      "default": null
    },
    "state": {
      "description": "State or province (optional)",
      "type": [
        "string",
        "null"
      ],
      "default": null
    },
    "city": {
      "description": "City (optional)",
      "type": [
        "string",
        "null"
      ],
      "default": null
    },
    "zipCode": {
      "description": "ZIP or postal code (optional)",
      "type": [
        "string",
        "null"
      ],
      "default": null
    },
    "naicsCode": {
      "description": "NAICS industry code (optional)",
      "type": [
        "string",
        "null"
      ],
      "default": null
    },
    "companyFteSize": {
      "description": "Company FTE headcount bracket (optional), e.g. '500'",
      "type": [
        "string",
        "null"
      ],
      "default": null
    },
    "companyRevenueSize": {
      "description": "Company annual revenue bracket (optional), e.g. '1000'",
      "type": [
        "string",
        "null"
      ],
      "default": null
    },
    "sessionId": {
      "description": "Session ID for conversation context (optional)",
      "type": [
        "string",
        "null"
      ],
      "default": null
    }
  },
  "required": [
    "country",
    "payValue"
  ]
}

Output Schema

{
  "data": {
    "datasetRoutedTo": "MarketData",
    "matchRating": "Confident",
    "normalizedGeography": {
      "country": "USA",
      "region": "Northeast",
      "state": "MA",
      "city": "Boston"
    },
    "normalizedIndustry": "Retail Trade",
    "normalizedCompanySize": "7501-15000",
    "benchmarkJobTitle": "Purchasing Clerk I",
    "currencyCode": "USD",
    "inputPayValue": 56000,
    "comparisonPosition": "At25thToBelow50th",
    "salary10": 46292.4872,
    "salary25": 51943.4961,
    "salary50": 58150.342,
    "salary75": 65803.2089,
    "salary90": 72770.7445,
    "comp10": 46611.3336,
    "comp25": 52458.0453,
    "comp50": 58879.8435,
    "comp75": 66922.7726,
    "comp90": 74245.4395,
    "percentilePosition": 41,
    "distanceFromMedian": -2150.342,
    "jobFamilyName": "Supply Chain & Distribution",
    "jobLevelName": "Entry (I)",
    "jobSummary": "Initiates, prepares, processes, and verifies purchase orders following established guidelines to purchase materials and goods by required delivery dates.",
    "socCode": "43-3061",
    "socTitle": "Procurement Clerks",
    "summaryText": "The input pay value of USD 56,000 for the matched benchmark (Purchasing Clerk I) with a confident alignment is below the market median in the market, relative to a median of USD 58,150.",
    "executionId": "exec_1779959850990_f0a24f5ef22948fbbd93c010ff49f4f1"
  },
  "nextActions": [
    "See summary of the labor market → summarizeLaborMarket"
  ]
}