---
title: "Recommend profiles for a given job."
method: POST
path: "/recommend/job/{job_id}/profiles"
tags: ["Recommend"]
---

# Recommend profiles for a given job.

`POST /recommend/job/{job_id}/profiles`

Recommend profiles for a given job.

## Path parameters

- `job_id` string, required

## Headers

- `x-response-target` string — 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

- MatchConfig
  - `filters` Filter[] — A list of filters that filter results based on entity properties.
    - `key` string, required — The profile or job key that we are filtering on. Example: 'title' or 'client_data.custom_field'
    - `operator` 'OVERLAP' | 'MATCH' | 'NOT_MATCH' | 'IS_IN' | 'NOT_IN' | 'LIKE' | 'NOT_LIKE' | 'GREATER_THAN_OR_EQUAL' | 'LESS_THAN_OR_EQUAL' | 'EXISTS', required — An enumeration.
    - `value` union, required — The value to use with the operator. Can refer to a raw value, but can also refer to a field in the source entity.To refer to a field in the source entity, start with the $ symbol: $capacity_preferences
      - unknown[]
        - unknown
      - unknown
  - `max_distance` integer — Defines a radius used for looking for recommendations, based on the entity addresses. This is not used if `location_filters` is specified.
  - `location_filters` GeoLocationFilter[] — A list of coordinates and distances, to replace the entity addresses. This takes precendence over the `max_distance` parameter.
    - `geopoint` GeoPoint, required
      - `lat` number, required — Example: lat=50.8503396. Latitude in degrees following the WGS84 standard. Positive numbers correspond to latitude North.
      - `lon` number, required — Example: long=4.3517103. Longitude in degrees following the WGS84 standard. Positive numbers correspond to longitude East.
    - `distance_in_km` number
  - `continuation_token` string — A continuation token for getting the next page of recommendations.
  - `limit` integer — The number of results to return
  - `interactions_to_filter` InteractionTypes[] — 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_explanation` boolean — Enable human readable explanations.
  - `experimental` boolean — Enable the latest experimental improvements.
  - `model_version_id` string — 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 `200`

Successful Response

- JobRecommendResponse
  - `continuation_token` string, required
  - `num_total_results` integer, required
  - `results` MatchedProfile[], required
    - `resource_id` string, required
    - `score` number, required
    - `resource` DBProfilePreview, required
      - `external_id` string, required — The unique entity id.
      - `name` string — The profile's full name.
      - `addresses` string[] — The full street address including the country of the hiring locations. If the full street address is not available, the address should be provided up to the most granular level. At least one hiring location is required.
      - `last_updated_datetime` union — The localized timestamp when the job was last modified.
        - string, date-time
        - string
      - `publication_datetime` union — The localized timestamp (including timezone) this job posting was most recently published in ISO 8601 (https://en.wikipedia.org/wiki/ISO_8601).
        - string, date-time
        - string
      - `status` 'not_available' | 'outdated' | 'updated_without_attachments' | 'updated_with_attachment' — An enumeration.
      - `client_data` object — Optional client-specific data
    - `match_explanation` object

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/talentapi/apis/talent-api-api-reference.md) · [All operations](https://skmtc.net/talentapi/apis/talent-api-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/talentapi/talent-api-api-reference/versions/5429d26845d6/schema)