---
title: Related Skills Generator API
slug: related-skills-generator
url: https://apyhub.com/sharpapi/service/related-skills-generator
provider: SharpAPI
categories: [HR, Smart Generation]
tags: [cv, hr, resume, skills]
auth: api_key
---

# Related Skills Generator API

Generate related job positions or skills from a role name. Returns ranked results with weights via an async job status response.

## Endpoints

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

## About

## What it does
Related Skills Generator takes a job position or role and returns a ranked list of related job positions or skills. Send a `content` string, optionally set `language`, and use `max_quantity` to limit how many related results you want back.

The service submits the request as a job and returns a `job_id` plus a `status_url` for polling. When the job finishes, the status response includes a `data` object with `id`, `type`, and `attributes`. Inside `attributes`, you get the job `status` and a `result` array of objects with `name` and `weight`, so you can sort, filter, or display the related roles by relevance.

Use Related Skills Generator when you need adjacent roles for search, recommendations, career-path mapping, or HR taxonomy enrichment. For example, you can start from "Backend Developer" and build a list of nearby roles to support job matching or related-skill suggestions in a recruiting workflow.

Because the endpoint is asynchronous, you can submit a request, store the job identifier, and fetch the result once the status changes from `queued` or `running` to `success` or `failed`.

## Usage

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