# SS.lv Listing API Documentation

<p><strong>SS.lv Listing API</strong>: Returns one listing: price with period and price per square metre, rooms, area, floor, series, house type, facilities, land area, cadastral number, purpose, address with latitude and longitude, up to 16 photos, the description, the posting date as ISO 8601 and the agency block. Every Latvian label also stays in <code>attributes</code>. 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_listing](https://scrappa.co/docs/ss-lv-api/ss_lv_listing)
- **API group:** SS.lv API
- **Endpoint:** `GET https://scrappa.co/api/ss-lv/listing`

## 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 |
| --- | --- | --- | --- |
| `url` | string | Yes | The url of a search item (items.url), as a path or the full ss.lv URL. |

## Example response

```json
{
    "data": {
        "id": "58219929",
        "url": "https://www.ss.lv/msg/lv/real-estate/flats/riga/centre/cccdh.html",
        "area": 73.6,
        "floor": 2,
        "price": 138000,
        "rooms": 3,
        "title": "Dz\u012bvok\u013ci - R\u012bga - Centrs, Cena 138 000 \u20ac (1 875 \u20ac/m\u00b2). \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 \u043e\u0431\u0441\u043b\u0443\u0436\u0438\u0432\u0430\u0435\u0442 \u0434\u0430\u043d\u043d\u044b\u043c \u043f\u043b\u043e\u0449\u0430\u0434\u044c",
        "agency": null,
        "photos": [
            {
                "url": "https://i.ss.lv/gallery/8/1561/390152/flats-riga-centre-78030384.800.jpg",
                "thumbnail": "https://i.ss.lv/gallery/8/1561/390152/flats-riga-centre-78030384.t.jpg"
            },
            {
                "url": "https://i.ss.lv/gallery/8/1561/390152/flats-riga-centre-78030385.800.jpg",
                "thumbnail": "https://i.ss.lv/gallery/8/1561/390152/flats-riga-centre-78030385.t.jpg"
            }
        ],
        "series": "Sta\u013cina",
        "purpose": null,
        "currency": "EUR",
        "location": {
            "city": "R\u012bga",
            "place": null,
            "street": "Eksporta 8a",
            "village": null,
            "district": "centrs",
            "latitude": 56.9666619,
            "longitude": 24.0983054
        },
        "area_unit": "m2",
        "land_area": null,
        "posted_at": "2026-10-25T20:50:00+02:00",
        "attributes": {
            "Cena": "138 000 \u20ac (1 875 \u20ac/m\u00b2)",
            "Iela": "Eksporta 8a",
            "Rajons": "centrs",
            "St\u0101vs": "2/5",
            "Istabas": "3",
            "S\u0113rija": "Sta\u013cina",
            "Pils\u0113ta": "R\u012bga",
            "Plat\u012bba": "73.60 m\u00b2",
            "\u0112rt\u012bbas": "Parko\u0161anas vieta",
            "M\u0101jas tips": "\u0136ie\u0123e\u013cu"
        },
        "facilities": [
            "Parko\u0161anas vieta"
        ],
        "house_type": "\u0136ie\u0123e\u013cu",
        "price_text": "138 000 \u20ac (1 875 \u20ac/m\u00b2)",
        "description": "\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 Eksporta iela 8a.\n\n\n\n\u041e\u0431\u0449\u0430\u044f \u043f\u043b\u043e\u0449\u0430\u0434\u044c...",
        "floors_total": 5,
        "listing_type": "sale",
        "price_period": null,
        "price_per_sqm": 1875,
        "cadastral_number": null
    },
    "meta": {
        "billable": true,
        "endpoint_family": "listing"
    },
    "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. |
| 404 | Not Found | The ad does not exist any more or has no agency block. 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)