130 lines
5.5 KiB
Python
130 lines
5.5 KiB
Python
"""Platsbanken: Sweden's public employment service, through the JobTech search
|
|
API at jobsearch.api.jobtechdev.se; no key.
|
|
|
|
Checked live on 2026-09-29 and 2026-09-30, moved here from `plugins/search.py`.
|
|
`region` is the id of a län in the JobTech taxonomy (Skåne län is
|
|
`CaRE_1nn_cSU`), empty for all of Sweden. 100 results a page, and an `offset`
|
|
above 2000 is refused, so a search reads 2,100 results at most. It states
|
|
`total`. A hit has the whole ad's text, so the list has the full text. An ad
|
|
may name several workplaces: `workplace_addresses` holds one entry each, and
|
|
every one is a place of the role. `workplace_model` is mostly empty; its
|
|
label is passed on as `remote`, in the host's words.
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
import html
|
|
import json
|
|
from collections.abc import Callable
|
|
from typing import Any
|
|
from urllib.parse import urlencode
|
|
|
|
from desk.sources import strip_html
|
|
|
|
from ._contract import Ask, Fields, Filters, Place, Reads
|
|
from ._shared import Get, Page, Row, is_web_url, only, parse_dt
|
|
|
|
NAME = "platsbanken"
|
|
LABEL = "Platsbanken"
|
|
RANK = 30
|
|
|
|
READS = Reads(
|
|
scope="search", listing="paged", page_size=100, ceiling=2000,
|
|
text="listing", complete="stated",
|
|
filters=Filters(query="one", place="one"),
|
|
places="many",
|
|
fields=Fields(posted="trusted", country="stated"),
|
|
robots="read: the host publishes no robots.txt, /robots.txt answers 404 "
|
|
"(checked 2026-09-30)")
|
|
|
|
#: Saved param -> the filter dimension it fills.
|
|
PARAMS = {"q": "query", "region": "place"}
|
|
|
|
SEARCH = "https://jobsearch.api.jobtechdev.se/search"
|
|
|
|
#: The 21 Swedish län as concept ids of the JobTech taxonomy, from its `region`
|
|
#: concepts (which also list regions outside Sweden). "" is all of Sweden and
|
|
#: is not a key here.
|
|
REGIONS: dict[str, str] = {
|
|
"DQZd_uYs_oKb": "Blekinge län", "oDpK_oZ2_WYt": "Dalarnas län",
|
|
"K8iD_VQv_2BA": "Gotlands län", "zupA_8Nt_xcD": "Gävleborgs län",
|
|
"wjee_qH2_yb6": "Hallands län", "65Ms_7r1_RTG": "Jämtlands län",
|
|
"MtbE_xWT_eMi": "Jönköpings län", "9QUH_2bb_6Np": "Kalmar län",
|
|
"tF3y_MF9_h5G": "Kronobergs län", "9hXe_F4g_eTG": "Norrbottens län",
|
|
"CaRE_1nn_cSU": "Skåne län", "CifL_Rzy_Mku": "Stockholms län",
|
|
"s93u_BEb_sx2": "Södermanlands län", "zBon_eET_fFU": "Uppsala län",
|
|
"EVVp_h6U_GSZ": "Värmlands län", "g5Tt_CAV_zBd": "Västerbottens län",
|
|
"NvUF_SP1_1zo": "Västernorrlands län", "G6DV_fKE_Viz": "Västmanlands län",
|
|
"zdoY_6u5_Krt": "Västra Götalands län", "xTCk_nT5_Zjm": "Örebro län",
|
|
"oLT3_Q9p_3nn": "Östergötlands län",
|
|
}
|
|
|
|
|
|
def allowed(slug: str) -> Callable[[str], bool]:
|
|
return only("jobsearch.api.jobtechdev.se")
|
|
|
|
|
|
def clean_params(params: dict[str, Any]) -> dict[str, Any]:
|
|
"""The saved params of a search: `q` and `region`, the id of a län or
|
|
empty for all of Sweden."""
|
|
region = str(params.get("region") or "").strip()
|
|
if region and region not in REGIONS:
|
|
raise ValueError("region is empty or the id of a Swedish län")
|
|
return {"q": params["q"], "region": region}
|
|
|
|
|
|
def _text(fragment: str) -> str:
|
|
return html.unescape(strip_html(fragment)).strip()
|
|
|
|
|
|
def page(get: Get, slug: str, cursor: Any, ask: Ask) -> Page:
|
|
"""One page of a search, newest first; the cursor is the offset. The next
|
|
page follows a full page while the offset is within the ceiling."""
|
|
region = str(ask.places[0] if ask.places else ask.params.get("region") or "")
|
|
if region and region not in REGIONS:
|
|
raise ValueError(f"platsbanken region {region!r} is not one of the ids in REGIONS")
|
|
size, ceiling = READS.page_size or 100, READS.ceiling or 2000
|
|
offset = int(cursor or 0)
|
|
query: dict[str, Any] = {"q": ask.query or str(ask.params.get("q") or ""),
|
|
"sort": "pubdate-desc", "limit": size, "offset": offset}
|
|
if region:
|
|
query["region"] = region
|
|
data = json.loads(get(SEARCH + "?" + urlencode(query)))
|
|
hits = [hit for hit in data.get("hits") or [] if isinstance(hit, dict)]
|
|
total = (data.get("total") or {}).get("value")
|
|
more = len(hits) >= size and offset + size <= ceiling
|
|
return (data, [{"id": str(hit.get("id") or "")} for hit in hits],
|
|
total if isinstance(total, int) else None, offset + size if more else None)
|
|
|
|
|
|
def _place(address: dict[str, Any]) -> Place | None:
|
|
text = (address.get("municipality") or address.get("region")
|
|
or address.get("country") or "").strip()
|
|
return {"text": text, "remote": None} if text else None
|
|
|
|
|
|
def rows(decoded: Any, slug: str) -> list[Row]:
|
|
out: list[Row] = []
|
|
for hit in decoded.get("hits") or []:
|
|
title = _text(hit.get("headline") or "")
|
|
url = (hit.get("webpage_url") or "").strip()
|
|
if not title or not is_web_url(url):
|
|
continue
|
|
addresses = hit.get("workplace_addresses") or [hit.get("workplace_address") or {}]
|
|
places = [place for address in addresses if isinstance(address, dict)
|
|
if (place := _place(address))]
|
|
model = str((hit.get("workplace_model") or {}).get("label") or "").strip()
|
|
out.append({
|
|
"source_id": str(hit.get("id") or ""),
|
|
"title": title,
|
|
"company": ((hit.get("employer") or {}).get("name") or "").strip(),
|
|
"url": url,
|
|
"places": places,
|
|
"location": places[0]["text"] if places else "",
|
|
"country": "SE",
|
|
"remote": model or None,
|
|
"posted": parse_dt(hit.get("publication_date")),
|
|
"description": _text((hit.get("description") or {}).get("text") or ""),
|
|
})
|
|
return out
|