Job posting trends over time
job_trendsHow a slice of the market has changed OVER TIME — use this for "is X growing/shrinking", "hiring trend", "more or fewer than last year". aggregate_jobs describes a slice as it stands today; this one shows its history.
Takes the same filters as aggregate_jobs, plus ``bucket`` ("day"/"week"/"month"),
``since_days`` (at most 730), and ``measure``. Returns a ``series``, oldest first, each period carrying
``postings`` (roles dated to it, duplicates collapsed) and ``still_open`` (how many are live
now — the rest have since closed).
``measure="posted"`` (default) uses the employer's stated date: the market signal, but
nullable, so check ``without_date`` — it counts roles the clock cannot place, and when it
rivals the series totals the trend describes a minority of the slice.
``measure="first_seen"`` uses when we first crawled the row. Complete, but it measures OUR
coverage: a backfill or a newly onboarded board appears as a spike of hundreds of thousands
that is not a hiring event. Use it to audit ingestion, not to infer demand.
Either way, periods before ``earliest`` are empty because we hold no data that far back, not
because hiring stopped — never report that as a decline.
CRITICAL for "posted": only compare periods at or after ``crawl_started``. Earlier ones are
left-censored — the first crawl could only capture roles still live when it ran, so anything
posted before that and already closed was never seen. Those buckets undercount severely (their
``still_open`` sits near 100%, the giveaway), and reading across the boundary turns the
crawler's start date into a fake hiring boom.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "job_trends"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | No | ||
| bucket | No | month | |
| remote | No | ||
| source | No | ||
| company | No | ||
| country | No | ||
| measure | No | posted | |
| category | No | ||
| location | No | ||
| seniority | No | ||
| salary_min | No | ||
| since_days | No | ||
| employment_type | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||