# 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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-job-at-api-a7bbc56e/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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/parse-job-at-api-a7bbc56e/get_featured_jobs \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-job-at-api-a7bbc56e/get_job_categories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-job-at-api-a7bbc56e/get_job_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-job-at-api-a7bbc56e/get_keyword_suggestions \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-job-at-api-a7bbc56e/get_location_suggestions \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-job-at-api-a7bbc56e/get_related_job_titles \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-job-at-api-a7bbc56e/get_search_result_facets \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-job-at-api-a7bbc56e/search_jobs \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"location":"<string>","page":"<integer>","query":"<string>"}'
```