# Ausbildung — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/ausbildung/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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.beta.paywithlocus.com/api/wrapped/credits/ausbildung/get-listing-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/ausbildung/get-profession-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/ausbildung/get-profession-salary \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/ausbildung/list-all-professions \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/ausbildung/search-listings \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"from":"<integer>","location":"<string>","query":"<string>","radius":"<integer>"}'
```

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.