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

# Related Job Positions Generator API

Generate related job titles from a role name. Submit a position, poll for results, and get weighted suggestions for recruiting or job search.

## Endpoints

| Method | Path | Description | Atoms |
| --- | --- | --- | --- |
| POST | `/sharpapi/api/v1/hr/related_job_positions` | What it does Submits an asynchronous job to generate related job positions from a provided job role… | 50 |
| GET | `/sharpapi/api/v1/hr/related_job_positions/job/status/:job_id` | What it does Checks the status of a previously submitted related job positions generation job using… | 1 |

## About

## What it does
Related Job Positions generates related roles from a job title or position you send in the request body. Submit a `content` string, and optionally set `language` and `max_quantity` to control the output language and how many suggestions you want back.

The first POST returns a `job_id` and a `status_url`. Use the status endpoint to poll by `job_id` until the job is complete. When the job succeeds, the response includes the original `job_position` and a `related_job_positions` array. Each related role includes a `name` and a `weight` so you can rank or filter the suggestions in your own workflow.

Use Related Job Positions when you need to expand a single role into nearby titles for recruiting, candidate search, career-path mapping, or internal taxonomy cleanup. For example, you can start with “Data Analyst” and build a shortlist of adjacent positions to power job recommendations or search suggestions.

The API is asynchronous, which makes it suitable for longer-running generation jobs without blocking your application. You submit once, then fetch the result when the status changes to `success`.

## Usage

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