{"openapi":"3.1.0","info":{"title":"Kollegia jobbsøk-API","version":"1.0.0","summary":"Ledige stillinger, lønn og arbeidsgivere i Norge.","description":"Åpent og skrivebeskyttet API for de offentlige dataene på kollegia.no: aktive stillinger (lagt ut hos Kollegia og hentet fra arbeidsplassen.nav.no),\nlønn per yrke fra SSB og arbeidsgivere med ledige stillinger. Ingen nøkkel eller innlogging. Innholdet er på norsk.\n\nVilkår: lenk alltid til `url` i svaret, der brukeren leser hele annonsen og søker. Stillinger tas ned når de lukkes eller utløper;\nmellomlagre derfor ikke svar lenger enn én time, og vis ikke stillinger som ikke lenger finnes i API-et.\nLønn merket «ca.» er et anslag fra SSBs medianlønn for yrket, ikke oppgitt av arbeidsgiveren.\n\nGrenser: 60 kall i minuttet og 2 000 i døgnet per IP-adresse (429 med Retry-After over grensen). Svarene mellomlagres i inntil fem minutter.\n\nDet samme finnes som MCP-server for KI-assistenter på https://kollegia.no/mcp (Streamable HTTP). Dokumentasjon: https://kollegia.no/api","contact":{"name":"Kollegia","url":"https://kollegia.no/api","email":"hjelp@kollegia.no"},"termsOfService":"https://kollegia.no/vilkar"},"servers":[{"url":"https://kollegia.no"}],"security":[],"externalDocs":{"url":"https://kollegia.no/api","description":"Kollegia for utviklere og KI-assistenter"},"paths":{"/api/v1/jobs":{"get":{"operationId":"searchJobs","summary":"Søk i aktive stillinger","description":"Minst ett av q, sted, yrke eller ansettelsesform. Beste treff i tittelen og nyeste først.","parameters":[{"name":"q","in":"query","schema":{"type":"string"},"description":"Fritekst mot tittel, arbeidsgiver og yrke, f.eks. «kokk» eller «Rema 1000»."},{"name":"sted","in":"query","schema":{"type":"string"},"description":"Kommune, bydel, fylke eller landsdel, f.eks. «Bergen», «Grünerløkka», «Vestland», «Nord-Norge», eller «hjemmefra»."},{"name":"yrke","in":"query","schema":{"type":"string"},"description":"Yrke, f.eks. «Kokk» eller «Elektriker»."},{"name":"ansettelsesform","in":"query","schema":{"type":"string","enum":["heltid","deltid","fast","vikariat","sesong","engasjement","lærling","trainee"]}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":20,"default":10}},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"maximum":200,"default":0}}],"responses":{"200":{"description":"Treffene","content":{"application/json":{"schema":{"type":"object","required":["total","jobs","search_url"],"properties":{"total":{"type":"integer","description":"Antall aktive stillinger som passer."},"returned":{"type":"integer"},"offset":{"type":"integer"},"location":{"type":["object","null"],"description":"Stedet slik det ble tolket, med lenke til stedssiden."},"occupation":{"type":["object","null"],"description":"Yrket slik det ble tolket, med lenke til yrkessiden."},"note":{"type":["string","null"]},"jobs":{"type":"array","items":{"$ref":"#/components/schemas/Job"}},"search_url":{"type":"string","format":"uri","description":"Det samme søket på kollegia.no."}}}}}},"400":{"description":"Mangler filter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"For mange kall","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/jobs/{id}":{"get":{"operationId":"getJob","summary":"Én aktiv stilling","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Stillingen","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobDetail"}}}},"404":{"description":"Finnes ikke","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"Ikke lenger aktiv (lukket, besatt eller utløpt)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"For mange kall","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/salary":{"get":{"operationId":"salaryForOccupation","summary":"Lønn og ledige stillinger i et yrke","description":"Medianlønn, kvartiler og timelønn fra SSB (hele landet), og antall ledige hos Kollegia og i Norge (NAV). Med sted: antall ledige der.","parameters":[{"name":"yrke","in":"query","required":true,"schema":{"type":"string"},"description":"F.eks. «kokk», «sykepleier», «tømrer»."},{"name":"sted","in":"query","schema":{"type":"string"},"description":"Kommune eller fylke."}],"responses":{"200":{"description":"Lønn og ledige","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Salary"}}}},"404":{"description":"Fant ikke yrket (svaret foreslår lignende)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"For mange kall","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/employers":{"get":{"operationId":"employerJobs","summary":"Aktive stillinger hos en arbeidsgiver","parameters":[{"name":"navn","in":"query","required":true,"schema":{"type":"string"},"description":"Navn eller slug, f.eks. «Rema 1000»."}],"responses":{"200":{"description":"Arbeidsgiveren og stillingene, eller forslag","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmployerJobs"}}}},"429":{"description":"For mange kall","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"schemas":{"Job":{"type":"object","required":["id","title","employer","url"],"properties":{"id":{"type":"string"},"title":{"type":"string","examples":["Kokk"]},"employer":{"type":"string","examples":["Hotel Norge AS"]},"location":{"type":"string","examples":["Bergen"]},"county":{"type":["string","null"]},"employment_type":{"type":["string","null"],"examples":["Heltid, fast"]},"work_mode":{"type":["string","null"],"examples":["På arbeidsplassen"]},"deadline":{"type":["string","null"],"format":"date","description":"Siste dag annonsen er ute (søknadsfrist)."},"published":{"type":["string","null"],"format":"date"},"salary":{"type":["object","null"],"description":"Lønnen som på stillingskortet: oppgitt i annonsen, ellers et anslag fra SSBs medianlønn for yrket (merket «ca.»).","properties":{"text":{"type":"string","examples":["ca. 224 kr/t","250–280 kr/t"]},"source":{"type":"string","enum":["stated_in_ad","ssb_estimate"]},"monthly_nok":{"type":["number","null"],"description":"Månedslønn i kroner (SSB-medianen, eller oppgitt lønn regnet om)."}}},"summary":{"type":"string"},"requirements":{"type":"array","items":{"type":"string"},"examples":[["Fagbrev Kokk","Førerkort B"]]},"url":{"type":"string","format":"uri","description":"Stillingen på kollegia.no, der man leser hele annonsen og søker. Lenk alltid hit."}}},"JobDetail":{"allOf":[{"$ref":"#/components/schemas/Job"},{"type":"object","properties":{"description":{"type":"string","description":"Annonseteksten, forkortet og uten kontaktopplysninger."},"deadline_note":{"type":["string","null"],"examples":["Snarest"]},"about_employer":{"type":["string","null"]},"start":{"type":["string","null"]},"positions":{"type":["integer","null"]},"sector":{"type":["string","null"]},"source":{"type":"string","enum":["kollegia","nav","imported"]},"employer_url":{"type":["string","null"],"format":"uri"},"occupation_url":{"type":["string","null"],"format":"uri"}}}]},"Salary":{"type":"object","properties":{"occupation":{"type":"object","properties":{"name":{"type":"string"},"slug":{"type":"string"},"styrk":{"type":"string"},"styrk_name":{"type":"string"}}},"salary":{"type":["object","null"],"properties":{"median_monthly_nok":{"type":"number"},"lower_quartile_monthly_nok":{"type":["number","null"]},"upper_quartile_monthly_nok":{"type":["number","null"]},"median_hourly_nok":{"type":"number","description":"Medianen delt på 162,5 timer (37,5 t/uke)."},"median_yearly_nok":{"type":"number"},"employees":{"type":["number","null"]},"year":{"type":["string","null"]},"vs_all_occupations_pct":{"type":["number","null"]},"source":{"type":"string"}}},"open_jobs":{"type":"object","properties":{"kollegia":{"type":"integer"},"norway":{"type":["integer","null"]},"norway_source":{"type":"string"}}},"location":{"type":["object","null"]},"url":{"type":"string","format":"uri"},"note":{"type":["string","null"]}}},"EmployerJobs":{"type":"object","properties":{"employer":{"type":["object","null"]},"jobs":{"type":"array","items":{"$ref":"#/components/schemas/Job"}},"total":{"type":"integer"},"url":{"type":["string","null"],"format":"uri"},"suggestions":{"type":"array","items":{"type":"object"}},"note":{"type":["string","null"]}}},"Error":{"type":"object","properties":{"error":{"type":"string"},"status":{"type":"integer"}}}}}}