Skip to main content
GET
/
api
/
career
/
recommend
/
jobs
Recommend Jobs
curl --request GET \
  --url https://api.example.com/api/career/recommend/jobs
{
  "returned_count": 1,
  "ranking_variant": "control",
  "ranking_version": "career_recs_v1",
  "recommendations": [
    {
      "company": "<string>",
      "job_id": "<string>",
      "role_title": "<string>",
      "score_pct": 50,
      "source_url": "<string>",
      "location": "<string>",
      "matched_skills": [
        "<string>"
      ],
      "missing_skills": [
        "<string>"
      ],
      "rationale": [
        "<string>"
      ]
    }
  ]
}

Query Parameters

​
top_k
integer
default:10

Number of recommendations to return

Required range: 1 <= x <= 50
​
min_score_pct
number
default:0

Filter out jobs scoring below this percentage

Required range: 0 <= x <= 100
​
location
string | null

Case-insensitive location substring filter (for example: remote, paris)

Response

Successful Response

Job recommendation list derived from profile skills + corpus candidates.

​
returned_count
integer
required
Required range: x >= 0
​
ranking_variant
string
default:control
​
ranking_version
string
default:career_recs_v1
​
recommendations
JobRecommendation · object[]