Jobs

GET /jobs/search Public

Full-text + faceted search over open jobs.

Combine free-text q with any of the filter params below. Repeated facet params are ORed; add <param>_mode=and to require all, or <param>_exclude=<value> to exclude. Without q, results default to newest first; with q, to relevance.

Query parameters

q string
Full-text query over title, company, and description.Example golang
sort string
One of created_at, posted_at, salary_min, salary_max. Omit for relevance/newest.Example posted_at
order string
asc or desc (default desc).Example desc
semantic_ratio number
Opt-in hybrid search, 0–1 (default 0 = pure keyword). Needs the optional semantic index.Example 0
limit integer
Page size, 1–100.Example 20
offset integer
Rows to skip; offset + limit ≤ 10000.Example 0

Plus every filter in Filtering jobs.

curl 
curl "https://freehire.dev/api/v1/jobs/search?q=golang&seniority=senior&work_mode=remote&regions=cis&sort=posted_at"
json — response 
{
  "data": [ { "public_slug": "...", "title": "Senior Go Engineer", "...": "..." } ],
  "meta": { "total": 137, "limit": 20, "offset": 0 }
}