Skip to main content
POST
/
api
/
career
/
recommend
/
jobs
/
impressions
Recommendation Impression
curl --request POST \
  --url https://api.example.com/api/career/recommend/jobs/impressions \
  --header 'Content-Type: application/json' \
  --data '
{
  "candidates": [
    {
      "job_id": "<string>",
      "position": 2,
      "score_pct": 50
    }
  ],
  "impression_id": "<string>",
  "min_score_pct": 50,
  "top_k": 25,
  "location_filter": "<string>",
  "metadata": {},
  "ranking_variant": "<string>",
  "ranking_version": "<string>",
  "request_id": "<string>"
}
'
{
  "impression_id": "<string>",
  "success": true,
  "duplicate": false,
  "recorded_at": "2023-11-07T05:31:56Z"
}

Body

application/json

Impression payload for one recommendation request render.

candidates
JobRecommendationImpressionCandidate · object[]
required
Required array length: 1 - 200 elements
impression_id
string
required
Required string length: 1 - 128
min_score_pct
number
required
Required range: 0 <= x <= 100
top_k
integer
required
Required range: 1 <= x <= 50
location_filter
string | null
Maximum string length: 128
metadata
Metadata · object
ranking_variant
string | null
Maximum string length: 64
ranking_version
string | null
Maximum string length: 64
request_id
string | null
Maximum string length: 128

Response

Successful Response

Persisted recommendation impression acknowledgment.

impression_id
string
required
success
boolean
required
duplicate
boolean
default:false
recorded_at
string<date-time>