---
title: Related Job Positions Generator API
slug: related-job-positions-generator
url: https://apyverse.com/sharpapi/service/related-job-positions-generator
provider: SharpAPI
categories: [Artificial Intelligence, HR, Smart Generation]
tags: [hr, job-titles, recruiting, role-matching, taxonomy, ai-generation]
auth: api_key
---

# Related Job Positions Generator API

Generate related job titles from a role name. Returns ranked positions with relevance weights for recruiting, sourcing, and job taxonomy work.

## Endpoints

| Method | Path | Description | Atoms |
| --- | --- | --- | --- |
| POST | `sharpapi/api/v1/hr/related_job_positions` | What it does Submits an async job to generate related job positions for the provided role or job ti… | 50 |
| GET | `api/v1/hr/related_job_positions/job/status/` | What it does Checks the status of a related job positions generation job using the jobid path param… | 1 |

## About

## What it does
Related Job Positions Generator takes a job title or role name and returns related positions ranked by relevance. Submit `content` with the role you want to expand from, and you can also set `language` and `max_quantity` to control the response.

The service is designed for HR and recruiting workflows where you want to build out comparable roles, adjacent titles, or alternative search terms from a single input. For example, you can start with a title like "Product Manager" and use the generated list to broaden candidate sourcing, normalize job taxonomies, or suggest related roles in a careers product.

The POST endpoint submits the job and returns a `job_id` plus a `status_url` you can poll. When the job completes, the status endpoint returns a structured result that includes the original `job_position`, a `related_job_positions` array, and a status value such as `queued`, `running`, `failed`, or `success`.

Use Related Job Positions Generator when you need machine-generated role expansion without building your own title-matching logic. It gives you a simple asynchronous flow: submit one role, poll for completion, and read back related positions with their relevance weights.

## Usage

Authenticate with an ApyHub API key in the `apy-token` header.
Full docs and a live playground: https://apyverse.com/sharpapi/service/related-job-positions-generator