---
title: Job Description Generator API
slug: job-description-generator
url: https://apyhub.com/sharpapi/service/job-description-generator
provider: SharpAPI
categories: [Model Kit]
tags: [cv, hr, resume, job]
auth: api_key
version: 1.0.0
service_type: job
endpoints: 2
atoms: 1-50
mcp: true
alias: sharpapi-ai-job-description-generator
---

# Job Description Generator API

Generate structured job descriptions from a title and hiring context. Returns requirements, responsibilities, and a short summary for HR teams.

## Endpoints

| Method | URL | Description | Atoms |
| --- | --- | --- | --- |
| POST | `https://api.eu.apyhub.com/sharpapi/job-description-generator` | What it does Submits a job-description generation request and starts an async job. The request body… | 50 |
| GET | `https://api.eu.apyhub.com/sharpapi/job-description-generator/job/status/:job_id` | What it does Checks the status of a previously submitted job description generation job by job ID a… | 1 |

## Endpoint reference

### Job Description Generator - Submit Job

`POST https://api.eu.apyhub.com/sharpapi/job-description-generator` · 50 atoms · accepts `application/json` · returns `application/json`

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `name` | body | string | yes | The job title for the position (e.g., Senior PHP Software Engineer). |
| `remote` | body | boolean | no | Specifies if the job is remote. |
| `context` | body | string | no | Additional context or requirements (e.g., add requirement of C-class driving license). |
| `country` | body | string | no | The country where the job is located (e.g., United Kingdom). |
| `language` | body | string | no | The language for the job description (e.g., English). |
| `voice_tone` | body | string | no | The tone of voice for the description (e.g., neutral, professional). |
| `company_name` | body | string | no | The name of the company offering the position (e.g., Apple Inc). |
| `visa_sponsored` | body | boolean | no | Specifies if visa sponsorship is available. |
| `employment_type` | body | string | no | Type of employment (e.g., full time, part time, contract). |
| `optional_skills` | body | array of string | no | A list of optional skills for the position. Example: `["AWS RDS","GitFlow"]`. |
| `required_skills` | body | array of string | no | A list of required skills for the position. Example: `["PHP8","Laravel"]`. |
| `minimum_education` | body | string | no | The minimum required education level (e.g., Bachelor Degree). |
| `minimum_work_experience` | body | string | no | The minimum required work experience (e.g., 5 years). |

#### Quickstart

Submit a job description generation request with the required job title.

```bash
curl -X POST "https://api.eu.apyhub.com/sharpapi/job-description-generator" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"Senior PHP Software Engineer"}'
```

#### What you'll get back

Returns a JSON object with a `job_id` string — the UUID of the submitted job. Poll the job status endpoint with this id to retrieve the result.

```json
{
  "job_id": "4443651e-378c-4daf-b1a5-bd341358bdf7"
}
```

### Job Description Generator - Check Job Status

`GET https://api.eu.apyhub.com/sharpapi/job-description-generator/job/status/:job_id` · 1 atoms · accepts `application/json` · returns `application/json`

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `job_id` | path | string (uuid) | yes |  |

#### Quickstart

Check the status of a job by its `job_id`.

```bash
curl -X GET "https://api.eu.apyhub.com/sharpapi/job-description-generator/job/status/:job_id" \
  -H "apy-token: $APY_TOKEN"
```

#### What you'll get back

Returns a JSON object with a `data` object. Inside `data`, the `id` is a UUID, `type` is the response type, and `attributes` contains the job status plus the generated result data when available.

```json
{
  "data": {
    "id": "2f1c2d4a-8c9d-4f4b-9f86-8c5f2f0d5d2e",
    "type": "api_job_result",
    "attributes": {
      "type": "hr_job_description",
      "result": {
        "job_requirements": "- 3+ years of experience\n- Strong communication skills",
        "job_responsibilities": "- Write job descriptions\n- Collaborate with hiring managers",
        "job_short_description": "A concise summary of the generated job description."
      },
      "status": "success"
    }
  }
}
```

## About

## What it does
Job Description Generator creates structured job descriptions from a job title and optional hiring context. Send a `name` and, when needed, add fields like `remote`, `country`, `language`, `voice_tone`, `company_name`, `visa_sponsored`, `employment_type`, `optional_skills`, `required_skills`, `minimum_education`, `minimum_work_experience`, and `context`.

Use it when you need a fast first draft for a new opening, a localized posting, or a role description that reflects specific hiring constraints. The submit endpoint returns a `job_id` so you can track generation asynchronously.

When the job finishes, the status endpoint returns a `data` object with `id`, `type`, and `attributes`. Inside `attributes`, you get `status` plus a `result` object containing `job_requirements`, `job_responsibilities`, and `job_short_description`.

Job Description Generator is useful for HR teams, recruiters, and internal tools that need consistent job copy without hand-writing every posting. It fits workflows where a title, a few requirements, and basic role metadata need to become a ready-to-review description.

## Usage

Base URL: `https://api.eu.apyhub.com` (default region — see
`GET https://apyhub.com/api/public/regions` for the rest).

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