# SS.lv Agencies API Documentation

<p><strong>SS.lv Agencies API</strong>: Lists the broker service ads of SS.lv, 30 per page. Each item has the ad title, the city, the company label and the url to pass to the agency route. 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_agencies](https://scrappa.co/docs/ss-lv-api/ss_lv_agencies)
- **API group:** SS.lv API
- **Endpoint:** `GET https://scrappa.co/api/ss-lv/agencies`

## 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 |
| --- | --- | --- | --- |
| `page` | integer | No | One-based page number, 1 to 1000 (default 1). |

## Example response

```json
{
    "data": {
        "items": [
            {
                "id": "57682475",
                "url": "https://www.ss.lv/msg/lv/real-estate/brokers-services/bggllh.html",
                "area": null,
                "code": "bggllh",
                "size": null,
                "floor": null,
                "price": null,
                "rooms": null,
                "title": "P\u0101rdodiet vai Iznom\u0101jiet savu \u012apa\u0161umu dro\u0161i un izdev\u012bgi. Mekl\u0113jat profesion\u0101lu nekustam\u0101",
                "series": null,
                "company": "Agency",
                "currency": null,
                "location": {
                    "region": null,
                    "address": null,
                    "district": null,
                    "region_name": "R\u012bga",
                    "district_name": null
                },
                "area_unit": "m2",
                "land_area": null,
                "thumbnail": "https://i.ss.lv/gallery/8/1500/374952/74990326.th2.jpg",
                "price_text": "-",
                "floors_total": null,
                "listing_type": null,
                "price_period": null,
                "category_path": null,
                "price_per_sqm": null
            },
            {
                "id": "57407011",
                "url": "https://www.ss.lv/msg/lv/real-estate/brokers-services/dnifj.html",
                "area": null,
                "code": "dnifj",
                "size": null,
                "floor": null,
                "price": null,
                "rooms": null,
                "title": "P\u0101rdosim j\u016bsu \u012bpa\u0161umu izdev\u012bgi. Samaksa tikai p\u0113c naudas sa\u0146em\u0161anas. Alento Real Estate",
                "series": null,
                "company": "Alento real estate",
                "currency": null,
                "location": {
                    "region": null,
                    "address": null,
                    "district": null,
                    "region_name": "R\u012bga",
                    "district_name": null
                },
                "area_unit": "m2",
                "land_area": null,
                "thumbnail": "https://i.ss.lv/gallery/8/1549/387063/77412484.th2.jpg",
                "price_text": "-",
                "floors_total": null,
                "listing_type": null,
                "price_period": null,
                "category_path": null,
                "price_per_sqm": null
            }
        ],
        "notices": [],
        "pagination": {
            "page": 1,
            "has_more": true,
            "per_page": 5,
            "source_page": 1,
            "total_pages": 14,
            "filtered_from": 5
        },
        "applied_filters": []
    },
    "meta": {
        "billable": true,
        "endpoint_family": "agencies"
    },
    "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)