Unified Search

Article
05/08/2023

Overview

Unified Search allows users on an RSC-enabled contract to initiate a search from within their ATS system or LinkedIn Recruiter, rendering a list of relevant results that best match a search query from both systems. The Unified Search solution will allow a user to search and view results via a LinkedIn iframe widget (similar to RSC's Profile Widget) within the ATS and also surface ATS candidate data that matches a search query made within LinkedIn Recruiter.

The Unified Search plugin will allow users to query using the following search parameters, to source candidates from within their ATS:

Keyword - General search facet to query across all candidate fields.
Location - A list of location strings where candidates are based. The location would match member's profile location, and not any of a candidate’s interested locations e.g. “Denver, Colorado”.
Job Title - Title a candidate currently works under e.g. “Chief Marketing Officer”.
In ATS - Filter results for candidates that are currently in the ATS.
Open to New Opportunities - Filter results to only show candidates that are open to new opportunities.

User Flow

For candidates shown via the search list view or within the full profile view in the plugin, users will be able to initiate specific actions, such as:

Save to Job - Ability to import the candidate’s stub profile information into the ATS database within the context of the plugin.
Send InMail - Send a LinkedIn InMail within the context of the plugin.

Requirements

Recruiter System Connect is a prerequisite for Unified Search and must be fully integrated and implemented to enable any of the functionality detailed in these specs.

Customer Enablement

As customers enable/disable Unified Search from the Customer Configuration Plugin toggles, your application should display or hide this feature based on the customer's onboardingStatus for integrationType of UNIFIED_SEARCH. If a customer should enable the integration, all customer historical and future resumes begin and continue to sync. If a customer should disable the integration, customer resume sync should stop.

Display Unified Search Plugin

The plugin is rendered within an iframe and is self-contained; the JavaScript code handles the authentication and renders the content. This feature is dependent on already syncing RSC required fields from your system to LinkedIn.

Using the customer's app credentials provisioned for Recruiter System Connect, display the Unified Search plugin:

<script src="https://platform.linkedin.com/xdoor/scripts/in.js">
   api_key: {api_key}
   extensions: USWidget@https://platform.linkedin.com/rsc/extensions/unified-search-widget
</script>
<script type="IN/USWidget">
   data-integration-context="urn:li:organization:{id}"
   data-width="{width}">
</script>

Unified Search Parameters

Parameter	Description	Required
data-integration-context	Integration context value for the customer's integration. You'll get this value when the customer enables the integration via the Integration Configuration Plugin .	Yes
data-width	Ability to override default width of the plugin. Default and expected minimum width is 990px.	Yes

Note

Please allow up to 72 hours for candidates to appear in search results after syncing.
Verify Content Security Policy includes "platform.linkedin.com" and "www.linkedin.com".

Share via