Jobsuche API JS - TypeScript Library for Arbeitsagentur Job Search

jobsuche-api-js is a simple JavaScript/TypeScript library designed to interact with the Jobsuche API provided by the German Federal Employment Agency (Arbeitsagentur). This library simplifies fetching job listings, job details, and search functionality for developers integrating job search features into their web applications.

Status

This library is currently in beta. We are actively working on improving the library. Please report any issues you encounter.

Features

• Fetch job search results by location and keyword
• Retrieve detailed information about specific job listings
• Built-in authentication with API Key
• Lightweight and easy to integrate with any JavaScript or TypeScript project

Installation

npm install jobsuche-api-js

Overview

jobsuche-api-js fetches jobs from the Arbeitsagentur API. It simplifies the process of retrieving job listings and details using modern JavaScript techniques.

Usage

Note:

No need to initialize the app anymore, as adding "X-API-KEY": "jobboerse-jobsuche" to the headers is added automatically in all requests. This is the authentication needed in the latest update of the Jobsuche API. For more details, check theFor more details, check the official Arbeitsagentur Jobsuche API Documentation.

Fetch Job Search Results

import { jobsSearch } from 'jobsuche-api-js';

const searchParams = { what: 'developer', where: 'Berlin' };
jobsSearch(searchParams).then(response => console.log(response))
.catch(error => console.error(error));

Fetch Job Details

import { jobDetails } from 'jobsuche-api-js';

const jobRef = '11112-44023-1558466-0-S';
jobDetails(jobRef).then(details => console.log(details))
.catch(error => console.error(error));