v1

latestOpenAPI 3.1.02026-08-062672112.1 KB
Recommend

Recommend jobs for a given profile.

Recommend jobs for a given profile.

post/recommend/profile/{profile_id}/jobs

Path parameters

profile_idstring required

Headers

x-response-targetstring

An identifier for the usage of the response matches. In this way, the different use cases can be analyzed separately. For example, if TalentAPI is called within a web application, then, the URL of the page on which the matches will be displayed, can be used as the value of X-Response-Target. Thus, the API calls can be separated according to the target URL.

An identifier for the usage of the response matches. In this way, the different use cases can be analyzed separately. For example, if TalentAPI is called within a web application, then, the URL of the page on which the matches will be displayed, can be used as the value of X-Response-Target. Thus, the API calls can be separated according to the target URL.

Request body

max_distanceinteger

Defines a radius used for looking for recommendations, based on the entity addresses. This is not used if location_filters is specified.

continuation_tokenstring

A continuation token for getting the next page of recommendations.

limitinteger

The number of results to return

interactions_to_filterInteractionTypes[]

The types of interactions to filter out of the suggestions. For example, if the 'SAVE' interaction type is specified in the list, then the jobs that were saved by the profile will not be used in the suggestions. If this parameter is not specified, by default, all types of interactions will be filtered out.

show_explanationboolean

Enable human readable explanations.

experimentalboolean

Enable the latest experimental improvements.

model_version_idstring

The model version id to use for the recommendations. If not specified, the latest model version is used or the model version is choses based on the A/B testing configuration.

Response

Successful Response

OR