getTrendingSkills

Returns trending skills for the matched labor-market role. Use this tool when the client wants to know which skills are appearing most strongly or growing most quickly in posting data for the selected role and market.

Tool-specific notes

• maxSkills controls how many skills are returned. The default is 5 and the maximum is 30.
• Each returned skill item includes the skill name, a growthRate, and a postingCount.
• This tool is useful after a role match has been established and the client wants to understand demand signals at the skill level.

Input Schema

{
  "type": "object",
  "properties": {
    "country": {
      "description": "Country code, e.g. 'USA', 'GBR', 'CAN'",
      "type": "string"
    },
    "jobTitle": {
      "description": "Job title, e.g. 'Machine Learning 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
    },
    "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
    },
    "companyName": {
      "description": "Filter to specific company name (optional)",
      "type": [
        "string",
        "null"
      ],
      "default": null
    },
    "maxSkills": {
      "description": "Number of skills to return. Do NOT override unless the user explicitly requests a specific number. (optional, default 5, Hard maximum 30).",
      "type": "integer",
      "default": 5
    },
    "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": "All Industries",
  "normalizedCompanySize": "All FTEs",
  "normalizedDateRange": {
    "start": "2026-02-27",
    "end": "2026-05-28"
  },
  "companyName": "Eaton Corporation",
  "skills": [
    {
      "skill": "Agile",
      "growthRate": 1,
      "postingCount": 1
    },
    {
      "skill": "AutoCAD",
      "growthRate": 1,
      "postingCount": 1
    },
    {
      "skill": "Bill of Materials",
      "growthRate": 1,
      "postingCount": 1
    },
    {
      "skill": "Collective Bargaining",
      "growthRate": 1,
      "postingCount": 1
    },
    {
      "skill": "CPT",
      "growthRate": 1,
      "postingCount": 1
    }
  ],
  "benchmarkJobTitle": "Product Design Engineer I",
  "summaryText": "For Product Design Engineer I in TX, USA during 2026-02-27 to 2026-05-28, the top trending skills were Agile, AutoCAD, Bill of Materials, Collective Bargaining, CPT. Emerging skills include Agile, AutoCAD, Bill of Materials, Collective Bargaining, CPT based on faster growth, while established skills such as  remain consistently in demand.",
  "executionId": "exec_1779982196328_e784bf7305a6486aa7e5e9efe7897191",
  "nextActions": [
    "Get the market rate for this role → getMarketRate"
  ]
}