---
title: Job Description Generator API
slug: generate-complete-job-description
url: https://apyverse.com/namastesumalya/service/generate-complete-job-description
provider: Sumalya APIs
categories: [HR, Marketing, Smart Generation]
tags: [job-description, hiring, recruitment, ats, linkedin-post, hr]
auth: api_key
---

# Job Description Generator API

Generate a full job description from a title and requirements, plus ATS copy, a LinkedIn post, and an interview scorecard.

## Endpoints

| Method | Path | Description | Atoms |
| --- | --- | --- | --- |
| POST | `namastesumalya/api/generate-jd` | What it does Generates a complete job description from the supplied role title and requirements. Th… | 300 |

## About

## What it does
Job Description Generator turns a job title and requirements into hiring copy you can use across your recruiting workflow. Send a `title` and optional `requirements`, and get back a generated `fullJD`, an `atsVersion`, a `linkedInPost`, and an `interviewScorecard` array.

Use it when you need to turn a rough hiring brief into a structured job post without drafting everything by hand. The generated `fullJD` gives you the long-form description, while `atsVersion` is formatted for applicant tracking systems. `linkedInPost` helps you publish the role on social channels, and `interviewScorecard` gives you a starting set of evaluation themes for screening and interviews.

Because the input is minimal, it fits into internal hiring tools, HR portals, and recruiter workflows where the role may start as just a title plus a few bullet points. It is useful for early-stage teams writing their first job ads, or larger teams standardising descriptions across departments.

Job Description Generator is a content generation tool for hiring teams that need consistent role descriptions, posting copy, and interview prompts from the same source brief.

## Usage

Authenticate with an ApyHub API key in the `apy-token` header.
Full docs and a live playground: https://apyverse.com/namastesumalya/service/generate-complete-job-description