---
title: Related Skills Generator API
slug: related-skills-generator
url: https://apyverse.com/sharpapi/service/related-skills-generator
provider: SharpAPI
categories: [Developer Tools, HR, Smart Generation]
auth: api_key
---

# Related Skills Generator API

Generate related job positions from a role title. Returns weighted suggestions for HR search, career-path, and role matching workflows.

## Endpoints

| Method | Path | Description | Atoms |
| --- | --- | --- | --- |
| POST | `sharpapi/api/v1/hr/related_skills` | What it does Submits an asynchronous job to generate related skills based on a provided job positio… | 50 |
| GET | `api/v1/hr/related_skills/job/status` | What it does Checks the status of a related-skills-generation job using its UUID job ID. The respon… | 1 |

## About

## What it does
Related Job Skills takes a job title or role description and returns a ranked list of related job positions or skills. Send `content`, and optionally set `language` and `max_quantity`; you get back a job ID immediately, then poll the status URL for the finished result.

The completed response includes a `status` value and a `result` array. Each item in `result` contains a `name` and a `weight`, so you can sort or filter the suggestions by relevance. This makes it useful when you want to expand a role into adjacent titles for search, recommendation, taxonomy building, or internal HR workflows.

Use it to suggest similar positions around a seed role like "Frontend Developer" or "Sales Manager" when building job matching features, career-path navigation, or role discovery tools. Because the output is structured and weighted, you can plug it directly into ranking logic instead of parsing free text.

Related Job Skills is asynchronous, so it fits longer-running generation tasks without blocking your app. Submit a job, poll until `status` becomes `success`, and read the returned related positions from the `result` array.

## Usage

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