SS.lv Search API: Lists ads of one category and location, 30 per page, for sale or for rent. Pick a category and a region, then add a district for Riga, filter by price, rooms, area, floor and series, sort, and page through the results. Each item has price, price per square metre, rooms, area, floor, series, land area, location and thumbnail. Item url works in the listing 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.
Filters are never ignored. Price, price per square metre, rooms, area, floor, series and sort run on the one source page that was fetched. Items that break a requested filter are not returned. pagination.source_page names the page and pagination.filtered_from counts its rows, so a strict filter can return few or no items. Riga without a district lists the whole city (all). Page N is always page N of the site. When the site shows no price per square metre, price_per_sqm is the sale price divided by the area for flats, offices and premises, otherwise it stays null.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
This endpoint has no required query parameters.
19 optional filters available.
string
Optional
flats (default), homes, farms, plots, offices, wood, premises or other.
example
string
Optional
Required for premises and other. Slug from the autocomplete route with type sub_category, such as garages or parkings.
example
string
Optional
Region slug from the autocomplete route, such as riga, jurmala, riga-region or aizkraukle-and-reg. Required for every category except other.
US
string
Optional
Area slug for riga and riga-region from the autocomplete route. Default all: the whole city or region.
example
string
Optional
sale (default) or rent.
example
string
Optional
Only ads posted today, within 2 days (2d) or within 5 days (5d). The site applies this filter.
example
number
Optional
Minimum price in EUR. Applied to the fetched source page.
10
number
Optional
Maximum price in EUR. Applied to the fetched source page.
10
number
Optional
Minimum price per square metre. Applied to the fetched source page.
10
number
Optional
Maximum price per square metre. Applied to the fetched source page.
10
integer
Optional
Minimum rooms. SS.lv lists rooms only, not bedrooms.
10
integer
Optional
Maximum rooms.
10
number
Optional
Minimum area in square metres. Hectares are converted.
10
number
Optional
Maximum area in square metres.
10
integer
Optional
Minimum floor.
10
integer
Optional
Maximum floor.
10
string
Optional
Building series exactly as shown on the site, such as Staļina or Hrušč.
example
string
Optional
price_asc, price_desc, area_asc, area_desc, price_per_sqm_asc or price_per_sqm_desc. Sorts the fetched source page only.
relevance
integer
Optional
One-based page number, 1 to 1000 (default 1). Page N fetches page N of the site list.
1
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"data": {
"items": [
{
"id": "58219672",
"url": "https://www.ss.lv/msg/lv/real-estate/flats/jurmala/kauguri/aagfc.html",
"area": 30,
"code": "aagfc",
"size": null,
"floor": 5,
"price": 48800,
"rooms": 1,
"title": "P\u0101rdodu dz\u012bvokli p\u0113c kapit\u0101la remonta, ir nomain\u012bts viss iz\u0146",
"series": "Hru\u0161\u010d.",
"company": null,
"currency": "EUR",
"location": {
"region": "jurmala",
"address": "Kauguri Talsu \u0161oseja31 8",
"district": null,
"region_name": "J\u016brmala",
"district_name": null
},
"area_unit": "m2",
"land_area": null,
"thumbnail": "https://i.ss.lv/gallery/8/1561/390147/78029282.th2.jpg",
"price_text": "48,800 \u20ac",
"floors_total": 5,
"listing_type": "sale",
"price_period": null,
"category_path": null,
"price_per_sqm": 1627
},
{
"id": "58219258",
"url": "https://www.ss.lv/msg/lv/real-estate/flats/jurmala/lielupe/bxnebx.html",
"area": 48,
"code": "bxnebx",
"size": null,
"floor": 2,
"price": 52800,
"rooms": 2,
"title": "Tiek pied\u0101v\u0101ts divistabu neremont\u0113ts dz\u012bvoklis \u0137ie\u0123e\u013cu m\u0101j\u0101",
"series": "Specpr.",
"company": null,
"currency": "EUR",
"location": {
"region": "jurmala",
"address": "Lielupe La\u0161u 7 4",
"district": null,
"region_name": "J\u016brmala",
"district_name": null
},
"area_unit": "m2",
"land_area": null,
"thumbnail": "https://i.ss.lv/gallery/8/1561/390136/78027193.th2.jpg",
"price_text": "52,800 \u20ac",
"floors_total": 2,
"listing_type": "sale",
"price_period": null,
"category_path": null,
"price_per_sqm": 1100
}
],
"notices": [
"Filters and sort apply to the one source page that was fetched. See source_page and filtered_from."
],
"pagination": {
"page": 1,
"has_more": true,
"per_page": 3,
"source_page": 1,
"total_pages": 5,
"filtered_from": 5
},
"applied_filters": {
"sort": "price_asc",
"max_price": 60000
}
},
"meta": {
"billable": true,
"endpoint_family": "search"
},
"success": true
}Errors
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
A parameter is missing, unknown or not supported, or the location has no list. This response is not billable.
{
"meta": {
"billable": false,
"retryable": false,
"endpoint_family": "search"
},
"error": {
"code": "VALIDATION_ERROR",
"message": "region is required. Use one of: riga, jurmala, riga-region."
},
"success": false
}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.
{
"meta": {
"billable": false,
"retryable": true,
"endpoint_family": "search"
},
"error": {
"code": "UPSTREAM_UNAVAILABLE",
"message": "SS.lv could not be reached. Please retry shortly."
},
"success": false
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.