---
title: "Find profiles for the given query."
method: POST
path: "/search/profiles"
tags: ["Search"]
---

# Find profiles for the given query.

`POST /search/profiles`

Find profiles for the given query.

## Request body

- SearchModel
  - `search_metadata` SearchMetadata
    - `profile_id` string
    - `interactions_to_filter` InteractionTypes[]
    - `broaden_search_weight` number — `broaden_search_weight < 1`: Impact of all query expansions will be lower.
  - `search_query` SearchQuery
    - `queries` union[]
      - union
        - string
        - QueryField
          - `key` string, required — Field key in which to search for the query keywords.
          - `queries` string[], required — List of keywords.
    - `location_filters` GeoLocationFilter[]
      - `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
    - `filters` Filter[]
      - `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
  - `broaden_search` union — Expand the query with similar keywords. If `true` standard settings will be used. `false` query will not be expanded. `Below 1 and higher 0`: take into account keywords with a similarity till the defined threshold. `broaden_search=0.7` all keywords with a similarity of 0.7 and higher are used. `Higher equal 1`: number of most similar keywords will be used. `broaden_search=5`: 5 most similar keywords are used.
    - boolean
    - number
    - integer
  - `fields_to_return` string[]
  - `facets` FacetRequest[]
    - `key` string, required
    - `selected_values` union[]
      - union
        - boolean
        - string
        - integer
  - `page_size` integer — Example: `page_size=25`. The maximum number items to return in the results list. Important: **Above a value of 10000 the values will be returned unsorted.** The higher this value the higher the response times.
  - `continuation_token` string — A continuation token for fetching the next page of results.
  - `order_by` 'relevance_descending' | 'distance_ascending' | 'last_updated_datetime_descending' — An enumeration.
  - `pagination_offset` integer — Index from which to start when generating the results list. When both the `continuation_token` and `pagination_offset` are provided the integer from `pagination_offset` will be used for pagination. Talent API offers up to 10.000 sorted results. Please use the key `page_size` and a `pagination_offset` of 0 to receive more than 10.000 unsorted results.

## Response `200`

Successful Response

- SearchProfileResponse
  - `results` SearchProfile[]
    - `external_id` string, required — The unique entity id.
    - `client_data` object — Optional client-specific data
    - `client_name` string
    - `computed_data` object
    - `addresses` string[] — The addresses closest to which the profile is looking for work, including the country name. Note this is not the same as the addresses where the profile is looking for work.
    - `geocoordinates` GeoPoint[] — Each element in the list characterizes a geo point.
      - `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.
    - `name` string — The profile's full name.
    - `picture_url` string, uri — The profile's picture URL.
    - `website_url` string, uri — The profile's website URL.
    - `social_media_profile_urls` string[] — The social media profiles of the profile.
    - `phone` string — The profile's phone number.
    - `email` union — The email addresses of the profile.
      - string, email
      - string
    - `gender` 'F' | 'M' | 'X' — An enumeration.
    - `birthdate` string, date-time — The birthdate of the profile in ISO 8601 (https://en.wikipedia.org/wiki/ISO_8601).
    - `description` string — A description of this profile.
    - `highest_educational_level` string — Highest education levels attained by this profile as defined in ISCED 2011 levels (https://en.wikipedia.org/wiki/International_Standard_Classification_of_Education, http://uis.unesco.org/sites/default/files/documents/international-standard-classification-of-education-isced-2011-en.pdf). Preferably as granular as possible.
    - `languages` ValidateApiSpecLanguage[] — Language proficiencies of this profile. Languages must be two-letter codes defined in ISO 639-1 (https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes). Proficiencies are on the ILR scale (https://en.wikipedia.org/wiki/ILR_scale).
      - `language` string, required
      - `proficiency` 'ELEMENTARY' | 'LIMITED_WORKING' | 'PROFESSIONAL_WORKING' | 'FULL_PROFESSIONAL' | 'NATIVE_OR_BILINGUAL' — An enumeration.
    - `certificates` string[] — A list of descriptions of the profile's certificates.
    - `skills` string[] — A list of short descriptions of the profile's skills.
    - `skill_tags` SkillTag[] — A list of the profile's skill tags.
      - `name` string, required
      - `experience` 'JUNIOR' | 'MEDIOR' | 'SENIOR' — An enumeration.
      - `type` 'GENERATED' | 'CONFIRMED' | 'REJECTED', required — An enumeration.
    - `interests` string[] — A list of descriptions of the profile's interests.
    - `desired_jobs` string[] — A list of desired jobs titles or short descriptions.
    - `undesired_jobs` string[] — A list of undesired jobs titles or short descriptions.
    - `desired_job_seniority_levels` ExperienceLevel[] — The desired seniority for a job.
    - `degrees` Degree[] — A list of attained or in-progress degrees. If the degree is in-progress, leave the attendanceEndDateTime blank. Make sure to not include degrees that are not attained or in-progress!
      - `title` string, required
      - `institution` string
      - `description` string
      - `level` string — Education level attained by this degree as defined in ISCED 2011 levels (https://en.wikipedia.org/wiki/International_Standard_Classification_of_Education, http://uis.unesco.org/sites/default/files/documents/international-standard-classification-of-education-isced-2011-en.pdf). Preferably as granular as possible.
      - `attendance_start_datetime` union
        - string, date-time
        - string
      - `attendance_end_datetime` union
        - string, date-time
        - string
    - `experiences` Experience[] — A list of work experience. If the job is in-progress, leave the job_end_datetime blank.
      - `title` string, required
      - `organization_name` string
      - `organization_url` string, uri
      - `organization_vatin` string — The organization VAT identification number, or VATIN (https://en.wikipedia.org/wiki/VAT_identification_number).
      - `description` string
      - `job_start_datetime` union
        - string, date-time
        - string
      - `job_end_datetime` union
        - string, date-time
        - string
    - `relationship_preferences` RelationshipType[] — The desired employment relationship.
    - `location_preferences` LocationType[] — The desired employment location.
    - `employment_term_preferences` TermType[] — The desired employment term.
    - `capacity_preferences` CapacityType[] — The desired employment capacity.
    - `workday_preferences` DaysType[] — The desired employment schedule.
    - `hours_preferences` HoursType[] — The desired employment hours.
    - `last_updated_datetime` union — The localized timestamp (including timezone) this profile posting was most recently updated in ISO 8601 (https://en.wikipedia.org/wiki/ISO_8601).
      - string, date-time
      - string
    - `publication_datetime` union — The localized timestamp (including timezone) this profile posting was most recently published in ISO 8601 (https://en.wikipedia.org/wiki/ISO_8601).
      - string, date-time
      - string
    - `expiration_datetime` union — The localized timestamp (including timezone) this profile posting expires in ISO 8601 (https://en.wikipedia.org/wiki/ISO_8601). If null, this profile does not expire.
      - string, date-time
      - string
    - `may_be_recommended` boolean — Whether this profile may be recommended (subject to the posting publish and expire times).
    - `may_receive_recommendations` boolean — Whether this profile may receive recommendations.
    - `attachments` DBAttachment[]
      - `filename` string, required
      - `content` string, required
      - `state` string
      - `s3_target` string
  - `facets` FacetResponse[]
    - `key` string, required
    - `selected_values` SelectedValue[]
      - `value` union
        - string
        - integer
        - boolean
      - `num_results` integer
      - `selected` boolean
  - `continuation_token` string
  - `num_total_results` integer

## 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/revisions/0798d0794573/schema)