# Jobs Ams — 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 job listings from Austria's AMS alle jobs platform with advanced filtering options. View detailed job information, explore featured categories including green jobs and apprenticeships, and retrieve autocomplete suggestions for job titles. Access real-time job data filtered by location, employment type, working hours, education level, and more.

**Category:** Jobs | **Website:** [jobs.ams.at/](https://jobs.ams.at/) | **Docs:** [parse.bot/marketplace/396e89cf-72be-46e0-be71-8339666849ae/jobs-ams-at-api](https://parse.bot/marketplace/396e89cf-72be-46e0-be71-8339666849ae/jobs-ams-at-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/jobs-ams/`
**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 apprenticeship jobs

Convenience endpoint to get apprenticeship (Lehrstelle) positions.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `location` | string | No | Location filter |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/jobs-ams/get-apprenticeship-jobs \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"location":"<string>"}'
```

### Get featured job categories

Get featured job categories/curated searches shown on the homepage.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/jobs-ams/get-featured-job-categories \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get green jobs

Convenience endpoint to get only Green Jobs.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `location` | string | No | Location filter |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/jobs-ams/get-green-jobs \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"location":"<string>"}'
```

### Get job detail

Get full details for a specific job by its UUID.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `uuid` | string | Yes | Unique identifier of the job listing |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/jobs-ams/get-job-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"uuid":"<string>"}'
```

### Get suggestions

Get job title autocomplete suggestions based on a search prefix. Returns matching job titles from the AMS job database. Useful for building search interfaces with typeahead functionality.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `count` | integer | No | Maximum number of suggestions to return |
| `query` | string | Yes | Search prefix for job titles (e.g. 'Software', 'Koch', 'Lehrer') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/jobs-ams/get-suggestions \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"count":"<integer>","query":"<string>"}'
```

### Search jobs

Search for job listings with various filters.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `education` | string | No | Education level filter (e.g. 'P*' for Pflichtschule, 'U*' for University) |
| `employment_relationship` | string | No | Employment type (AA=Arbeiter/Angestellte, LS=Lehrstelle, SS=Saison, FS=Ferial, SB=Sonstige) |
| `green_job` | boolean | No | Filter for Green Jobs only |
| `job_offer_types` | string | No | Comma-separated list of job offer sources (AMS, SB_WKO, IJ, BA, BZ, TN) |
| `location` | string | No | Location (City, Postal Code, or State) |
| `page` | integer | No | Page number for pagination |
| `page_size` | integer | No | Number of results per page |
| `period` | string | No | Time period (ALL, 1, 2, 7, 30 days) |
| `query` | string | No | Search keyword (job title, skill, or company) |
| `radius` | integer | No | Search radius in km around location |
| `sort_field` | string | No | Sort field (_SCORE for relevance, DATE for date) |
| `working_time` | string | No | Working hours (VZ=Fulltime, TZ=Parttime) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/jobs-ams/search-jobs \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"education":"<string>","employment_relationship":"<string>","green_job":"<boolean>","job_offer_types":"<string>","location":"<string>","page":"<integer>","page_size":"<integer>","period":"<string>","query":"<string>","radius":"<integer>","sort_field":"<string>","working_time":"<string>"}'
```

## Next steps

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