"""SmartRecruiters: `smartrecruiters:`, paged by offset with a stated total. The identifier is case-sensitive (`BoschGroup`). Written from one real board on 2026-09-23; jobhunt-hq did not read SmartRecruiters. A country is filtered on the server, `?country=dk`, one a request (`Filters(country="one")`): Bosch's DE, SE and DK summed to what the app held (review, 2026-09-29), and DK answered 2 of 4,830 on 2026-09-30. The API ignores a remote parameter, so remote is not filtered. A fetch term goes as `?q=engineer`, one a request (`Filters(query="one")`): it matches title and text, and with `country=` it is an AND (survey, 2026-09-30: `q=engineer` answered 1,713 of Bosch's 4,830, with `country=dk` none). How several words in one `q` combine is untested. """ from __future__ import annotations import json import re from collections.abc import Callable from typing import Any from urllib.parse import quote from ._contract import Ask, Fields, Filters, Place, Reads from ._shared import Get, Page, Row, only, parse_dt, path_slug_ok NAME = "smartrecruiters" LABEL = "SmartRecruiters" RANK = 50 PATTERNS = ( r"(?:jobs|careers|api)\.smartrecruiters\.com/(?:v1/companies/)?([A-Za-z0-9_-]+)", ) #: An unknown identifier answers an empty list, which is `empty="suspect"`. READS = Reads( scope="board", listing="paged", page_size=100, text="none", complete="stated", places="one", empty="suspect", filters=Filters(country="one", query="one"), fields=Fields(posted="trusted", remote="stated", country="stated", seniority="stated", employment="stated"), robots="api: no robots.txt check needed (public board API), 2026-09-30", ) _API = "api.smartrecruiters.com" #: The page size asked for, which is also the most the host serves per page. PAGE_SIZE = 100 def slug_ok(slug: str) -> bool: return path_slug_ok(slug) def allowed(slug: str) -> Callable[[str], bool]: return only(_API) def careers_url(slug: str) -> str: return f"https://jobs.smartrecruiters.com/{slug}" def probe_url(slug: str) -> str: return f"https://{_API}/v1/companies/{slug}/postings?limit=1" def probe_ok(body: bytes) -> bool: """An unknown identifier answers an empty listing, so a listing without postings counts as no board.""" return b'"totalFound":' in body and b'"totalFound":0' not in body def page(get: Get, slug: str, cursor: Any, ask: Ask = Ask()) -> Page: """One page, in the one country `ask` names, which the API takes in lower case, and matching its `query` (`q=`).""" offset = int(cursor or 0) country = ask.countries[0].lower() if ask.countries else "" where = f"&country={country}" if re.fullmatch(r"[a-z]{2}", country) else "" words = f"&q={quote(ask.query, safe='')}" if ask.query else "" data = json.loads(get(f"https://{_API}/v1/companies/{slug}/postings" f"?offset={offset}&limit={PAGE_SIZE}{where}{words}")) content = data.get("content") or [] return data, content, data.get("totalFound"), offset + len(content) if content else None def parse(body: bytes, slug: str) -> list[Row]: return rows(json.loads(body), slug) def _word(job: dict[str, Any], key: str) -> str | None: """The `id` of the object `job[key]`, as given.""" return str((job.get(key) or {}).get("id") or "").strip() or None def rows(data: dict[str, Any], slug: str) -> list[Row]: """One page of https://api.smartrecruiters.com/v1/companies/{slug}/postings -> `{"offset", "limit", "totalFound", "content": [...]}`. At most 100 a page, whatever `limit` asks for; the next is `?offset=` further on. The list omits the job description (only the per-posting detail endpoint has it, and fetching one per row would be hundreds of extra requests per board), so `description` stays empty here. A posting has one location, its `country` a lower-case ISO code, `experienceLevel` and `typeOfEmployment` (an `id` and a `label` each).""" out = [] for j in data.get("content") or []: title = (j.get("name") or "").strip() job_id = str(j.get("id") or "") if not title or not job_id: continue location = j.get("location") or {} loc_text = (location.get("fullLocation") or ", ".join(p for p in (location.get("city"), location.get("country")) if p)) # `fullLocation` writes an empty region as ", ,": "Hatvan, , Hungary". loc_text = ", ".join(part.strip() for part in (loc_text or "").split(",") if part.strip()) place: Place = {"text": loc_text, "remote": location.get("remote")} out.append({ "source_id": job_id, "title": title, "places": [place] if loc_text else [], "location": loc_text, "url": f"https://jobs.smartrecruiters.com/{slug}/{job_id}", "posted": parse_dt(j.get("releasedDate")), "department": ((j.get("department") or {}).get("label") or "").strip(), "description": "", "remote": location.get("remote"), "salary_text": "", # SmartRecruiters' list endpoint states no pay at all "country": str(location.get("country") or "").strip() or None, "seniority": _word(j, "experienceLevel"), "employment": _word(j, "typeOfEmployment"), }) return out