Jobnet Search

Jobnet-Search Skill

Access live Danish job listings from the Jobnet.dk public API. No authentication needed. Jobnet is operated by STAR (Styrelsen for Arbejdsmarked og Rekruttering) and is Denmark's official government job portal — covering public sector positions as well as many private sector listings. Approximately 21,000+ active jobs at any time.

When to use this skill

Invoke this skill when the user wants to:

• Search for job openings in Denmark by keyword, title, or employer
• Filter jobs by region, work hours (full/part time), or employment duration (permanent/temporary)
• Find jobs near a specific postal code within a given radius
• Get full details for a specific job ad including description, contact persons, and application URL
• Discover occupation types and ESCO categories for more precise job filtering
• Explore autocomplete suggestions for Danish job titles or keywords
• Find jobs in the public sector, healthcare, IT, education, or any other Danish industry

Commands

Search for job ads

bun run skills/jobnet-search/cli/src/cli.ts search [flags]

Key flags:

• --search-string <text> — keyword search, e.g. sygeplejerske, ingeniør, pædagog
• --region <region> — HovedstadenOgBornholm, Midtjylland, Syddanmark, OevrigeSjaelland, Nordjylland
• --postal-code <code> — postal code for radius-based search, e.g. 2100
• --radius <km> — radius in km from postal code (default: 50)
• --work-hours <type> — FullTime or PartTime
• --duration <type> — Permanent or Temporary
• --job-type <type> — Ordinaert, Efterloenner, Foertidspension
• --occupation-area <id> — occupation area identifier, e.g. 10000
• --occupation-group <id> — occupation group identifier, e.g. 10060
• --order <type> — PublicationDate (default), BestMatch, ApplicationDate
• --page / --per-page / --limit
• --format json|table|plain

Full job ad detail

bun run skills/jobnet-search/cli/src/cli.ts detail <jobAdId> [--format json|plain]

jobAdId is the UUID from search results (the jobAdId field). Returns the complete job description, contact persons, application deadline, employer details, and direct application URL.

Search occupation types

bun run skills/jobnet-search/cli/src/cli.ts occupations --search-string <text> [--per-page <n>]

Use this to discover ESCO occupation identifiers before passing them to search with --occupation-area or --occupation-group.

Typeahead suggestions

bun run skills/jobnet-search/cli/src/cli.ts suggestions --query <text> [--limit <n>]

Returns Danish job title autocomplete strings. Useful for exploring valid Danish job titles before constructing a search query.

---

How to use effectively

Discover occupations first. Use occupations or suggestions to find the right Danish term or ESCO identifier before running a search:

bun run skills/jobnet-search/cli/src/cli.ts suggestions --query "syge"
bun run skills/jobnet-search/cli/src/cli.ts occupations --search-string "sygeplejerske"

Natural workflow: `search` → `detail`. 1. Use search to get a list of matching jobs with their jobAdId. 2. Call detail <jobAdId> to get the full job description, contact persons, and direct application link.

Use `--format table` for comparisons, --format json for data processing, and --format plain for single-record detail views (strips HTML from job body).

Pagination: --per-page controls server-side results per page. --limit caps what the CLI outputs. Use --page + --per-page to iterate through large result sets.

Geographic search modes:

• Use --region for broad regional filtering (e.g. all of Midtjylland)
• Use --postal-code + --radius for jobs near a specific location
• Do not combine --region and --postal-code in the same query

Order matters for intent:

• PublicationDate — newest postings first (default, good for "what's new")
• BestMatch — relevance score (best when --search-string is provided)
• ApplicationDate — earliest deadline first (good for urgent applications)

---

Usage examples

Jobs in Copenhagen area

bun run skills/jobnet-search/cli/src/cli.ts search \
  --region HovedstadenOgBornholm \
  --per-page 10 \
  --format table

Nurse jobs nationwide

bun run skills/jobnet-search/cli/src/cli.ts search \
  --search-string "sygeplejerske" \
  --work-hours FullTime \
  --duration Permanent \
  --order BestMatch \
  --per-page 10 \
  --format table

IT jobs near Aarhus within 30km

bun run skills/jobnet-search/cli/src/cli.ts search \
  --search-string "udvikler" \
  --postal-code 8000 \
  --radius 30 \
  --work-hours FullTime \
  --format table

Full details of a job ad

bun run skills/jobnet-search/cli/src/cli.ts detail 9ef43bce-d82b-4ea1-a098-7ff6520f99be --format plain

Jobs sorted by application deadline (urgent first)

bun run skills/jobnet-search/cli/src/cli.ts search \
  --search-string "pædagog" \
  --region OevrigeSjaelland \
  --order ApplicationDate \
  --per-page 10

Discover occupation terms

bun run skills/jobnet-search/cli/src/cli.ts suggestions --query "ingeniør" --limit 5
bun run skills/jobnet-search/cli/src/cli.ts occupations --search-string "lærer" --per-page 5

---

Output formats

All errors are written to stderr as { "error": "...", "code": "..." } and the process exits with code 1.

---

Notes

• All data is from the public jobnet.dk/bff REST API — no credentials required.
• The API requires the x-csrf: 1 header; the CLI adds this automatically.
• Pagination is 1-indexed (--page 1 is the first page).
• search results omit the HTML job description — use detail to get it.
• detail --format plain strips HTML tags for readable text output.
• Job ad detail pages on jobnet.dk: https://jobnet.dk/job/{jobAdId}
• suggestions is tuned for Danish job titles — English terms may return empty results.

jobnet-cli

CLI for the Jobnet.dk Danish government job portal API.

Base URL: https://jobnet.dk/bff Authentication: No credentials required. All public endpoints only need the x-csrf: 1 request header. Format: All responses are JSON.

---

Installation

cd skills/jobnet-search/cli
bun install

---

Commands

All commands accept --format json|table|plain (default: json). All errors are written to stderr as { "error": "...", "code": "..." } and the process exits with code 1.

---

Regions

---

Order types

---

search — Search for job ads

Endpoint: GET /FindJob/Search

bun run src/cli.ts search [flags]

Flags

Example

bun run src/cli.ts search \
  --search-string "sygeplejerske" \
  --region HovedstadenOgBornholm \
  --work-hours FullTime \
  --duration Permanent \
  --per-page 5 \
  --format table

bun run src/cli.ts search \
  --postal-code 8000 \
  --radius 25 \
  --per-page 10

Response shape

{
  "meta": {
    "totalJobAdCount": 21452,
    "pageNumber": 1,
    "resultsPerPage": 10,
    "searchString": "developer"
  },
  "facets": {
    "regions": [
      { "type": "HovedstadenOgBornholm", "jobAdCount": 6642 }
    ],
    "workHours": [
      { "type": "FullTime", "jobAdCount": 17919 },
      { "type": "PartTime", "jobAdCount": 3533 }
    ],
    "employmentDurations": [
      { "type": "Permanent", "jobAdCount": 18533 },
      { "type": "Temporary", "jobAdCount": 2919 }
    ],
    "occupationAreas": [
      { "identifier": "10000", "jobAdCount": 3235 }
    ],
    "countries": [
      { "label": "Danmark", "identifier": "DK", "jobAdCount": 21164 }
    ]
  },
  "results": [
    {
      "jobAdId": "9ef43bce-d82b-4ea1-a098-7ff6520f99be",
      "title": "Akademisk medarbejder med interesse for arbejdsmiljø og uddannelse",
      "hiringOrgName": "Region Midtjylland",
      "occupation": "Personalekonsulent",
      "municipality": "Viborg",
      "postalCode": 8800,
      "postalDistrictName": "Viborg",
      "country": "Danmark",
      "publicationDate": "2026-03-13T00:00:00+01:00",
      "applicationDeadline": "2026-04-05T21:59:00+02:00",
      "applicationDeadlineStatus": "ExpirationDate",
      "workHourPartTime": false,
      "isExternal": false,
      "hasLogo": true,
      "logoUrl": "/bff/SharedComponents/JobAdCard/CompanyLogo/ByJobAdId/9ef43bce-d82b-4ea1-a098-7ff6520f99be",
      "cvr": "29190925",
      "workPlaceAddress": "",
      "conceptUriDa": "http://data.star.dk/esco/occupation/426e017f-ebe5-4bea-b1eb-7d2d5ab3c6db",
      "isSeen": false,
      "isFavorite": false
    }
  ]
}

Note: The description field (raw HTML) is intentionally omitted from search results for brevity. Use detail to retrieve the full job description.

Note: resultsPerPage and pageNumber must always be provided — omitting them while also providing searchString causes the API to return error 1014 ("Fejl i formatering af inputs").

---

detail — Full job ad detail

Endpoint: GET /FindJob/JobAdDetails/{id}

bun run src/cli.ts detail <id> [--format json|plain]

The id is the jobAdId UUID from search results.

By default the CLI passes incrementViews=false to avoid polluting view counts.

Example

bun run src/cli.ts detail 9ef43bce-d82b-4ea1-a098-7ff6520f99be
bun run src/cli.ts detail 9ef43bce-d82b-4ea1-a098-7ff6520f99be --format plain

Response shape

{
  "id": "9ef43bce-d82b-4ea1-a098-7ff6520f99be",
  "title": "Akademisk medarbejder med interesse for arbejdsmiljø og uddannelse",
  "body": "<p>Full HTML job description...</p>",
  "publicationDateTime": "2026-03-13T08:06:58.0578635+01:00",
  "unpublicationDateTime": "2026-04-05T21:59:00+02:00",
  "approvalStatus": "Godkendt",
  "views": 2,
  "createdDateTime": "2026-03-13T08:06:58.3936145+01:00",
  "updatedDateTime": "2026-03-13T08:06:58.3936145+01:00",
  "isAnonymousEmployer": false,
  "hasLogo": true,
  "logoUrl": "/bff/SharedComponents/JobAdCard/CompanyLogo/ByJobAdId/9ef43bce-d82b-4ea1-a098-7ff6520f99be",
  "employer": {
    "cvrNumber": "29190925",
    "pNumber": "1003367314",
    "name": "Region Midtjylland",
    "hasCompanyLogo": true
  },
  "job": {
    "type": "Ordinaert",
    "address": {
      "streetName": "Heibergs Alle 5A",
      "city": "Viborg",
      "postalCode": "8800",
      "municipality": "Viborg",
      "countryCode": "DK",
      "countryName": "Danmark"
    },
    "noFixedWorkplace": false,
    "isLimitedPeriod": false,
    "isDisabilityFriendly": false,
    "isPartTime": false,
    "employmentDate": "2026-06-01T00:00:00+02:00",
    "conceptUriDa": "http://data.star.dk/esco/occupation/426e017f-ebe5-4bea-b1eb-7d2d5ab3c6db",
    "preferredLabelDa": "Personalekonsulent",
    "driversLicenses": [],
    "classifications": [],
    "shifts": [],
    "isFavorite": false
  },
  "application": {
    "deadlineDate": "2026-04-05T21:59:00+02:00",
    "availablePositions": 1,
    "contactPersons": [
      {
        "firstNames": "Jane",
        "lastName": "Doe",
        "phoneNumber": "+4512345678"
      }
    ],
    "url": "https://midtjob.dk/ad/...",
    "urlText": "",
    "isApplicationDeadlineASAP": false
  },
  "organisationTypeId": 24,
  "user": "Emply 31430747"
}

Note: body contains raw HTML. In --format plain output the CLI strips HTML tags to produce readable text.

Note: application.url may be empty for some job ads — the employer may only accept applications through Jobnet's internal system.

---

occupations — Search occupation types

Endpoint: GET /OccupationSearch

bun run src/cli.ts occupations --search-string <text> [flags]

Use this command to find occupation identifiers (ESCO concept URIs) to pass as filters to search.

Flags

Example

bun run src/cli.ts occupations --search-string "sygeplejerske" --per-page 5

Response shape

[
  {
    "conceptUriDa": "http://data.star.dk/esco/occupation/56f5d45c-1234-4321-abcd-000000000000",
    "preferredLabelDa": "Sygeplejerske",
    "aliases": [
      {
        "aliasIdentifier": "some-uuid",
        "conceptUriDa": "http://data.star.dk/esco/occupation/56f5d45c-1234-4321-abcd-000000000000",
        "alternativeLabelDa": "Operationssygeplejerske"
      }
    ]
  }
]

Note: conceptUriDa is the full ESCO concept URI. The UUID portion (last path segment) can be used to build occupation filters for search.

---

suggestions — Typeahead suggestions

Endpoint: GET /FindJob/GetTypeaheadSuggestions

bun run src/cli.ts suggestions --query <text> [flags]

Returns autocomplete strings for the search box — useful for exploring valid Danish job titles before running a search.

Flags

Example

bun run src/cli.ts suggestions --query "syge"
bun run src/cli.ts suggestions --query "ingeniør" --limit 5

Response shape

[
  "sygepleje",
  "Sygeplejerske",
  "Sygeplejerske \"Lægeassistent\""
]

Note: Suggestions are tuned for Danish job titles. English terms like "developer" may return an empty array.

---

Error handling

All errors are written to stderr in JSON format and exit with code 1:

{ "error": "Job ad not found", "code": "NOT_FOUND" }
{ "error": "API request failed: 500 Internal Server Error", "code": "API_ERROR" }
{ "error": "--query is required", "code": "MISSING_REQUIRED" }
{ "error": "--search-string is required", "code": "MISSING_REQUIRED" }

---

URL construction

Job ad detail pages on jobnet.dk:

https://jobnet.dk/job/{jobAdId}

Company logo images (prefix relative logoUrl from API):

https://jobnet.dk{logoUrl}

Example: https://jobnet.dk/bff/SharedComponents/JobAdCard/CompanyLogo/ByJobAdId/9ef43bce-d82b-4ea1-a098-7ff6520f99be

---

Notes

• All data is from the public jobnet.dk/bff REST API — no credentials required.
• The x-csrf: 1 header must be sent with every request.
• Pagination is 1-indexed (--page 1 is the first page).
• search results intentionally omit the HTML description field — use detail to fetch it.
• body in detail responses is raw HTML; use --format plain to get stripped text.
• The occupations command helps discover ESCO occupation URIs usable as --occupation-area / --occupation-group seeds for narrowing search results.