Match jobs to a candidate profile — returns ranked results

Send a candidate profile (skills, salary range, workplace preference) and get recent active jobs ranked by relevance score. Anonymous access is open and free; recurring agents can register an API key for stable identity. This is the recommended endpoint for agentic job search.

Request body

skillsstring[] required

Candidate skills (e.g., ["python", "llm", "pytorch"])

salary_mininteger

Desired minimum salary (USD/year)

salary_maxinteger

Desired maximum salary (USD/year)

workplace'remote' | 'hybrid' | 'onsite'

global_remoteboolean

Only match roles explicitly open worldwide

remote_scope'global' | 'restricted' | 'unknown' | 'not_remote'

level'junior' | 'mid' | 'senior' | 'lead' | 'principal'

limitinteger

Max results (default 20, max 50)

Response

Ranked job matches with scores and reasons

total_scoredinteger

total_matchesinteger

Example response

{
  "matches": [
    {
      "candidate_resume_action": {
        "status": "available_after_candidate_selects_job",
        "method": "POST",
        "saved_artifact_requires_verified_human": true,
        "uses_candidate_verified_evidence": true,
        "requires_explicit_human_review": true
      }
    }
  ],
  "candidate_resume_action": {
    "status": "available_after_candidate_selects_job",
    "method": "POST",
    "saved_artifact_requires_verified_human": true,
    "uses_candidate_verified_evidence": true,
    "requires_explicit_human_review": true
  }
}