getMarketRate

Returns the matched benchmark job together with the requested market compensation percentiles for the selected scope. This is the primary CAMD pricing tool when the goal is to understand market salary or total compensation levels for a role.

Tool-specific notes

• requestedCompensation is an optional JSON object that controls which compensation elements and percentiles are returned.
• If requestedCompensation is omitted, the default response returns Salary percentiles P25, P50, and P75.
• Use this tool when you need market rates for a matched role, not the full benchmark-job content.

Input Schema

{
  "type": "object",
  "properties": {
    "country": {
      "description": "Country code, e.g. 'USA', 'GBR', 'CAN'",
      "type": "string"
    },
    "jobTitle": {
      "description": "Job title to look up, e.g. 'Software Engineer' (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 code (optional), e.g. 'CA', 'NY'",
      "type": [
        "string",
        "null"
      ],
      "default": null
    },
    "city": {
      "description": "City (optional), e.g. 'San Francisco'",
      "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
    },
    "requestedCompensation": {
      "description": "JSON object specifying which compensation elements to return. Salary and Comp are integer percentile arrays (multiples of 5, e.g. [25,50,75]). Example: {\"Salary\":[25,50,75],\"Comp\":[10,25,50,75,90],\"BonusTarget\":true,\"LTI\":true} (optional, defaults to Salary P25/P50/P75)",
      "type": [
        "string",
        "null"
      ],
      "default": null
    },
    "sessionId": {
      "description": "Session ID for conversation context (optional)",
      "type": [
        "string",
        "null"
      ],
      "default": null
    }
  },
  "required": [
      "country"
  ]
}

Output Schema

{
  "data": {
    "datasetRoutedTo": "MarketData",
    "matchRating": "Confident",
    "normalizedGeography": {
      "country": "USA",
      "region": "Northeast",
      "state": "MA",
      "city": "Boston"
    },
    "normalizedIndustry": "Retail Trade",
    "normalizedCompanySize": "3001-7500",
    "benchmarkJobTitle": "Purchasing Clerk I",
    "currencyCode": "USD",
    "salary25": 51527.3422,
    "salary50": 57684.4671,
    "salary75": 65276.0246,
    "comp25": 52037.7717,
    "comp50": 58408.1258,
    "comp75": 66386.6168,
    "socCode": "43-3061",
    "socTitle": "Procurement Clerks",
    "summary": "For the Purchasing Clerk role in Boston, MA, market data shows a median base salary of USD 57,684 and median total compensation of USD 58,408. Aligned to Purchasing Clerk I with a confident job match, top earners at the 75th percentile can expect total compensation up to USD 66,387, indicating a competitive compensation environment in this region.",
    "executionId": "exec_1779959604944_4a02053584d846189336d5ddc0adf3e8"
  },
  "nextActions": [
    "See hiring demand and posting trends for this role → getPostingTrends"
  ]
}