Jobs

GET /jobs/facets Public

Count of matching jobs per facet value (and numeric stats).

Takes the same q and filter params as search, but returns the distribution of values instead of a page of jobs — use it to build filter UIs or see how a filter narrows the set. Continuous numeric facets are returned as stats (min/max), not per-value buckets.

Query parameters

q string
Same full-text query as search.Example golang
(any filter) string
Any search filter param narrows the counted set.Example work_mode=remote
curl 
curl "https://freehire.dev/api/v1/jobs/facets?work_mode=remote"
json — response 
{
  "data": {
    "total": 1820,
    "facets": {
      "seniority": { "senior": 640, "middle": 410, "junior": 120 },
      "category": { "backend": 700, "frontend": 380 }
    },
    "stats": {
      "salary_min": { "min": 20000, "max": 400000 }
    }
  }
}