Skip to content
HALOWERK

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

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
titlestringYesJob title, e.g. "Buchhalterin / Buchhalter".
companyobjectYes
locationobjectNo
remotestringNofull = fully remote (TELECOMMUTE).
applicant_countrystringNoFully remote: country where applicants must live.
employment_typestringYes
hours_per_weeknumberNo
startstringNoStart date or "ab sofort".
tasksarrayYes
requirementsarrayYes
benefitsarrayNo
salaryobjectNo
contactobjectNo
date_postedstringYes
valid_throughstringNo
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"
    }
  }
}

Open original schema

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

All endpoints in this hub →