Employer API

Komma igång

1. Gå till företagsportalen → API-åtkomst och skapa en nyckel.
2. Kopiera nyckeln (den visas bara en gång — spara säkert).
3. Skicka ditt första jobb (curl-exempel nedan).

Autentisering

Alla anrop kräver en Authorization: Bearer header med din API-nyckel.

Authorization: Bearer jsai_live_xxxxxxxxxxxxxxxxxxxxxxxx

Bas-URL: https://jobscanner.ai/api/public/v1

Endpoints

Job-objekt

external_id är ditt unika id för jobbet (t.ex. ATS-id). Allt annat är valfritt utom title och apply_url.

{
  "external_id": "req-12345",
  "title": "Senior Backend Engineer",
  "description": "Vi söker en erfaren...",
  "location": "Stockholm",
  "region": "Stockholm",
  "remote": "hybrid",            // "yes" | "no" | "hybrid"
  "employment_type": "Heltid",
  "category": "Engineering",
  "salary_text": "55 000–70 000 kr/mån",
  "apply_url": "https://karriar.exempel.se/jobs/12345",
  "published_at": "2026-06-11T08:00:00Z",  // ISO-8601, valfritt
  "expires_at": null,
  "country_code": "SE"
}

Exempel

Skapa eller uppdatera jobb

curl -X POST https://jobscanner.ai/api/public/v1/jobs \
  -H "Authorization: Bearer jsai_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "external_id": "req-12345",
    "title": "Senior Backend Engineer",
    "location": "Stockholm",
    "apply_url": "https://karriar.exempel.se/jobs/12345"
  }'

Lista dina jobb

curl https://jobscanner.ai/api/public/v1/jobs?limit=20 \
  -H "Authorization: Bearer jsai_live_xxx"

Avpublicera

curl -X DELETE https://jobscanner.ai/api/public/v1/jobs/req-12345 \
  -H "Authorization: Bearer jsai_live_xxx"

Svarsformat

Alla svar är JSON. Lyckade svar innehåller data (objekt eller lista). Fel innehåller {"error":{"code","message"}}.

Felkoder

Kommer snart

• Outbound webhooks (job.viewed, job.clicked, application.submitted)
• Officiella SDK:er (TypeScript, Python)
• Batch-endpoint för upp till 100 jobb per anrop