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

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

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-m-ss-com-api-3ccc0b27/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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.paywithlocus.com/api/wrapped/parse-m-ss-com-api-3ccc0b27/get_job_categories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-m-ss-com-api-3ccc0b27/get_job_listing_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-m-ss-com-api-3ccc0b27/get_main_categories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-m-ss-com-api-3ccc0b27/get_work_section_categories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-m-ss-com-api-3ccc0b27/list_all_job_subcategories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-m-ss-com-api-3ccc0b27/list_job_listings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-m-ss-com-api-3ccc0b27/list_seeking_work_listings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-m-ss-com-api-3ccc0b27/search_jobs \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```