apyhub
HR · MARKETING

Job Description Generator API

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.

POST
Generate a complete job description
https://api.eu.apyverse.com/namastesumalya/generate-complete-job-description

QUICKSTART

GUIDE

Quickstart

Generate a complete job description from a job title and requirements.

curl -X POST "https://api.eu.apyverse.com/namastesumalya/generate-complete-job-description" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "CTO",
    "requirements": "15+ years experience, scaling to 1M users, AI/ML background."
  }'

What you'll get back

Returns a JSON object with optional top-level string fields fullJD, atsVersion, and linkedInPost, plus an optional interviewScorecard array of strings.

{
  "fullJD": "...",
  "atsVersion": "...",
  "linkedInPost": "We're looking for a visionary builder...",
  "interviewScorecard": [
    "Scaling Experience",
    "Strategic Vision",
    "Technical Mentorship"
  ]
}
TRY ITLIVE · 300 ATOMS
Loading your default key…
The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.
body*

About this endpoint

What it does

Generates a complete job description from the supplied role title and requirements. The response returns generated text variants plus an interview scorecard list.

Request Body

ParameterTypeMandatoryDescription
titleStringNoJob title to base the generated content on.
requirementsStringNoRole requirements and qualifications to include in the generated output.

Response

Returns a JSON object with four top-level fields: fullJD and atsVersion as strings, linkedInPost as a string, and interviewScorecard as a string array. The response is returned on success.

ParameterTypeMandatoryDescription
fullJDStringNoThe full generated job description.
atsVersionStringNoAn ATS-friendly version of the job description.
linkedInPostStringNoA LinkedIn-ready post version of the role.
interviewScorecardString ArrayNoA list of interview scorecard criteria.

Body

Name
Type
Description
bodyREQUIRED
object
▣ COMMON ERRORS

Errors any endpoint can return

400bad_request

Required parameter missing or malformed body.

401unauthorized

API key missing, revoked, or not authorized for this service.

429rate_limited

Your plan's per-second rate exceeded. Retry with exponential backoff.

503upstream_busy

Backend temporarily unavailable. Try again in a few seconds.