summarizeLaborMarket

Returns a concise natural-language labor-market summary with supporting metrics. Use this tool when the client wants an executive-style overview rather than a detailed breakdown of postings, skills, or companies.

Tool-specific notes

• This tool is summary-first: the response centers on summaryText and then provides supporting fields such as postings, hiring companies, average duration, growth rates, and skills.
• It is a strong follow-up tool after GetPostingTrends or GetHiringCompanies when a short narrative explanation is needed.
• The returned fields can still be used by clients that need structured metrics in addition to the summary.

Input Schema

{
  "type": "object",
  "properties": {
    "country": {
      "description": "Country code, e.g. 'USA', 'GBR', 'CAN'",
      "type": "string"
    },
    "jobTitle": {
      "description": "Job title, e.g. 'Product Manager' (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
    },
    "sessionId": {
      "description": "Session ID for conversation context (optional)",
      "type": [
        "string",
        "null"
      ],
      "default": null
    }
  },
  "required": [
      "country"
  ]
}

Output Schema

{
  "datasetRoutedTo": "LaborMarketData",
  "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"
  },
  "summaryText": "In TX, USA from 2026-02-27 to 2026-05-28, labor market activity shows 8 postings across 5 hiring companies. Average posting duration is 32.9 days. Posting momentum appears increasing, with a period-over-period posting rate of 14.3%. Key skills signaled in the matched role include CAD Software, Computer-Aided Engineering (CAE) Software, Design Documentation, Product Design, Product Requirements. Leading company signals come from JCPenney, 3M, Copart, Inc. Industry normalization for this view is Retail Trade (leisure interests, general merchandise, non-store retailers, misc.). Company-size normalization is All FTEs.",
  "benchmarkJobTitle": "Product Design Engineer I",
  "numberOfPostings": 8,
  "numberOfHiringCompanies": 5,
  "averagePostingDuration": 32.875,
  "growthRates": {
    "postingMedianRate": -25.91957811470007,
    "numberOfPostingRate": 14.285714285714285,
    "hiringCompanyRate": -28.57142857142857,
    "averageDurationRate": 16.814720812182742
  },
  "skills": [
    "CAD Software",
    "Computer-Aided Engineering (CAE) Software",
    "Design Documentation",
    "Product Design",
    "Product Requirements",
    "Testing Results Analysis"
  ],
  "executionId": "exec_1779982860763_ec627c3f99d84787a3423c686bdd3647",
  "nextActions": [
    "See hiring companies → getHiringCompanies"
  ]
}