Activity & shared boards

GET /stats/jobs-activity Public

Public time series of added vs. removed vacancies per period.

Aggregated to the requested granularity over a date range; the series is dense (missing periods are 0). Defaults: granularity=day, to=today, from a per-granularity window before to. An unknown granularity or a range over 4000 days is a 400.

Query parameters

granularity string
One of day, week, month (default day).Example week
from string (YYYY-MM-DD)
Start date (UTC). Defaults to a per-granularity window before to.Example 2026-01-01
to string (YYYY-MM-DD)
End date (UTC). Defaults to today.Example 2026-06-30
curl 
curl "https://freehire.dev/api/v1/stats/jobs-activity?granularity=week"
json — response 
{
  "data": [
    { "period": "2026-06-01", "added": 120, "removed": 40 },
    { "period": "2026-06-08", "added": 98, "removed": 55 }
  ],
  "meta": { "granularity": "week", "from": "2025-06-09", "to": "2026-06-08" }
}