> [!IMPORTANT]
> **Beta**   
> This is a Beta release of Cloud Talent Solution. This release is not covered by any SLA or deprecation policy and is not intended for real-time use in critical applications.

<br />

> [!CAUTION]
> This is an alpha release of Cloud Job Discovery Similar Job Recommendations. This an experimental feature that is not covered by SLAs, and the API and its behavior may change without notice.

Similar Job Recommendations allows you to return a set of jobs that are
similar to a job seeker's job of interest.

## API Overview

Pass a `Job` entity X and an optional `resultSize` number N to the
[jobs.recommend](https://docs.cloud.google.com/job-discovery/docs/reference/rest/v2beta1/jobs/recommend)
API. The Cloud Talent Solution service returns up to N similar recommended jobs.

The results are based on:

- User behavior: The API returns jobs viewed or applied for by other users who also viewed or applied for the passed-in job X.
- Job metadata: The API returns jobs with a similar classification to the passed-in job X as determined by the service's job classification machine learning model.

The list of returned jobs is sorted by relevance (Job N has higher relevance
than Job N+1).

**De-Duping** : CTS removes jobs from the results that are
possible duplicates of the passed-in job X. De-duplication logic is based on
the passed-in Job's associated `companyName` and `jobTitle`.

## Best practices

The following steps are required or recommended when using this feature:

- For each search and Histogram request, the `sessionId` and `userId` in the [requestHeader](https://docs.cloud.google.com/job-search/docs/reference/rest/v2beta1/RequestHeader)/[requestMetadata](https://docs.cloud.google.com/talent-solution/job-search/docs/reference/rpc/google.cloud.talent.v4.md.txt#requestmetadata) must be populated.
- For each search request, User Behavior Event reporting (via [Pub/Sub](https://docs.cloud.google.com/pubsub/docs.md.txt)) must be implemented and, if applicable, the implementation must send at least the following [events](https://docs.cloud.google.com/talent-solution/job-search/docs/client-event.md.txt#client-event.EventType) for each search request:
  - `VIEW`
  - And one of:
    - `APPLY_START`
    - `APPLY_REDIRECT`
    - `APPLY_COMPANY_SUBMIT`
- For best results, more than 20,000 unique user queries per month and a large number of Job entities per Company entity are recommended.

## Limitations

Recommended jobs are only returned for the Company associated with the passed-in
Job (additional Jobs associated with the passed-in Job's `companyName`).