HR Tech

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::

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

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
          }
        ]
      }
    }
  }
}
SharpAPI Introduction Video

SharpAPI Introduction Video

Feb 2, 2024

SharpAPI is a powerful AI-powered API, which provides a range of workflow automation endpoints to help improve efficiency across various industries. It has features for E-commerce, Content & Marketing Automation, SEO, HR Tech, and Travel & Hospitality industries.

How AI-Powered APIs are Transforming Recruitment

How AI-Powered APIs are Transforming Recruitment

Aug 13, 2024

Discover the impact of AI-powered HR tech stacks on modern recruitment challenges and how top HR APIs are reshaping the hiring landscape in 2024. Enhance candidate experience, improve efficiency, and stay competitive with innovative HR technology solutions.