This content provides an early look at an upcoming extension to the SEEK API. You may use it to scope integration effort, but the features described are not fully implemented and may be adjusted ahead of a production release.Check with your SEEK contact before starting any build work described here.
- Applicant list
- Candidate list or talent pool page
- Candidate record or details page
seekCandidateSummaries query accepts browser tokens that include the query:seek-candidate-profiles scope.Matching to SEEK Pass verification and SEEK Profile data is performed using the candidate’s email address.Conditionally display SEEK Pass and SEEK Profile elements against each candidate in the list.
The seekCandidateSummaries query lets you determine whether a given candidate has SEEK Pass verification and/or a SEEK Profile.Execute the seekCandidateSummaries query once per page of candidates, not once per candidate.Note Requests will be routed to the Playground environment if all candidate
emails in input.candidates[].email use the reserved testing domain
example.org.QueryVariablesResult
CopyGraphQL Explorer
query ($input: SeekCandidateSummariesInput!) {
seekCandidateSummaries(input: $input) {
seekPrimaryEmailAddress
seekProfile {
exists
}
identity {
formattedName
verifiedIndicator
icon {
tooltipLabel
images {
light
dark
}
}
}
}
}seekCandidateSummaries query is a client-side operation:
it is meant to run in the browser while a hirer is viewing a candidate or applicant list in your software, using a browser token in that same user session.
Call it to decorate the UI the hirer already has open, to show candidates with a SEEK Profile.
Do not call it from a background job, batch export, or other process that processes your entire candidate database.Your software only needs summaries for the candidates the hirer is looking at, usually a single page or screen of results.
Enumerating, harvesting, or otherwise systematically processing large candidate sets with this query is prohibited under the SEEK API Terms of Use .If your software is unable to make this query client-side, you should render a “SEEK Profile” link for all candidates in your software.
Candidates that don’t exist on SEEK will be handled gracefully in the SEEK Profile Panel.The query accepts a maximum of 100 candidate summaries per request.
If a single on-screen list has more than 100 rows, you can make multiple requests as a way to populate them.Use the response from the seekCandidateSummaries query to determine whether to show a profile link for each candidate:- If
seekProfile.existsistrue, render a link to the SEEK Profile Panel - If
seekProfile.existsisfalse, do not render the link
Barista (Part-time)
| Name | Source | Profile | Status | Actions |
|---|---|---|---|---|
| John Smith | SEEK | View SEEK Profile | New | |
| Sarah Johnson | Careers website | View SEEK Profile | Shortlisted | |
| Michael Brown | Other | Offered | ||
| Emma Wilson | SEEK | View SEEK Profile | New | |
| David Lee | Other | View SEEK Profile | Shortlisted | |
| Rachel Green | SEEK | View SEEK Profile | New | |
| James Taylor | Careers website | View SEEK Profile | Shortlisted | |
| Lisa Anderson | Other | Offered | ||
| Peter Wright | SEEK | View SEEK Profile | New | |
| Amy Chen | Careers website | Shortlisted |
- Use a tooltip to explain the meaning of the icon
- The tooltip copy should be:
View SEEK Profile - Your software must not modify the icon
Barista (Part-time)
Rachel Green