---
title: "Recommend jobs for a given profile (master)."
method: POST
path: "/recommend-master/profile/{profile_id}/jobs"
tags: ["Recommend"]
---

# Recommend jobs for a given profile (master).

`POST /recommend-master/profile/{profile_id}/jobs`

Recommend jobs for a given profile returning only the master results (experimental)

## Path parameters

- `profile_id` string, required

## 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

- union
  - ProfileRecommendResponse
    - `continuation_token` string, required
    - `num_total_results` integer, required
    - `results` MatchedJob[], required
      - `resource_id` string, required
      - `score` number, required
      - `resource` DBJobPreview, required
        - `external_id` string, required — The unique entity id.
        - `title` string, required — The job title.
        - `description` string — The job description.
        - `employer_name` string — The name of the employer.
        - `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
  - MatchedJob[]
    - `resource_id` string, required
    - `score` number, required
    - `resource` DBJobPreview, required
      - `external_id` string, required — The unique entity id.
      - `title` string, required — The job title.
      - `description` string — The job description.
      - `employer_name` string — The name of the employer.
      - `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)