Textwerk
job ad draft
Builds the ad only from the supplied data (no invented marketing text): title with the gender note (m/w/d) unless one is present, company line, location or remote setting, start date, sections Ihre Aufgaben / Ihr Profil / Wir bieten, salary range with period, application contact and deadline. Generates schema.org JobPosting JSON-LD (title, description, datePosted, validThrough, employmentType, hiringOrganization, jobLocation or jobLocationType TELECOMMUTE with applicantLocationRequirements,.
POST https://text.halowerk.com/v1/job-ad-draftInputs
| Field | Type | Required | Description |
|---|---|---|---|
| title | string | Yes | Job title, e.g. "Buchhalterin / Buchhalter". |
| company | object | Yes | |
| location | object | No | |
| remote | string | No | full = fully remote (TELECOMMUTE). |
| applicant_country | string | No | Fully remote: country where applicants must live. |
| employment_type | string | Yes | |
| hours_per_week | number | No | |
| start | string | No | Start date or "ab sofort". |
| tasks | array | Yes | |
| requirements | array | Yes | |
| benefits | array | No | |
| salary | object | No | |
| contact | object | No | |
| date_posted | string | Yes | |
| valid_through | string | No |
Show full input schema
{
"type": "object",
"additionalProperties": false,
"required": [
"title",
"company",
"employment_type",
"tasks",
"requirements",
"date_posted"
],
"properties": {
"title": {
"type": "string",
"minLength": 3,
"maxLength": 120,
"description": "Job title, e.g. \"Buchhalterin / Buchhalter\"."
},
"company": {
"type": "object",
"additionalProperties": false,
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"minLength": 2,
"maxLength": 120
},
"url": {
"type": "string",
"format": "uri"
},
"description": {
"type": "string",
"maxLength": 600,
"description": "Factual company description supplied by you."
}
}
},
"location": {
"type": "object",
"additionalProperties": false,
"required": [
"city",
"country"
],
"properties": {
"street": {
"type": "string",
"maxLength": 120
},
"postcode": {
"type": "string",
"maxLength": 10
},
"city": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"region": {
"type": "string",
"maxLength": 80
},
"country": {
"type": "string",
"pattern": "^[A-Z]{2}$"
}
}
},
"remote": {
"type": "string",
"enum": [
"none",
"hybrid",
"full"
],
"default": "none",
"description": "full = fully remote (TELECOMMUTE)."
},
"applicant_country": {
"type": "string",
"pattern": "^[A-Z]{2}$",
"description": "Fully remote: country where applicants must live."
},
"employment_type": {
"type": "string",
"enum": [
"FULL_TIME",
"PART_TIME",
"CONTRACTOR",
"TEMPORARY",
"INTERN",
"VOLUNTEER",
"PER_DIEM",
"OTHER"
]
},
"hours_per_week": {
"type": "number",
"minimum": 1,
"maximum": 60
},
"start": {
"type": "string",
"maxLength": 60,
"description": "Start date or \"ab sofort\"."
},
"tasks": {
"type": "array",
"minItems": 1,
"maxItems": 20,
"items": {
"type": "string",
"minLength": 1,
"maxLength": 500
}
},
"requirements": {
"type": "array",
"minItems": 1,
"maxItems": 20,
"items": {
"type": "string",
"minLength": 1,
"maxLength": 500
}
},
"benefits": {
"type": "array",
"maxItems": 20,
"items": {
"type": "string",
"minLength": 1,
"maxLength": 500
}
},
"salary": {
"type": "object",
"additionalProperties": false,
"required": [
"min",
"unit"
],
"properties": {
"min": {
"type": "number",
"minimum": 0
},
"max": {
"type": "number",
"minimum": 0
},
"unit": {
"type": "string",
"enum": [
"HOUR",
"MONTH",
"YEAR"
]
},
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$",
"default": "EUR"
}
}
},
"contact": {
"type": "object",
"additionalProperties": false,
"properties": {
"name": {
"type": "string",
"maxLength": 120
},
"email": {
"type": "string",
"format": "email"
},
"url": {
"type": "string",
"format": "uri"
}
}
},
"date_posted": {
"type": "string",
"format": "date"
},
"valid_through": {
"type": "string",
"format": "date"
}
}
}Published input example
{
"title": "Buchhalter",
"company": {
"name": "Lagertechnik Nord GmbH",
"url": "https://halowerk.com/"
},
"location": {
"postcode": "48599",
"city": "Gronau",
"country": "DE"
},
"employment_type": "FULL_TIME",
"tasks": [
"Kreditoren- und Debitorenbuchhaltung",
"Vorbereitung der Monatsabschlüsse"
],
"requirements": [
"Abgeschlossene kaufmännische Ausbildung",
"Erfahrung mit DATEV"
],
"benefits": [
"30 Tage Urlaub"
],
"salary": {
"min": 3800,
"max": 4400,
"unit": "MONTH"
},
"date_posted": "2026-11-01",
"valid_through": "2026-12-31"
}Result & documentation
Machine-readable documentation of this hub
Source of this page: the published HALOWERK catalog. Updated: 2026-11-17 UTC.
More endpoints in this hub
- Textwerk0.002 USDC
acronym ideas
POSThttps://text.halowerk.com/v1/acronym-ideasSplits the title into words, marks German and English stop words (and, of, für, und ), and enumerates in word order every combination of the first 1-3 letters of each significant word (stop words contribute 0 or 1 letter when allowed), with
- Textwerk0.005 USDC
agg check
POSThttps://text.halowerk.com/v1/agg-checkApplies documented rules to the ad text and its first line or title: explicit age limits and age ranges, youth-related team wording and career-stage target groups (age); native-speaker, accent and origin requirements, nationality (ethnic or
- Textwerk0.002 USDC
anglicism replace
POSThttps://text.halowerk.com/v1/anglicism-replaceLooks up every word in about 1,050 entries that OpenThesaurus (export 2026-10-30, LGPL-2.1 or CC BY-SA 4.0) labels English, Anglicism or Denglisch, matching inflected forms from german-pos-dict 1.2.2 (CC BY-SA 4.0) and English heads of comp