Nederlandse Arbeidsmarkt & Salaris Benchmarks

De YieldFactory DaaS (Data-as-a-Service) REST API levert genormaliseerde, realtime salarisbenchmarks, marktgemiddelden, en percentielen (p25, p50, p75) op basis van meer dan 600 geanalyseerde Nederlandse vacatures.

Openbare Documentatie vs. Beveiligde Productietoegang

Deze documentatie en specificatie zijn openbaar inzichtelijk zodat software-architecten endpoints en schema's vooraf kunnen testen. Het daadwerkelijk uitvoeren van verzoeken naar /api/v1/benchmarks is strikt beveiligd met een gelicentieerde Bearer API Key. Zonder actieve sleutel retourneert de API 401 Unauthorized.

Vraag API Key Aan →

Authenticatie

Elk request vereist een geldige Bearer token via de Authorization HTTP header.

Authorization: Bearer yf_live_xxxxxxxxxxxxxxxx

Base URL & Format

Alle endpoints retourneren UTF-8 JSON en ondersteunen gzip/br compressie en CORS voor geautoriseerde domeinen.

https://yieldfactory.nl/api/v1

GET/api/v1/benchmarks

Quota: Starter (10.000) · Enterprise (100.000)

Query Parameters

Parameter	Type	Vereist	Omschrijving
title	string	Optioneel	Filtert op functietitel (fuzzy match, bijv. "Software Engineer")
category	string	Optioneel	Filtert op functiecategorie (bijv. "IT / Tech", "Financieel")
limit	integer	Optioneel (def: 50)	Aantal resultaten (1 t/m 250)

Code Voorbeelden

cURL

curl -X GET "https://yieldfactory.nl/api/v1/benchmarks?title=Software%20Engineer&limit=10" \
  -H "Authorization: Bearer yf_live_your_api_token" \
  -H "Accept: application/json"

TypeScript / JavaScript

const res = await fetch('https://yieldfactory.nl/api/v1/benchmarks?title=Software%20Engineer&limit=10', {
  headers: {
    'Authorization': 'Bearer yf_live_your_api_token',
    'Accept': 'application/json'
  }
});
const data = await res.json();
console.log(data);

Voorbeeld Respons (200 OK)

JSON (application/json)

{
  "success": true,
  "client": {
    "company": "Acme Recruitment BV",
    "tier": "enterprise",
    "quota": {
      "used": 142,
      "max": 100000,
      "remaining": 99858
    }
  },
  "meta": {
    "count": 1,
    "filter": {
      "title": "Software Engineer",
      "category": null
    }
  },
  "data": [
    {
      "job_title": "Software Engineer",
      "category": "IT / Tech",
      "avg_bruto": 4350,
      "salary_min": 3200,
      "salary_max": 5800,
      "p25": 3600,
      "p50": 4300,
      "p75": 5100,
      "data_points": 48,
      "updated_at": "2026-10-13T16:30:35.000Z"
    }
  ]
}

Status Codes

200 OK

Succesvolle data response met benchmarks en quota stand.

401 Unauthorized

Bearer token ontbreekt of is onjuist geformatteerd.

403 Forbidden

Sleutel ingetrokken, inactief of ongeldig in database.

429 Too Many Requests

Maandquota overschreden. Upgrade via partner dashboard.

Interactieve API Sandbox

Test live requests direct tegen het productie cluster

Bearer API Token

Functie Zoekterm