# SS.lv Latest API Documentation

<p><strong>SS.lv Latest API</strong>: Returns the 20 newest ads of one category and location from the site feed, newest first, with the posting time. It takes the same location parameters as search and no filters. The site is in Latvian: text such as titles, descriptions and series stays Latvian or Russian, field names are English. Bedrooms and bathrooms do not exist on SS.lv, only rooms.</p>

- **Documentation:** [https://scrappa.co/docs/ss-lv-api/ss_lv_latest](https://scrappa.co/docs/ss-lv-api/ss_lv_latest)
- **API group:** SS.lv API
- **Endpoint:** `GET https://scrappa.co/api/ss-lv/latest`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `category` | string | No | flats (default), homes, farms, plots, offices, wood, premises or other. |
| `sub_category` | string | No | Required for premises and other. Slug from the autocomplete route with type sub_category, such as garages or parkings. |
| `region` | string | No | Region slug from the autocomplete route, such as riga, jurmala, riga-region or aizkraukle-and-reg. Required for every category except other. |
| `district` | string | No | Area slug for riga and riga-region from the autocomplete route. Default all: the whole city or region. |
| `listing_type` | string | No | sale (default) or rent. |

## Example response

```json
{
    "data": {
        "items": [
            {
                "id": null,
                "url": "https://www.ss.lv/msg/lv/real-estate/flats/riga/centre/cccdh.html",
                "area": 74,
                "code": "cccdh",
                "size": null,
                "floor": 2,
                "price": 138000,
                "rooms": 3,
                "title": "\u041f\u0440\u043e\u0434\u0430\u0451\u0442\u0441\u044f \u0442\u0440\u0451\u0445\u043a\u043e\u043c\u043d\u0430\u0442\u043d\u0430\u044f \u043a\u0432\u0430\u0440\u0442\u0438\u0440\u0430 \u0432 \u0422\u0438\u0445\u043e\u043c \u0446\u0435\u043d\u0442\u0440\u0435 \u0420\u0438\u0433\u0438, \u043d\u0430 2-\u043c \u044d\u0442\u0430\u0436\u0435 \u043f\u044f\u0442\u0438\u044d\u0442\u0430\u0436\u043d\u043e\u0433\u043e \u043a\u0438\u0440\u043f\u0438\u0447\u043d\u043e\u0433\u043e \u0434\u043e\u043c\u0430 \u0441\u0442\u0430\u043b\u0438\u043d\u0441\u043a\u043e\u0433\u043e \u043f\u0435\u0440\u0438\u043e\u0434\u0430 \u043f\u043e \u0430\u0434\u0440\u0435\u0441\u0443 ...",
                "series": "Sta\u013cina",
                "company": null,
                "currency": "EUR",
                "location": {
                    "region": "riga",
                    "address": "Eksporta 8a",
                    "district": "centre",
                    "region_name": "R\u012bga",
                    "district_name": "Centrs"
                },
                "area_unit": "m2",
                "land_area": null,
                "posted_at": "2026-10-25T20:50:22+03:00",
                "thumbnail": "https://i.ss.lv/gallery/8/1561/390152/78030384.t.jpg",
                "price_text": "138,000 \u20ac",
                "floors_total": 5,
                "listing_type": "sale",
                "price_period": null,
                "category_path": null,
                "price_per_sqm": 1865
            },
            {
                "id": null,
                "url": "https://www.ss.lv/msg/lv/real-estate/flats/riga/centre/dfmeh.html",
                "area": 73,
                "code": "dfmeh",
                "size": null,
                "floor": 3,
                "price": 139000,
                "rooms": 3,
                "title": "\u041f\u0440\u043e\u0434\u0430\u0451\u0442\u0441\u044f \u043f\u0440\u043e\u0441\u0442\u043e\u0440\u043d\u0430\u044f, \u0441\u0432\u0435\u0442\u043b\u0430\u044f 3-\u043a\u043e\u043c\u043d\u0430\u0442\u043d\u0430\u044f \u043a\u0432\u0430\u0440\u0442\u0438\u0440\u0430 \u0432 \u0422\u0438\u0445\u043e\u043c \u0446\u0435\u043d\u0442\u0440\u0435 \u0420\u0438\u0433\u0438. \u0423\u043b. \u042d\u043a\u0441\u043f\u043e\u0440\u0442\u0430, 8\u0410 73 \u043c\u00b2 3/5 \u044d\u0442\u0430\u0436 - \u0422\u0440\u0438 \u0438\u0437\u043e\u043b\u0438\u0440\u043e\u0432 ...",
                "series": "Sta\u013cina",
                "company": null,
                "currency": "EUR",
                "location": {
                    "region": "riga",
                    "address": "Eksporta 8A",
                    "district": "centre",
                    "region_name": "R\u012bga",
                    "district_name": "Centrs"
                },
                "area_unit": "m2",
                "land_area": null,
                "posted_at": "2026-10-25T19:33:59+03:00",
                "thumbnail": "https://i.ss.lv/gallery/8/1561/390144/78028743.t.jpg",
                "price_text": "139,000 \u20ac",
                "floors_total": 5,
                "listing_type": "sale",
                "price_period": null,
                "category_path": null,
                "price_per_sqm": 1904
            }
        ],
        "pagination": {
            "page": 1,
            "has_more": false,
            "per_page": 3
        }
    },
    "meta": {
        "billable": true,
        "endpoint_family": "latest"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A parameter is missing, unknown or not supported, or the location has no list. This response is not billable. |
| 503 | Upstream Unavailable | SS.lv could not be reached or returned a page that does not match the request. This response is not billable and is retryable. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)