Tutorial: NAV Jobs (Norwegian Labour Market)

Economics

Data source: NAV Arbeidsplassen (arbeidsplassen.nav.no)

Overview

NAV Jobs (Norwegian Labour Market) wraps NAV Arbeidsplassen (arbeidsplassen.nav.no), handling authentication, pagination, and rate limits for you. This tutorial covers all 3 tools with working code examples you can copy and run.

Prerequisites

Sign up at https://context.gnist.ai/signup for a free API key (100 calls/day).
Choose your integration method: MCP protocol or REST API.

Connect via MCP

Add to your MCP client config (Claude Desktop, Cursor, etc.):

MCP Config

{
  "mcpServers": {
    "gnist-nav-jobs": {
      "url": "https://context.gnist.ai/mcp/nav-jobs/",
      "headers": {
        "Gnist-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Tools (3)

`search_nav_jobs`

Search Norwegian job listings from NAV Arbeidsplassen. NAV (Norwegian Labour and Welfare Administration) aggregates job listings from employers across Norway. Results include job title, employer, location, application deadline, and occupation categories. Args: query: Free-text search (e.g. 'utvikler', 'sykepleier', 'ingeniør'). county: County name in uppercase (e.g. 'OSLO', 'ROGALAND'). municipal: Municipality name in uppercase (e.g. 'OSLO', 'BERGEN'). size: Results per request (25 or 100, default 25). offset: Number of results to skip (default 0). Returns: Object with jobs list, total count, size, and offset.

Parameter	Type	Required	Description
`query`	any	optional	Free-text search query for Norwegian job listings (e.g. 'utvikler', 'sykepleier', 'ingeniør').
`county`	any	optional	Norwegian county name in uppercase, e.g. 'OSLO', 'ROGALAND', 'VESTLAND', 'TRØNDELAG', 'NORDLAND', 'VESTFOLD OG TELEMARK'.
`municipal`	any	optional	Norwegian municipality name in uppercase, e.g. 'OSLO', 'BERGEN', 'TRONDHEIM', 'STAVANGER', 'TROMSØ'. Added to the free-text query for approximate location filtering.
`size`	integer	optional	Number of results — snapped to 25 or 100 (API constraint). Default 25. (default: `25`)
`offset`	integer	optional	Number of results to skip for pagination (default 0). (default: `0`)

curl -X POST "https://context.gnist.ai/mcp/nav-jobs/" \
  -H "Content-Type: application/json" \
  -H "Gnist-API-Key: YOUR_API_KEY" \
  -d '{"jsonrpc": "2.0", "method": "tools/call", "id": 1, "params": {"name": "search_nav_jobs", "arguments": {"query": "'utvikler'"}}}'

import httpx

resp = httpx.post(
    "https://context.gnist.ai/mcp/nav-jobs/",
    headers={"Gnist-API-Key": "YOUR_API_KEY"},
    json={'id': 1,
 'jsonrpc': '2.0',
 'method': 'tools/call',
 'params': {'arguments': {'query': "'utvikler'"}, 'name': 'search_nav_jobs'}},
)
print(resp.json())

`get_nav_job`

Get a single Norwegian job listing by its UUID from NAV Arbeidsplassen. Returns the job listing including title, employer, location, application deadline, and occupation categories. Args: uuid: UUID of the job listing. Returns: Job listing record, or {"error": "not_found"} if the UUID is unknown.

Parameter	Type	Required	Description
`uuid`	string	required	UUID of the job listing to retrieve.

curl -X POST "https://context.gnist.ai/mcp/nav-jobs/" \
  -H "Content-Type: application/json" \
  -H "Gnist-API-Key: YOUR_API_KEY" \
  -d '{"jsonrpc": "2.0", "method": "tools/call", "id": 1, "params": {"name": "get_nav_job", "arguments": {"uuid": "12345"}}}'

import httpx

resp = httpx.post(
    "https://context.gnist.ai/mcp/nav-jobs/",
    headers={"Gnist-API-Key": "YOUR_API_KEY"},
    json={'id': 1,
 'jsonrpc': '2.0',
 'method': 'tools/call',
 'params': {'arguments': {'uuid': '12345'}, 'name': 'get_nav_job'}},
)
print(resp.json())

`report_feedback`

Report a bug, feature request, or general feedback for this data source. Use this when something doesn't work as expected, when you'd like a new feature, or when you have suggestions for improvement. Args: feedback: Describe the issue or suggestion. feedback_type: One of 'bug', 'feature_request', or 'general'.

Parameter	Type	Required	Description
`feedback`	string	required
`feedback_type`	string	optional	(default: `general`)

curl -X POST "https://context.gnist.ai/mcp/nav-jobs/" \
  -H "Content-Type: application/json" \
  -H "Gnist-API-Key: YOUR_API_KEY" \
  -d '{"jsonrpc": "2.0", "method": "tools/call", "id": 1, "params": {"name": "report_feedback", "arguments": {"feedback": "example"}}}'

import httpx

resp = httpx.post(
    "https://context.gnist.ai/mcp/nav-jobs/",
    headers={"Gnist-API-Key": "YOUR_API_KEY"},
    json={'id': 1,
 'jsonrpc': '2.0',
 'method': 'tools/call',
 'params': {'arguments': {'feedback': 'example'}, 'name': 'report_feedback'}},
)
print(resp.json())

Common Patterns

Search then retrieve
Use search_nav_jobs to find items, then get_nav_job to get full details. This two-step pattern is common for exploring data before drilling down.

Pagination
Several tools support limit, offset, or page parameters. Start with small limits during development, then increase for production queries.

FAQ

What data does NAV Jobs (Norwegian Labour Market) provide?

Norwegian public job listings — search positions, employers, and occupations from NAV Arbeidsplassen. It exposes 3 tools: search_nav_jobs, get_nav_job, report_feedback.

What do I need to get started?

A Gnist API key (free tier: 100 calls/day). Sign up at https://context.gnist.ai/signup.

What format does the NAV Jobs (Norwegian Labour Market) API return?

JSON, via either MCP protocol (JSON-RPC 2.0) or REST API.