SearchJobPostings

Search job postings in the search index

POST /rpc/rpc.v1.OrganizationService/SearchJobPostings

SearchJobPostings

cURL

curl --request POST \
  --url https://edge.sterndesk.com/rpc/rpc.v1.OrganizationService/SearchJobPostings \
  --header 'Authorization: Bearer <token>' \
  --header 'Connect-Protocol-Version: <connect-protocol-version>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "organizationId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "query": "<string>",
  "page": "<string>",
  "careerSiteId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "perPage": "<string>",
  "languagesIso6393": [
    "<string>"
  ],
  "states": [],
  "filterByAssigneeIds": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "filterByPipelineIds": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "filterByNoAssignees": true,
  "slot1FilterValue": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "slot2FilterValue": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "slot3FilterValue": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "slot4FilterValue": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "slot5FilterValue": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "slot6FilterValue": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "slot7FilterValue": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "slot8FilterValue": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "slot9FilterValue": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "slot10FilterValue": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "enableHybridSearch": true,
  "disableHybridSearch": true
}
'

200

{
  "items": [
    {
      "id": "<string>",
      "title": "<string>",
      "summary": "<string>",
      "textMatch": "<string>",
      "shortId": "<string>",
      "organizationId": "<string>",
      "careerSiteId": "<string>",
      "languagesIso6393": "<string>",
      "vectorDistance": 123,
      "pinned": true,
      "state": "JOB_POSTING_STATE_UNSPECIFIED",
      "nrOfApplications": "<string>",
      "assignedMembers": [
        {
          "givenName": "<string>",
          "familyName": "<string>",
          "primaryEmail": "<string>"
        }
      ],
      "pipelineId": "<string>",
      "crewRequest": {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "title": "<string>",
        "state": "JOB_POSTING_STATE_UNSPECIFIED",
        "position": {
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "name": "<string>",
          "nbPositions": "<string>"
        }
      },
      "createdAt": "2023-01-15T01:30:15.01Z",
      "slot1FilterValue": [
        "<string>"
      ],
      "slot2FilterValue": [
        "<string>"
      ],
      "slot3FilterValue": [
        "<string>"
      ],
      "slot4FilterValue": [
        "<string>"
      ],
      "slot5FilterValue": [
        "<string>"
      ],
      "slot6FilterValue": [
        "<string>"
      ],
      "slot7FilterValue": [
        "<string>"
      ],
      "slot8FilterValue": [
        "<string>"
      ],
      "slot9FilterValue": [
        "<string>"
      ],
      "slot10FilterValue": [
        "<string>"
      ]
    }
  ],
  "totalFound": "<string>",
  "totalPages": "<string>",
  "currentPage": "<string>"
}

Authorizations

Authorization · string · header · required

Personal API key, sent as Authorization: Bearer <key>.

Headers

Connect-Protocol-Version · number · required

Define the version of the Connect protocol

Example:

1

Connect-Timeout-Ms · number

Define the timeout, in ms

Example:

1000

Body

application/json

request for searching job postings

organizationId · string<uuid>

id of the organization in which job postings will be searched.

query · string

query to search for

Maximum string length: 128

page · string<int64>

page of search results to return

careerSiteId · string<uuid> | null

id of the career site in which job postings will be searched.

perPage · string<int64>

nr of items per page

languagesIso6393 · string[]

languages in iso 639-3 format.

Required string length: 3

states · enum<string>[]

possible states of a job posting.

state of a job posting

Available options: JOB_POSTING_STATE_UNSPECIFIED, JOB_POSTING_STATE_OPEN, JOB_POSTING_STATE_CLOSED

filterByAssigneeIds · string<uuid>[]

filter on job postings assigned to one of these member ids.

Maximum array length: 5

filterByPipelineIds · string<uuid>[]

filter on job postings belonging to one of these pipeline ids.

Maximum array length: 5

filterByNoAssignees · boolean

filter on job postings that have no assigned members.

slot1FilterValue · string<uuid>[]

filter on job postings matching any value for the filter on this slot.

slot2FilterValue · string<uuid>[]

filter on job postings matching any value for the filter on this slot.

slot3FilterValue · string<uuid>[]

filter on job postings matching any value for the filter on this slot.

slot4FilterValue · string<uuid>[]

filter on job postings matching any value for the filter on this slot.

slot5FilterValue · string<uuid>[]

filter on job postings matching any value for the filter on this slot.

slot6FilterValue · string<uuid>[]

filter on job postings matching any value for the filter on this slot.

slot7FilterValue · string<uuid>[]

filter on job postings matching any value for the filter on this slot.

slot8FilterValue · string<uuid>[]

filter on job postings matching any value for the filter on this slot.

slot9FilterValue · string<uuid>[]

filter on job postings matching any value for the filter on this slot.

slot10FilterValue · string<uuid>[]

filter on job postings matching any value for the filter on this slot.

enableHybridSearch · boolean · deprecated

enable_hybrid_search will make searching smarter by understanding meaning, but it is slower.

disableHybridSearch · boolean

hybrid search is enabled by default, it can be toggled off.

Response

200

application/json

Success

response from searching job postings

items · Item · object[]

search results

Show child attributes

totalFound · string<int64>

total number of search results

totalPages · string<int64>

total number of pages for all results

currentPage · string<int64>

current page in the search results