# Ausbildung — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search and browse apprenticeship (Ausbildung) listings on ausbildung.de. Retrieve job posting details, explore the full catalog of recognized training professions, and look up salary and compensation data for any apprenticeship career.

**Category:** Jobs | **Website:** [ausbildung.de/](https://ausbildung.de/) | **Docs:** [parse.bot/marketplace/333a497f-c102-4b0a-a4cc-428a3a809318/ausbildung-de-api](https://parse.bot/marketplace/333a497f-c102-4b0a-a4cc-428a3a809318/ausbildung-de-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-ausbildung-de-api-333a497f/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_listing_detail

Fetch full structured details of one apprenticeship listing by its slug. Returns JSON-LD JobPosting data including HTML description, company info, postal address, contact emails, posting/expiry dates, and salary when available. The slug comes from search_listings results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Unique listing slug from search_listings.listings[*].slug |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ausbildung-de-api-333a497f/get_listing_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### get_profession_detail

Fetch detailed information about one apprenticeship career/profession by its slug, including a textual description, structured salary data (MonetaryAmountDistribution), and aggregate rating when available. The slug comes from list_all_professions.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Profession slug from list_all_professions.professions[*].slug |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ausbildung-de-api-333a497f/get_profession_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### get_profession_salary

Extract salary/compensation data for a specific apprenticeship profession. Returns a year-by-year breakdown of training salary ranges (year_1, year_2, year_3) parsed from the profession page, plus JSON-LD structured salary data when available. Some professions may have fewer years depending on training duration.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Profession slug from list_all_professions.professions[*].slug |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ausbildung-de-api-333a497f/get_profession_salary \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### list_all_professions

Retrieve the complete A-Z glossary of all apprenticeship career types offered on ausbildung.de. Each entry has a name, slug, and URL. Use the slug with get_profession_detail or get_profession_salary for drill-down. No input parameters — always returns the full catalog (300+ professions).

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ausbildung-de-api-333a497f/list_all_professions \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_listings

Full-text search over apprenticeship/training positions by keyword, location, and radius. Returns up to 20 listings per page; advance with `from` in increments of 20. Omitting all params returns the broadest result set. Each listing carries a slug for drill-down via get_listing_detail.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `from` | integer | No | Offset for pagination in increments of 20 |
| `location` | string | No | City name or postal code to search near |
| `query` | string | No | Search keyword — profession name or company name |
| `radius` | integer | No | Search radius in km around location |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ausbildung-de-api-333a497f/search_listings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"from":"<integer>","location":"<string>","query":"<string>","radius":"<integer>"}'
```