# Jobroom 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 explore job listings from Austria's public employment service, view detailed job information, and discover available positions with autocomplete suggestions. Register as a jobseeker abroad and access the official terms of use for the eJob-Room platform.

**Category:** Jobs | **Website:** [jobroom.ams.or.at/](https://jobroom.ams.or.at/) | **Docs:** [parse.bot/marketplace/db99510a-c947-492d-b0d5-0425001e85ad/jobroom-ams-or-at-api](https://parse.bot/marketplace/db99510a-c947-492d-b0d5-0425001e85ad/jobroom-ams-or-at-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-jobroom-ams-or-at-api-db99510a/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### autocomplete_jobs

Get job title suggestions for a search prefix. Returns a list of matching job title strings from the AMS occupation database, useful for building type-ahead search interfaces or discovering valid job title terms.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Text prefix to search for job titles (e.g. 'Software', 'Pflege', 'Buch'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-jobroom-ams-or-at-api-db99510a/autocomplete_jobs \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```

### get_job_detail

Retrieve full details of a job posting including company info, description, requirements, and working conditions. Accepts either an order_number (AMS Inseratnummer) for direct lookup, or the combination of pk, index, and x_string obtained from search_jobs results link_params. Returns structured metadata fields and the full job description in both HTML and plain text.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `index` | string | No | Index from search_jobs results link_params. Used with pk. |
| `order_number` | string | No | AMS Inseratnummer (order number), e.g. '17288849'. Required if pk is not provided. |
| `pk` | string | No | Composite primary key from search_jobs results link_params (e.g. '5545218_1_f6e950f1-f431-4240-acaa-85c5998'). Required if order_number is not provided. |
| `x_string` | string | No | Timestamp parameter from search_jobs results link_params (e.g. '2026-08-21T15:09:47'). Used with pk. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-jobroom-ams-or-at-api-db99510a/get_job_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"index":"<string>","order_number":"<string>","pk":"<string>","x_string":"<string>"}'
```

### get_terms_of_use

Retrieve the terms of use (Nutzungsbedingungen) for the eJob-Room portal. Returns the full HTML content of the AMS terms page covering rules for employers and job seekers, data protection, and usage policies.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-jobroom-ams-or-at-api-db99510a/get_terms_of_use \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### register_jobseeker_abroad

Get information and initial requirements for registering as a job seeker living outside of Austria. Returns the registration page URL and a preview of the terms content shown on the page.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-jobroom-ams-or-at-api-db99510a/register_jobseeker_abroad \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_jobs

Full-text search over AMS eJob-Room job postings. Returns up to 10 results from the first results page. The query matches job titles, company names, locations, and descriptions. Results include metadata (location, employment type, working hours, posted date) and a text snippet. Each result carries link_params needed to fetch its full details via get_job_detail.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword (e.g., job title, location, company name). Supports German and English terms. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-jobroom-ams-or-at-api-db99510a/search_jobs \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```