# SS.lv — 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 real estate and spare parts listings from ss.lv, search by keywords, and view detailed information about specific listings. Get instant access to property and automotive parts data to find what you're looking for on one of Latvia's largest marketplaces.

**Category:** Marketplaces | **Website:** [ss.lv/](https://ss.lv/) | **Docs:** [parse.bot/marketplace/b73662be-6f8a-472e-bc5a-c458b10d627b/ss-lv-api](https://parse.bot/marketplace/b73662be-6f8a-472e-bc5a-c458b10d627b/ss-lv-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/ss-lv/`
**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 listing detail

Fetch full details of a single listing by its URL. Returns structured information including title, price, location, description text, and all listing attributes as key-value pairs. Works for any ss.lv listing URL from any category.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full URL of the listing on ss.lv (e.g., 'https://www.ss.lv/msg/lv/real-estate/flats/riga/centre/hxinf.html') |

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

### Get real estate listings

Fetch real estate listings from a specific leaf-level category path on ss.lv. The category must be a complete path down to a district or sub-category level (e.g., 'real-estate/flats/riga/centre'). Returns up to 30 listings per page with title, URL, price, and column attributes. Non-leaf paths may return empty results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Category path without /lv/ prefix. Must be a leaf-level path including district (e.g., 'real-estate/flats/riga/centre', 'real-estate/flats/riga/purvciems', 'real-estate/houses-summer-residences/riga/centre'). |

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

### Search spare parts

Search for spare parts and transport-related listings by keyword. Returns results from the transport/spare-parts category with optional price and region filtering. Client-side price filtering is applied after retrieval when price_max is specified.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `price_max` | integer | No | Maximum price filter in EUR. Listings with prices above this value are excluded from results. |
| `query` | string | Yes | Search keyword (e.g., 'brake', 'bmw', 'audi') |
| `region` | string | No | Region code for filtering. '0' means all regions. |

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