Personio company jobs
Every open position on a company's Personio career page (<company>.jobs.personio.de or .com), newest first, with filters and paging. Each job has the id, title, link, legal entity, offices, department, recruiting category, employment type, seniority, schedule, years of experience, occupation, keywords, salary range when published, and creation date; descriptions=1 adds the description sections. facets counts the board's jobs per department, office, employment type, seniority, schedule and legal entity, and total_on_board is the board's whole count.
Every response includes credits_used: the credits this call cost.
Parameters
| name | type | description |
|---|---|---|
companyrequired | string | The company's board: its slug (the part before .jobs.personio.de) or the board URL. Example: 1komma5grad |
q | string | Keyword matched in the title, keywords and department. |
department | string | Department (part of the name, e.g. Tech, Sales). |
office | string | Office or city (part of the name, e.g. Berlin, Remote). |
employment_type | string | Employment type as the board names it: permanent, intern, trainee, freelance, temporary, working_student. |
seniority | string | Seniority: entry-level, experienced, executive, student. |
schedule | string | Schedule: full-time, part-time, full-or-part-time. |
subcompany | string | Legal entity of a group (part of the name). |
category | string | Recruiting or occupation category (part of the name). |
language | en | de | fr | es | it | nl | pt | pl | sv | da | fi | no | cs | Language of the texts (default en; boards fall back to their own language). |
descriptions | 1 | 1 adds each job's description sections (larger answers). |
page | string | Results page (1-based). Pass next_page back; it is null on the last page. |
per_page | string | Jobs per page, 1 to 100 (default 50). |
Every endpoint also takes fresh, raw, fields (see lean responses and caching).
Example
curl "https://api.api.sh/personio/v1/jobs?company=1komma5grad" \
-H "x-api-key: $APISH_KEY" import os, requests
res = requests.get(
"https://api.api.sh/personio/v1/jobs",
params={"company": "1komma5grad"},
headers={"x-api-key": os.environ["APISH_KEY"]},
timeout=120,
)
res.raise_for_status()
data = res.json() const url = new URL("https://api.api.sh/personio/v1/jobs");
url.searchParams.set("company", "1komma5grad");
const res = await fetch(url, { headers: { "x-api-key": process.env.APISH_KEY } });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const data = await res.json(); Response
A JSON object with the fields described above, plus raw (the source's own data), cached, fetched_at and credits_used. Errors return {"success": false, "error": "…"} with the HTTP status (see errors). A lookup that ran but found nothing (404) costs the price above; refused calls and errors on our side are free (what's charged).