AI-powered API

Related Job Positions Generator

Generates a list of related job positions along with their relevance scores.

By providing a job title, this API returns related positions and their weights as float values ranging from 1.0 to 10.0, where 10 represents the highest relevance.

This API is useful for developers building job recommendation engines, HR software, or career guidance platforms. It helps in identifying alternative roles for candidates, enhancing job search functionalities, and improving job matching algorithms. Use cases include creating personalized job recommendations, enhancing career transition tools, and supporting HR analytics.

Only the content parameter is required.

You can specify the language of the output, which defaults to English.

You can limit the output with the max_quantity parameter.

AI jobs involve two key steps:

Submitting the AI job: Initiating the process by sending the job request.
Monitoring and receiving results: Continuously checking the job status and obtaining the final output upon successful completion.

Related SDKs/Libraries

SharpAPI is now SOC 2 Type II compliant. You can check details at our Trust Center Portal.

Your data is your data. Learn how we protect it and comply with global privacy standards in our Data Handling and Compliance policy .

Step 1. Submit the AI Job request

Endpoint: POST - /v1/hr/related_job_positions

Attribute	Type	Mandatory	Description
content	String	Yes	Provide job position/role to generate related job positions.
language	String	No	Specify the language of the output, defaults to `English`.
max_quantity	Number	No	Maximum number of related job positions to generate.

REQUEST EXAMPLE:

{
    "content": "Flutter Mobile Developer",
    "language": "German",
    "max_quantity": 4
}

RESPONSE EXAMPLE:

{
  "status_url": "https://sharpapi.com/api/v1/content/translate/job/status/5de4887a-0dfd-49b6-8edb-9280e468c210",
  "job_id": "5de4887a-0dfd-49b6-8edb-9280e468c210"
}

Step 2. Monitor & Fetch AI Job Results

Endpoint: GET - /v1/hr/related_job_positions/job/status/:uuid

An endpoint is used to check on the progress of the requested API job.

RESULT EXAMPLE:

{
  "data": {
    "type": "api_job_result",
    "id": "80d0a822-0e2a-40e1-97fd-e7fd62ec9eb0",
    "attributes": {
      "status": "success",
      "type": "hr_related_job_positions",
      "result": {
        "job_position": "Flutter Mobile Developer",
        "related_job_positions": [
          {
            "name": "Android Developer",
            "weight": 8
          },
          {
            "name": "iOS Developer",
            "weight": 8.5
          },
          {
            "name": "MOBILE APP DEVELOPER",
            "weight": 9.5
          },
          {
            "name": "React Native Developer",
            "weight": 7.5
          },
          {
            "name": "Mobile-Entwickler für Flutter",
            "weight": 10
          },
          {
            "name": "Flutter-App-Entwickler",
            "weight": 9
          },
          {
            "name": "Mobile-App-Entwickler (Flutter)",
            "weight": 8
          },
          {
            "name": "Flutter-Entwickler",
            "weight": 10
          },
          {
            "name": "Cross-Platform Mobile Developer",
            "weight": 7
          },
          {
            "name": "Mobile-App-Entwickler",
            "weight": 9
          },
          {
            "name": "Mobile-Entwickler",
            "weight": 8
          },
          {
            "name": "App-Entwickler",
            "weight": 7
          },
          {
            "name": "iOS-Entwickler",
            "weight": 6
          },
          {
            "name": "Flutter Entwickler",
            "weight": 10
          },
          {
            "name": "Mobile App Entwickler",
            "weight": 9
          },
          {
            "name": "Android Entwickler",
            "weight": 8
          },
          {
            "name": "iOS Entwickler",
            "weight": 7.5
          }
        ]
      }
    }
  }
}