country: Required country code for the request, for example USA, GBR, or CAN.
jobTitle: Role title used to analyze posting trends for a named role.
jobDescription: Optional free-text role context used to improve title and role matching when the title is ambiguous or incomplete.
postingKeyword: Free-text keyword used to search postings directly. This is an alternative to jobTitle or jobDescription and is useful when the client wants keyword-based market exploration rather than strict role matching.
startDate / endDate: Optional date range in YYYY-MM-DD format. If both are omitted, SIQ defaults to the last 90 days. If only endDate is provided, the effective start date may be inferred by the service.
state / city / zipCode / metro: Optional geography filters used to narrow the market beyond country. metro supports metro-area filtering such as New York-Newark-Jersey City.
naicsCode: Optional NAICS industry filter used to narrow the posting set by industry. The user may provide a 2-, 3-, 4-, 5-, or 6-digit NAICS code, and the service will normalize it to the supported industry scope used in the response.
companyFteSize: Optional company-size filter used to narrow results to a selected employee-count range. The user may provide a free-input FTE value, and the service maps it to the appropriate supported size bucket.
companyName: Optional company filter used to scope analysis to a specific employer.
onlyPosted: Optional boolean. true returns only salary-disclosed postings, while false allows all postings. The default value is true.
isShowBaseDistribution: Optional boolean. true includes the BaseDistribution histogram in the response, while false omits it. The default value is true.
maxSkills: Optional control for GetTrendingSkills. The default is 5 and the maximum is 30.
maxCompanies: Optional control for GetHiringCompanies. The default is 3 and the maximum is 10.
sessionId: Optional client or runtime tracking value when supported by the MCP implementation. It is not a labor-market metric returned by the dataset itself.
Common SIQ response fields
datasetRoutedTo: Identifies the dataset that served the response. SIQ tool responses return LaborMarketData.
matchRating: Confidence level for the role match used to generate the labor-market result. Confident: greater than or equal to 90% Potential: between 75% and 89% Needs Review: less than 75%
normalizedGeography.country / region / state: Geography actually applied after request normalization.
normalizedIndustry: Industry scope applied after request normalization. This returns the NAICS description, and the service may roll the input code to the corresponding supported industry scope used for posting data.
normalizedCompanySize: Company-size scope applied after request normalization. This returns the FTE size bucket used in the response.
normalizedDateRange.start / end: Effective date range applied by the service after request normalization.
companyName: Official employer name used as a filter or returned in the result when available. If the service cannot confidently resolve the company, this field may be omitted.
numberOfPostings: Total active postings returned for the selected scope. If no postings are found, the value is 0.
averagePostingDuration: Average number of days that postings in the result set remain active.
numberOfHiringCompanies: Count of unique companies currently hiring in the selected scope.
historicalHiringCompanies: Count of unique companies with closed or expired postings in the selected scope.
posting25 / posting50 / posting75: 25th, 50th, and 75th percentiles of posted base-salary midpoint values in the result set.
percentRemote: Share of postings in the result set that are remote.
percentSignOnBonus: Share of postings in the result set that reference a sign-on bonus.
growthRates: Object containing four decimal-place rate values. If no postings are found, 0 is returned for each rate.
postingMedianRate: Percentage change in the median value of job postings (posting50) for the selected period.
numberOfPostingRate: Percentage change in posting volume relative to the comparison period or averaged time window used by the service.
hiringCompanyRate: Percentage change in the number of unique hiring companies relative to the comparison period or averaged time window used by the service.
averageDurationRate: Percentage change in average posting duration relative to the comparison period or averaged time window used by the service.
baseDistribution: Salary range distribution for postings with posted compensation. It groups postings into buckets to show salary ranges, posting counts, and hiring-company counts. If no postings are found, 0 is returned for each field in
baseDistribution.
For 1 posting, only 1 distribution group is shown, with the range representing that posting's salary min-max.
For 2 to 5 postings, 2 distribution groups are displayed.
For more than 5 postings, an additional distribution group is added for every 5 postings, up to a maximum of 10 distribution groups.
baseDistributionId: Identifier for the distribution group, ranging from 1 to a maximum of 10.
rangeMin: Minimum salary value for the distribution group. Returned to 4 decimal places.
rangeMax: Maximum salary value for the distribution group. Returned to 4 decimal places.
numberOfPostings: Total posting count within the distribution group.
numberOfHiringCompanies: Total unique hiring-company count within the distribution group.
benchmarkJobTitle: Standardized benchmark title used to anchor the labor-market result when matching succeeds.
socCode / socTitle: Standard Occupational Classification mapping for the matched role when available.
jobFamilyName: Job-family label used by the returned role mapping.
jobLevelName: Level label associated with the matched role.
skills: Benchmark skill list associated with the matched role.
PostingKeywordTitle: Mirrors postingKeyword when the request is driven by postingKeyword rather than jobTitle.
skill / growthRate / postingCount: Fields returned by GetTrendingSkills for each trending posting skill item: skill is the posting skill name, growthRate represents the growth signal, and postingCount is the number of postings associated with that skill.
companies: Company list returned by GetHiringCompanies.
companyName: Company name returned for the hiring-company result.
numberOfPostings: Posting count attributed to that company within the selected scope.
averagePostingDuration: Average posting duration for that company within the selected scope.
growthRate: Company-level growth signal when returned.
percentRemote / percentSignOnBonus: Company-level remote and sign-on-bonus prevalence when returned.
summaryText: Natural-language summary of the labor-market result.
executionId: Unique identifier for the tool execution.
nextActions: Suggested follow-up tools that the client can invoke next.