# SS.com — 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.

> Browse Latvia's largest classifieds marketplace by category or search for specific listings, view detailed ad information including pricing and descriptions, and retrieve seller contact numbers. Access everything from real estate and vehicles to electronics and services across SS.com's comprehensive catalog.

**Category:** Jobs | **Website:** [m.ss.com/](https://m.ss.com/) | **Docs:** [parse.bot/marketplace/3ccc0b27-943a-4345-b621-a0bab9849937/m-ss-com-api](https://parse.bot/marketplace/3ccc0b27-943a-4345-b621-a0bab9849937/m-ss-com-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/ss-com/`
**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 job categories

Retrieve all profession categories under the Vakances (job vacancies) section. Each category has a name, listing count, URL, and slug usable in list_job_listings. Returns the full set in one page.

**Estimated cost:** Metered

_No parameters required._

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

### Get job listing detail

Retrieve full details for a single job listing by its URL. Returns structured fields including title, description, profession, company info, work schedule, location, and posting date. Available fields vary by listing.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full URL of the job listing (e.g. 'https://www.ss.com/msg/lv/work/are-required/programmer/jpkgc.html'). |

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

### Get main categories

Retrieve all top-level site categories (Work, Transport, Real Estate, etc.). Each category includes a slug usable for navigation into subcategory endpoints. Returns the full set in one page; no pagination.

**Estimated cost:** Metered

_No parameters required._

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

### Get work section categories

Retrieve subcategories within the Work and Business section, including job vacancies, job seekers, courses, and services. Each subcategory includes a listing count and slug. Returns the full set in one page.

**Estimated cost:** Metered

_No parameters required._

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

### List all job subcategories

Alias for get_job_categories. Returns all job profession categories under the Vakances section.

**Estimated cost:** Metered

_No parameters required._

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

### List job listings

List job vacancy listings for a given profession category. Returns paginated results including title, company, location, schedule, and salary. Use category slugs from get_job_categories.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | Yes | Category slug from get_job_categories results (e.g. 'programmer', 'administrator', 'driver'). |
| `page` | integer | No | Page number for pagination (1-based). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/ss-com/list-job-listings \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","page":"<integer>"}'
```

### List seeking work listings

List people seeking work, optionally filtered by profession category. Returns listings with title, URL, location/education, and preferred schedule. Use category slugs from get_job_categories.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Category slug to filter by (e.g. 'programmer', 'administrator'). Omitting returns all seeking-work listings. |
| `page` | integer | No | Page number for pagination (1-based). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/ss-com/list-seeking-work-listings \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","page":"<integer>"}'
```

### Search jobs

Search for listings across the entire site by keyword. Returns matching listings with title, URL, and category breadcrumb. Results are not paginated; returns the first page of matches.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword (e.g. 'programmer', 'driver', 'accountant'). |

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

## 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.