# Job.at — 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 jobs on Austria's job.at platform, view detailed job listings with salary info and company details, and use autocomplete features to refine your search by location and keywords. Discover featured positions, explore job categories, and find related job titles to expand your career opportunities.

**Category:** Jobs | **Website:** [job.at/](https://job.at/) | **Docs:** [parse.bot/marketplace/a7bbc56e-96cf-4ffb-807f-3e28b8e3cd5e/job-at-api](https://parse.bot/marketplace/a7bbc56e-96cf-4ffb-807f-3e28b8e3cd5e/job-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/job-at/`
**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 featured jobs

Retrieve featured/promoted job listings from the job.at homepage. Returns a list of currently promoted positions. No parameters required. Results change frequently as promotions rotate.

**Estimated cost:** Metered

_No parameters required._

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

### Get job categories

Retrieve job categories and their subcategories from the job.at homepage. Each category contains a list of popular subcategory job titles with links. No parameters required.

**Estimated cost:** Metered

_No parameters required._

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

### Get job detail

Retrieve a job listing summary by its numeric ID. Returns title, company, location, date, and description snippet. The ID comes from search_jobs results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `id` | string | Yes | Job listing ID (numeric string from search results, e.g. '20992363') |

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

### Get keyword suggestions

Get autocomplete suggestions for the job title/keyword input field. Returns job title suggestions matching the partial input text, useful for discovering valid search terms.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Partial keyword or job title text to autocomplete (e.g. 'Python', 'Sales') |

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

### Get location suggestions

Get autocomplete suggestions for the location input field. Returns location names matching the partial input text, useful for building search queries with valid locations.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Partial location text to autocomplete (e.g. 'Wien', 'Graz') |

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

### Get related job titles

Retrieve related job title suggestions for a given search query. Useful for discovering alternative job titles and expanding a job search. Returns titles with URLs to their respective search results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `location` | string | No | Location to scope related title suggestions |
| `query` | string | Yes | Job title or keyword to find related titles for (e.g. 'developer', 'marketing') |

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

### Get search result facets

Retrieve available filter facets and their counts for a given job search. Returns an object whose keys are facet category names (e.g. Anstellungsart, Branche, Arbeitszeit) mapped to arrays of label/count pairs. Useful for understanding the composition of search results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `location` | string | No | Location filter to scope facets |
| `query` | string | No | Search keyword to scope facets |

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

### Search jobs

Full-text search over job listings on job.at by keyword and/or location. Returns paginated results with job summaries. Pagination via integer page parameter. Each result includes an ID usable with get_job_detail. total_hits may be null if the site does not display it for the given query.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `location` | string | No | Location to search in (e.g. 'Wien', 'Graz') |
| `page` | integer | No | Page number for pagination |
| `query` | string | No | Job title or keyword to search for (e.g. 'developer', 'Python') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/job-at/search-jobs \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"location":"<string>","page":"<integer>","query":"<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.