Arbeitsamt API

Jobs / OAuth Advanced HTTPS
Varies by plan (check documentation)

Overview

Arbeitsamt (Bundesagentur für Arbeit) is the official German federal employment agency API, providing access to millions of job listings across Germany. It uses OAuth 2.0 for authentication and returns rich, structured job data including location, salary hints, and employer details. If you are building a German-market job app, this is the authoritative data source.

💡

Beginner Tip

You will need an OAuth 2.0 client credentials token before making job search requests. The API is publicly accessible — request a token from the bund.dev portal and include it as a Bearer token in your Authorization header.

Available Data

Arbeitsamt data via REST API
JSON-formatted response data
Requires OAuth authentication

Example Response

JSON Response
{
  "title": "Software Engineer",
  "company": "Tech Corp",
  "location": "Remote",
  "salary_range": "$120,000 - $180,000",
  "posted_date": "2025-01-10",
  "description": "We are looking for an experienced..."
}

Field Reference

stellenangebote Array of job offer objects returned by the search.
stellenangebote[].titel Job title in German.
stellenangebote[].arbeitgeber Name of the employer.
stellenangebote[].arbeitsort.ort City or town where the job is located.
stellenangebote[].eintrittsdatum Expected start date for the position (ISO 8601 format).
maxErgebnisse Total number of matching job offers across all pages.

Implementation Example

const url = "https://jobsuche.api.bund.dev/";
// Replace headers or query params with the values required by this API.
const response = await fetch(url, {
  headers: {
  "Authorization": "Bearer YOUR_API_KEY"
  }
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
console.log(data);

What Can You Build?

Note: These code examples are AI-generated and unverified. Always refer to the official API documentation for accurate usage.

Common Errors & Troubleshooting

401 Unauthorized The Bearer token is missing, expired, or malformed.
Re-request a fresh OAuth token using the client credentials flow and include it as Authorization: Bearer <token>.
400 Bad Request on search Required search parameters like "was" (what) or "wo" (where) are missing.
Include at least one search term parameter; refer to the official OpenAPI spec at jobsuche.api.bund.dev for all supported fields.
Token expires quickly OAuth tokens have a short TTL (typically 60 minutes).
Cache the token and refresh it before expiry by tracking the expires_in value returned with the token.

Matrix Score Breakdown

🌐 Reachability 30/30
⚡ Speed 15/20
🔒 Security 15/15
🛠 Developer XP 3/20
✓ Reliability 10/15

Partially tested on Apr 5, 2026

Technical Specifications

Auth OAuth
HTTPS REQUIRED
CORS UNKNOWN
Category Jobs
Difficulty Advanced
Verified: 2026-04-04

Similar APIs

View All →