Sign in

v3

latestOpenAPI 3.0.32026-08-0327240.5 KB

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.

post/jobs/match

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
  },
  "candidate_job_search_pack": {
    "product_id": "aidevboard_ai_skills_demand_pack",
    "name": "AI Market Demand Pack",
    "price_usd": 29,
    "amount_cents": 2900,
    "currency": "USD",
    "fulfillment": "automatic_email_after_paid_checkout",
    "role": "optional_provider_research",
    "free_discovery": {
      "organic_ranking_effect": "none"
    }
  }
}