Featured job search (v3)

A featured job search allows you to influence your users' search results by ranking jobs according to promotional value rather than purely by relevance. A featured job search only returns relevant jobs with an assigned promotional value.

Featured job searches are useful in cases where you want the ability to sponsor individual jobs in your index. For example, a career site promoting business critical jobs can use a featured jobs search to return only sponsored jobs to job seekers.

Implementing featured job search

There are two steps to implement a featured job search:

1. Create Job resources with promotionValue fields set to a value greater than 0.

2. Set the searchMode to FEATURED_JOB_SEARCH. FEATURED_JOB_SEARCH only returns jobs that both match the job seeker's search critera and have a promotion value > 0.

Results are ordered in decreasing order of their promotionValue. A search with mode set to FEATURED_JOB_SEARCH never returns jobs with a promotion value of 0. In the case of a tie, the API uses relevance to any other provided search criteria to determine the order of results. A featured job search respects all additional filters applied to the search request (for example, location).

Featured job search best practices

Because a featured job search only returns promoted jobs to a job seeker, enabling it (setting searchMode to FEATURED_JOB_SEARCH for specified Job entities) can lead to a trade-off between your business value and the search relevance value the job seeker is looking for. A regular search returns all matching jobs in your index, including any jobs with a promotion value, but does not take the promotion values into account when determining result order.

Featured job searches give you the ability to influence search results and highlight jobs based on a single variable (promotionValue). For applications that require balancing relevance with multiple promotional tiers, such as a multi-tiered Cost-per-Click (CPC) subscriber system, Job Search supports a separate multi-variable custom ranking feature. See the custom ranking best practices documentation for more details.

Using featured job search with enableBroadening and disableKeywordMatch

A featured job search can be used in combination with the disableKeywordMatch and enableBroadening parameters. These additional fields affect the order of the returned results. See the Job Search best practices documentation for more information on enableBroadening and disableKeywordMatch.

Note: Avoid using featured job search when disableKeywordMatch is set to false When disableKeywordMatch is turned off, a job seeker's query may return results with irrelevant but highly-promoted jobs listed first. This sacrifices search relevance and therefore relevance-related performance metrics. For example: You assign a high promotional value to a "Software Engineer" job with "experience with server administration" listed in the job description. A user queries for "Restaurant Server" and disableKeywordMatch is set to false. The top result is "Software Engineer" because the keyword "server" matched the description of a job with a high promotional value even though it's irrelevant to the job seeker.

Featured job search	diasableKeywordMatch	enableBroadening	Outcome
+	+	+	Returns a higher number of jobs, including any featured jobs in both relevant and query expanded results.
+	-	-	Avoid using featured job search when disableKeywordMatch is set to false.
+	-	+	Avoid using featured job search when disableKeywordMatch is set to false.
+	+	-	Returns a higher number of jobs, including any featured jobs in both relevant and keyword matched results.