---
title: "Find jobs for the given query (V2)."
method: POST
path: "/search/jobs/v2"
tags: ["Search"]
---

# Find jobs for the given query (V2).

`POST /search/jobs/v2`

Find jobs for the given query. This endpoint is used for the new job search.

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

- SearchJobResponse
  - `results` SearchJob[]
    - `external_id` string — The unique entity id.
    - `client_data` object — Optional client-specific data
    - `client_name` string
    - `computed_data` object
    - `title` string — The job title.
    - `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.
    - `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.
    - `publisher_name` string — The name of the company publishing this job.
    - `publisher_vatin` string — The publisher VAT identification number, or VATIN (https://en.wikipedia.org/wiki/VAT_identification_number).
    - `publisher_description` string — The description of the publisher.
    - `employer_name` string — The name of the employer.
    - `employer_vatin` string — The employer VAT identification number, or VATIN (https://en.wikipedia.org/wiki/VAT_identification_number).
    - `employer_description` string — A description of the employer.
    - `department` string — The department or functional area within the company with the open position.
    - `description` string — The job description.
    - `required_qualifications` string[] — A description of the qualifications and skills required to perform this job.
    - `skill_tags` SkillTag[] — A list of the job's skill tags.
      - `name` string, required
      - `experience` 'JUNIOR' | 'MEDIOR' | 'SENIOR' — An enumeration.
      - `type` 'GENERATED' | 'CONFIRMED' | 'REJECTED', required — An enumeration.
    - `offer_and_benefits_str` string — A description of the benefits offered with this job.
    - `application_instructions_str` string — The application instructions that a candidate should follow to apply for this job.
    - `compensation_currency` string — The currency of the compensation, defined in ISO 4217 (https://en.wikipedia.org/wiki/ISO_4217).
    - `hourly_gross_compensation` number — The gross hourly compensation expressed in the corresponding currency.
    - `languages` ValidateApiSpecLanguage[] — Language proficiencies requested for this job. 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.
    - `degrees` string[] — Requested degrees for this job.
    - `education_levels` string[] — Requested education levels 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.
    - `seniority_preferences` ExperienceLevel[] — The requested work experience for this job.
    - `relationship_preferences` RelationshipType[] — The desired employment relationship.
    - `location_preferences` LocationType[] — The employment location.
    - `employment_term_preferences` TermType[] — The employment term.
    - `capacity_preferences` CapacityType[] — The employment capacity.
    - `workday_preferences` DaysType[] — The employment schedule.
    - `hours_preferences` HoursType[] — The employment hours.
    - `job_start_datetime` union — The localized start timestamp of the job.
      - string, date-time
      - string
    - `job_end_datetime` union — The localized end timestamp (including timezone) of the job in ISO 8601 (https://en.wikipedia.org/wiki/ISO_8601). If null, it is known that there is no end time. If this property is missing, the end time is unknown.
      - string, date-time
      - string
    - `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
    - `expiration_datetime` union — The localized timestamp (including timezone) this job posting expires in ISO 8601 (https://en.wikipedia.org/wiki/ISO_8601). If null, this posting does not expire.
      - string, date-time
      - string
    - `may_be_recommended` boolean — Whether this job may be recommended (subject to the posting publish and expire times).
    - `may_receive_recommendations` boolean — Whether this job 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)