Jobs Search

Two endpoints — quick keyword search vs. typed search with facets.

Quick search — GET /api/jobs. Simple query-string search with comma-separated filters. Best for lightweight integrations and URL-shareable queries.
Advanced search — POST /api/jobs/search. Typed JSON body with inclusion/exclusion filters, range filters, and multi-value text queries. Best for filter UIs and programmatic search.

Both endpoints return JobDto objects — see the Feed page for the full field reference.

Endpoints

Full request/response reference and a live “Try it” playground live on the dedicated pages below.

Quick search

GET /api/jobs — simple query-string search. Best for lightweight integrations and URL-shareable queries.

Advanced search

POST /api/jobs/search — typed JSON body with inclusion/exclusion filters, range filters, and multi-value text queries. Best for filter UIs and programmatic search.

Filter recipes

Basic text search with location

Search for jobs by keyword in one or more cities:

{
  "queries": ["data engineer"],
  "locations": ["Seattle", "Austin"],
  "page_size": 10
}

Skill include/exclude filtering

Find jobs requiring Python or Go but not PHP:

{
  "queries": ["backend developer"],
  "skills": {
    "include": ["python", "go"],
    "exclude": ["php"]
  }
}

Company filtering

Search only at specific companies, or exclude staffing agencies:

{
  "queries": ["product manager"],
  "companies": {
    "include": ["Google", "Meta", "Apple", "Amazon"]
  }
}

{
  "queries": ["software engineer"],
  "companies": {
    "exclude": ["Acme Staffing", "Generic Recruiting Co"]
  }
}

Salary range + experience level

Find senior or principal roles paying

150k–

250k:

{
  "experience_levels": ["senior"],
  "salary_usd": { "min": 150000, "max": 250000 },
  "employment_types": ["full-time"]
}

For open-ended ranges, omit one bound:

{
  "salary_usd": { "min": 200000 }
}

Remote jobs posted recently

{
  "queries": ["machine learning engineer"],
  "work_models": ["remote"],
  "posted_after": "2026-02-01T00:00:00Z"
}

Full combination query

Combine every filter type for a highly targeted search:

{
  "queries": ["backend engineer", "platform engineer"],
  "locations": ["San Francisco", "New York", "Seattle"],
  "skills": {
    "include": ["go", "rust", "kubernetes"],
    "exclude": ["php", "wordpress"]
  },
  "companies": {
    "exclude": ["Acme Staffing"]
  },
  "work_models": ["remote", "hybrid"],
  "employment_types": ["full-time"],
  "experience_levels": ["senior", "lead"],
  "salary_usd": { "min": 150000, "max": 300000 },
  "posted_after": "2026-01-15T00:00:00Z",
  "page": 1,
  "page_size": 50
}

The response includes a facets object with server-computed aggregations. The set of facets is controlled by the include_facets request parameter; when omitted the server returns a low-cardinality default subset to keep responses fast.

Response key	Source field	Notes
`work_model`	`work_model`	Default
`experience_level`	`experience_level`	Default
`employment_type`	`employment_type`	Default
`sources`	`provider_id`	Default
`industries`	`company_industries`	Opt-in — moderate cardinality
`skills`	`all_skill_names`	Opt-in — high cardinality, adds noticeable latency

`include_facets`	Result
omitted / `null`	Default subset (`work_model`, `experience_level`, `employment_type`, `sources`).
`["skills"]`	Only `skills` is computed and returned.
`[]` (empty array)	No facets — `"facets": {}`.
`["skills","unknown"]`	`skills` is returned; unknown names are silently dropped.

On GET /api/jobs pass a comma-separated string (?include_facets=skills,industries); on POST /api/jobs/search pass a JSON array ("include_facets": ["skills", "industries"]). To skip facets from the GET endpoint, send the empty value ?include_facets=.

Example — default response

{
  "facets": {
    "experience_level": [
      { "key": "senior", "count": 4521 },
      { "key": "mid", "count": 3892 },
      { "key": "lead", "count": 1204 },
      { "key": "entry", "count": 987 },
      { "key": "executive", "count": 412 },
      { "key": "intern", "count": 43 }
    ],
    "work_model": [
      { "key": "remote", "count": 5230 },
      { "key": "hybrid", "count": 2847 },
      { "key": "onsite", "count": 1540 }
    ]
  }
}

Example — opting in to skills + industries

{
  "queries": ["backend engineer"],
  "include_facets": [
    "work_model",
    "experience_level",
    "employment_type",
    "sources",
    "industries",
    "skills"
  ]
}

Facet values for enum fields reflect the lowercased canonical values stored in the index, sorted by count descending. skills is faceted on its display-cased values. Counts are bounded by Typesense’s top_values strategy, so long-tail buckets may be approximate — exact totals come from the total field, not from summing facet counts. Use facet values to power filter UIs. Since all filter fields are case-insensitive, you can pass facet key values directly back as filter values.

Enum reference

Send the canonical value listed below. Filter inputs are matched case-insensitively and common variants (e.g. sr → senior, WFH → remote) are normalized server-side, so most reasonable strings will resolve to the right bucket.

work_models

Value	Meaning
`remote`	Fully remote; no expectation of being in an office.
`hybrid`	Mix of remote and in-office work.
`onsite`	On-site / in-person at a specific location.

employment_types

Value	Meaning
`full-time`	Standard full-time permanent role.
`part-time`	Part-time role with reduced hours.
`contract`	Fixed-term or contractor engagement (incl. contract-to-hire).
`internship`	Internship, co-op, or apprenticeship.
`freelance`	Freelance / self-employed / gig work.
`temporary`	Short-term or seasonal role.

experience_levels

Value	Meaning
`intern`	Interns, trainees, apprentices.
`entry`	Entry-level / junior / new graduate.
`mid`	Mid-level / intermediate individual contributor.
`senior`	Senior individual contributor (incl. staff, principal).
`lead`	Tech lead or first-line manager.
`executive`	Director, VP, C-level, head-of.

Source values

All 57 ATS / job-board providers Jobo currently ingests. Use the provider_id in the sources filter (e.g. "sources": ["greenhouse", "lever"]); the same value comes back on the source field of every JobDto and in the facets.sources bucket.

`provider_id`	Provider
`adpmyjobs`	ADP MyJobs
`adpworkforcenow`	ADP Workforce Now
`applicantpro`	ApplicantPro
`ashby`	Ashby
`bamboohr`	BambooHR
`breezy`	Breezy HR
`careerplug`	CareerPlug
`careerpuck`	Careerpuck
`comeet`	Comeet
`csod`	Cornerstone OnDemand
`dayforce`	Dayforce
`dover`	Dover
`eightfold`	Eightfold
`freshteam`	Freshteam
`gem`	Gem
`gohire`	GoHire
`greenhouse`	Greenhouse
`hibob`	HiBob
`hirebridge`	HireBridge
`hirehive`	HireHive
`hireology`	Hireology
`hiringthing`	HiringThing
`homerun`	Homerun
`icims`	iCIMS
`isolved`	iSolved
`jazzhr`	JazzHR
`jobscore`	JobScore
`jobvite`	Jobvite
`joincom`	Join.com
`kula`	Kula
`lever`	Lever
`manatal`	Manatal
`oraclecloud`	Oracle Cloud
`pageup`	PageUp
`paycom`	Paycom
`paycor`	Paycor
`paylocity`	Paylocity
`personio`	Personio
`phenompeople`	Phenom
`pinpoint`	Pinpoint
`polymer`	Polymer
`recooty`	Recooty
`recruitee`	Recruitee
`rippling`	Rippling
`rival`	Rival
`smartrecruiters`	SmartRecruiters
`successfactors`	SAP SuccessFactors
`taleo`	Oracle Taleo
`talnet`	TalNet (Oleeo)
`teamtailor`	Teamtailor
`trakstar`	Trakstar Hire
`trinet`	TriNet
`ultipro`	UltiPro (UKG Pro)
`werecruit`	WeRecruit
`workable`	Workable
`workday`	Workday
`zohorecruit`	Zoho Recruit

Endpoints

Quick search

Advanced search

Filter recipes

Basic text search with location

Skill include/exclude filtering

Company filtering

Salary range + experience level

Remote jobs posted recently

Full combination query

Facets

Available facets

Controlling the facet set

Example — default response

Example — opting in to skills + industries

Enum reference

work_models

employment_types

experience_levels

Source values

​Endpoints

Quick search

Advanced search

​Filter recipes

​Basic text search with location

​Skill include/exclude filtering

​Company filtering

​Salary range + experience level

​Remote jobs posted recently

​Full combination query

​Facets

​Available facets

​Controlling the facet set

​Example — default response

​Example — opting in to skills + industries

​Enum reference

​work_models

​employment_types

​experience_levels

​Source values

Endpoints

Filter recipes

Basic text search with location

Skill include/exclude filtering

Company filtering

Salary range + experience level

Remote jobs posted recently

Full combination query

Facets

Available facets

Controlling the facet set

Example — default response

Example — opting in to skills + industries

Enum reference

work_models

employment_types

experience_levels

Source values