getHiringCompanies

Returns ranked hiring companies for the requested role and market. Use this tool when the client wants to identify which employers are contributing most strongly to demand in the selected labor market.

Tool-specific notes

• maxCompanies controls how many companies are returned. The maximum is 10 and the default is 3.
• Each company item may include posting volume, average posting duration, growthRate, percentRemote, and percentSignOnBonus.
• This tool is especially useful for competitive-intelligence, target-account, or talent-demand use cases.

Input Schema

{
  "type": "object",
  "properties": {
    "country": {
      "description": "Country code, e.g. 'USA', 'GBR', 'CAN'",
      "type": "string"
    },
    "jobTitle": {
      "description": "Job title to search for, e.g. 'DevOps Engineer' (provide at least one of jobTitle, jobDescription, or postingKeyword)",
      "type": [
        "string",
        "null"
      ],
      "default": null
    },
    "jobDescription": {
      "description": "Optional free-text role context used to improve title/role matching",
      "type": [
        "string",
        "null"
      ],
      "default": null
    },
    "postingKeyword": {
      "description": "Keyword to search across postings (alternative to jobTitle/jobDescription)",
      "type": [
        "string",
        "null"
      ],
      "default": null
    },
    "onlyPosted": {
      "description": "Only return companies with active postings (optional)",
      "type": "boolean",
      "default": true
    },
    "startDate": {
      "description": "Start date in YYYY-MM-DD format (optional)",
      "type": [
        "string",
        "null"
      ],
      "default": null
    },
    "endDate": {
      "description": "End date in YYYY-MM-DD format (optional)",
      "type": [
        "string",
        "null"
      ],
      "default": null
    },
    "state": {
      "description": "State or province (optional)",
      "type": [
        "string",
        "null"
      ],
      "default": null
    },
    "city": {
      "description": "City name for geographic filtering (optional)",
      "type": [
        "string",
        "null"
      ],
      "default": null
    },
    "zipCode": {
      "description": "ZIP or postal code for geographic filtering (optional)",
      "type": [
        "string",
        "null"
      ],
      "default": null
    },
    "metro": {
      "description": "Metro area name for geographic filtering (optional), e.g. 'New York-Newark-Jersey City'",
      "type": [
        "string",
        "null"
      ],
      "default": null
    },
    "naicsCode": {
      "description": "NAICS industry code filter (optional)",
      "type": [
        "string",
        "null"
      ],
      "default": null
    },
    "companyFteSize": {
      "description": "Company FTE size range use actual value to filter (optional)",
      "type": [
        "string",
        "null"
      ],
      "default": null
    },
    "maxCompanies": {
      "description": "Number of companies to return. Do NOT override unless the user explicitly requests a specific number. (optional, default 3, Hard maximum 10).",
      "type": "integer",
      "default": 3
    },
    "sessionId": {
      "description": "Session ID for conversation context (optional)",
      "type": [
        "string",
        "null"
      ],
      "default": null
    }
  },
  "required": [
    "country"
  ]
}

Output Schema

{
  "datasetRoutedTo": "LaborMarketData",
  "matchRating": "Confident",
  "normalizedGeography": {
    "country": "USA",
    "region": "South",
    "state": "TX"
  },
  "normalizedIndustry": "Retail Trade (leisure interests, general merchandise, non-store retailers, misc.)",
  "normalizedCompanySize": "All FTEs",
  "normalizedDateRange": {
    "start": "2026-02-27",
    "end": "2026-05-28"
  },
  "companies": [
    {
      "companyName": "JCPenney",
      "numberOfPostings": 4,
      "averagePostingDuration": 30,
      "percentRemote": 0,
      "percentSignOnBonus": 0
    },
    {
      "companyName": "3M",
      "numberOfPostings": 1,
      "averagePostingDuration": 28,
      "percentRemote": 0,
      "percentSignOnBonus": 0
    },
    {
      "companyName": "Copart, Inc",
      "numberOfPostings": 1,
      "averagePostingDuration": 60,
      "growthRate": 0,
      "percentRemote": 0,
      "percentSignOnBonus": 0
    }
  ],
  "onlyPosted": true,
  "summaryText": "Top hiring companies for Product Design Engineer I were JCPenney (4, 66.7% share), 3M (1, 16.7% share), Copart, Inc (1, 16.7% share). These rankings reflect 2026-02-27 to 2026-05-28 in TX, USA, with industry context in Retail Trade (leisure interests, general merchandise, non-store retailers, misc.).",
  "executionId": "exec_1779982653620_235821d8e65443798327d5c37fae4d73",
  "nextActions": [
    "See posting trends for this role → getPostingTrends"
  ]
}