# Introduction

The Jobs-database.de API is a read-only HTTP API over job postings. Every job was collected
from a company's own applicant tracking system (ATS) and links back to the original posting.

## What you can do

| Endpoint | What it does |
| --- | --- |
| `GET /v1/jobs` | Page through all jobs, ordered by `id` |
| `GET /v1/search?q=…` | Find jobs whose title or company name contains a term |
| `GET /v1/jobs/{job_id}` | Fetch one job by its id |

Base URL:

```text
https://api.jobs-database.de
```

All responses are JSON. Every `/v1` request is authenticated with an API key in the
`X-API-Key` header — see [Authentication](/api-documentation/authentication).

## What a job looks like

Each job carries 25 fields: identity and link (`id`, `title`, `organization`, `url`), dates,
the source system, location (city, region, country, time zone, coordinates), employment type,
work arrangement and the salary **as posted**. Job descriptions are not served. Every field is
listed in the [Field reference](/api-documentation/field-reference).

## How usage is counted

You are charged in **jobs returned**, not in requests. Each job in a successful response counts
once against your key's monthly allowance; a `404` or an error counts nothing. The allowance
resets on the 1st of every month at 00:00 UTC. Details: [Errors & limits](/api-documentation/errors-and-limits).

## Next steps

- [Quick start](/api-documentation/quickstart) — your first request and a complete paging loop.
- [API Reference](/api-documentation/api) — every endpoint, parameter and response.
- [Plans and pricing](https://jobs-database.de/pricing) — allowances per plan.