talent

Average match score across talent

Mean match score across the same talent GET /talents/count would count, with the same filter/vectors/proximity/audience parameters and the same visibility rules. Split off the count (POOL-2184) because averaging needs a per-document value and so can never be answered from the index, which made every talent-table tile render read the whole tenant. Only the vector-scoring stages write score, so a query without vectors returns null — including a proximity-only query, since proximity compiles to a bare $geoWithin $match that filters but writes no score. It also returns null when the V3 engine is primary for the target opening: the number this route produces is a V2 average over the matched population, while the rows of GET /talents come back V3-scored, so the two would describe different engines. Average the score on those rows instead. On such a tenant this route therefore serves no number at all, and the same null comes back from the deprecated averageScore field on GET /talents/count — the two agree by construction, including on refusing a filter no index can serve.

get/api/servicepool/talents/averageScore

Request

  • Base URL
    https://services.fountain.com
  • URL
    https://services.fountain.com/api/servicepool/talents/averageScore
  • Auth
    HTTP bearer

Query parameters

whereParametersFilterWhere
fieldsParametersFilterFields
limitnumber
skipnumber
orderstring[]
{
  "limit": 10,
  "order": [
    "prop DESC"
  ]
}
matchThresholdnumber required

The match threshold of the job match vector, as a percent from 0 to 100

matchType'Job' | 'Opening' required

The match type of the job match vector

matchUuidstring required

The unique identifier of the job match vector

{
  "matchThreshold": 60,
  "matchType": "Job",
  "matchUuid": "123e4567-e89b-12d3-a456-426614174000"
}
distancenumber required

The numeric distance from location

unit'mile' | 'kilometer' required

The unit of measurement

locationUuidstring required

The unique identifier of the location to check distance against

{
  "distance": 1,
  "unit": "mile",
  "locationUuid": "123e4567-e89b-12d3-a456-426614174000"
}
audienceCampaignUuidstring uuid
onlyReturnHiddenTalentboolean
includeHiddenboolean
audienceUuidstring uuid
searchstring

Free-text search across talent name, email and phone — matches the search parameter on GET /talents/count, so the average describes the same subset the count reports. Bounded to 200 characters.

Response

Average match score across the matched talent

Example response

{
  "meta": {
    "timestamp": "2021-05-05T09:47:58.924Z",
    "verb": "GET",
    "path": "/api/structure/resources/5949cf7c-fec6-4b31-947c-3aceabff58c5",
    "jti": "%cQN3RIGp",
    "rid": "$2d2zkHZ5",
    "count": 1,
    "status": "200",
    "duration": 17,
    "size": 1234
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.