SS.lv Text Search API: Finds real estate ads of every category by free text. Rows have the price, the location, the category path and the thumbnail. Results follow the full-text order of the site and paging is supported with the page parameter. A word can match in the description of an ad, so rows of other places or categories can appear. A query with no hit returns an empty list. This route has no filters or sort and mixes all categories. 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.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
1 required parameter needed before sending a request.
1 optional filter available.
string
Required
Search text, 2 to 100 characters.
coffee shops
integer
Optional
Page of the result list, starting at 1. A page past the last page returns an empty 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": "58220324",
"url": "https://www.ss.lv/msg/lv/real-estate/flats/riga/centre/beieen.html",
"area": null,
"code": "beieen",
"size": null,
"floor": null,
"price": 650,
"rooms": null,
"title": "Dz\u012bvoklis atrodas pagalma m\u0101jas 2. st\u0101v\u0101 klus\u0101, sakopt\u0101 vid\u0113. Plat\u012bba 43, 4 m\u00b2. P\u0113c m\u0101jas re",
"series": null,
"company": null,
"currency": "EUR",
"location": {
"region": "riga",
"address": null,
"district": "centre",
"region_name": "R\u012bga",
"district_name": "Centrs"
},
"area_unit": "m2",
"land_area": null,
"thumbnail": "https://i.ss.lv/gallery/8/1561/390163/78032483.th2.jpg",
"price_text": "650 \u20ac/m\u0113n.",
"floors_total": null,
"listing_type": "rent",
"price_period": "month",
"category_path": "Dz\u012bvok\u013ci : R\u012bga : Centrs",
"price_per_sqm": null
},
{
"id": "58120614",
"url": "https://www.ss.lv/msg/lv/real-estate/plots-and-lands/riga-region/adazu-nov/divezeri/fnbhl.html",
"area": null,
"code": "fnbhl",
"size": null,
"floor": null,
"price": 68000,
"rooms": null,
"title": "\u012apa\u0161nieks p\u0101rdod zemes gabalu \u0100da\u017eu novad\u0101 Divezeru ciem\u0101, Zaraines iela 13, D\u016b\u0146ezera D gal\u0101.",
"series": null,
"company": null,
"currency": "EUR",
"location": {
"region": "riga-region",
"address": null,
"district": "adazu-nov",
"region_name": "R\u012bgas rajons",
"district_name": "\u0100da\u017eu nov."
},
"area_unit": "m2",
"land_area": null,
"thumbnail": "https://i.ss.lv/gallery/8/1550/387328/77465466.th2.jpg",
"price_text": "68,000 \u20ac",
"floors_total": null,
"listing_type": "sale",
"price_period": null,
"category_path": "Zeme : R\u012bgas rajons : \u0100da\u017eu nov. : Divezeri",
"price_per_sqm": null
}
],
"query": "Elizabetes",
"notices": [],
"pagination": {
"page": 1,
"has_more": true,
"per_page": 5,
"source_page": 1,
"total_pages": 50,
"filtered_from": 5
},
"applied_filters": []
},
"meta": {
"billable": true,
"endpoint_family": "text_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": "text_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": "text_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.