--- title: "SS.lv API: JSON data, 7 endpoints, 1 credit per call" description: "SS.lv API for Latvian property ads: flats, houses, land and offices for sale or rent, latest ads and agencies as JSON. 1 credit per successful call." url: https://perceptlayer.com/apis/ss-lv --- [APIs](https://perceptlayer.com/apis) / [Real estate](https://perceptlayer.com/verticals/real-estate) / SS.lv 1 credit per call 7 endpoints 17 datapoints # SS.lv API SS.lv API for Latvian property ads: flats, houses, land and offices for sale or rent, latest ads and agencies as JSON. 1 credit per successful call. [Get a free API key](https://perceptlayer.com/signup) Run it below SS.lv GET /v1/ss-lv/search?category=flats®ion=jurmala&listing\_type=sale&max\_price=60000&sort=price\_asc ``` { "success": true, "data": { "items": [ { "id": "58166421", "code": "becpe", "url": "https://www.ss.lv/msg/lv/real-estate/flats/jurmala/sloka/becpe.html", "title": "Pārdošanā ekonomisks 2 istabu dzīvoklis ar malkas apkuri. At", "listing_type": "sale", "location": { "region": "jurmala", "region_name": "Jūrmala", "address": "Sloka Raiņa 18/20" }, "rooms": 2, "area": 38, "area_unit": "m2", "floor": 2, "floors_total": 2, "series": "P. kara", "price": 15000, "price_per_sqm": 395, "currency": "EUR", "price_text": "15,000 €", "thumbnail": "https://i.ss.lv/gallery/8/1568/391927/78385219.th2.jpg" }, { "id": "58280434", "code": "cnbjb", "url": "https://www.ss.lv/msg/lv/real-estate/flats/jurmala/kauguri/cnbjb.html", "title": "Īpašnieks pārdod vienistabas dzīvokli ķieģeļu mājā ar visām", "listing_type": "sale", "location": { "region": "jurmala", "region_name": "Jūrmala", "address": "Kauguri Tirzas 44" }, "rooms": 1, "area": 18, "area_unit": "m2", "floor": 1, "floors_total": 3, "series": "Hrušč.", "price": 26000, "price_per_sqm": 1444, "currency": "EUR", "price_text": "26,000 €", "thumbnail": "https://i.ss.lv/gallery/8/1551/387503/77500540.th2.jpg" }, { "id": "58125611", "code": "aenlg", "url": "https://www.ss.lv/msg/lv/real-estate/flats/jurmala/kauguri/aenlg.html", "title": "Pārdod 1-istabas dzīvokli Kauguros, lieliskā vietā dzīvošana", "listing_type": "sale", "location": { "region": "jurmala", "region_name": "Jūrmala", "address": "Kauguri Talsu šoseja 31 K- 16" }, "rooms": 1, "area": 31, "area_unit": "m2", "floor": 5, "floors_total": 5, "series": "Hrušč.", "price": 32000, "price_per_sqm": 1032, "currency": "EUR", "price_text": "32,000 €", "thumbnail": "https://i.ss.lv/gallery/8/1550/387457/77491215.th2.jpg" } ], "pagination": { "page": 1, "source_page": 1, "filtered_from": 60, "per_page": 11, "has_more": true, "total_pages": 6 }, "applied_filters": { "max_price": "60000", "sort": "price_asc" }, "notices": [ "Filters and sort apply to the one source page that was fetched. See source_page and filtered_from." ] }, "meta": { "endpoint_family": "search", "request_id": "req_11a39e889a8c4a6fa632b3a78ea91240", "credits_charged": 1, "credits_remaining": 1813 } } ``` 200 OK JSON X-Credits-Used: 1 Recorded from our API and shortened. Sample data ## What one call returns A recorded run of `search`: the fields and shapes you will get, shortened to 3 items. | # | id string | code string | url url | title string | listing\_type string | location object | rooms integer | area integer | area\_unit string | floor integer | floors\_total integer | series string | price integer | price\_per\_sqm integer | currency string | price\_text string | thumbnail url | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 1 | 58166421 | becpe | https://www.ss.lv/msg/lv/real-estate/flats/jurmala/sloka/becpe.html | Pārdošanā ekonomisks 2 istabu dzīvoklis ar malkas apkuri. At | sale | {3 fields} | 2 | 38 | m2 | 2 | 2 | P. kara | 15000 | 395 | EUR | 15,000 € | https://i.ss.lv/gallery/8/1568/391927/78385219.th2.jpg | | 2 | 58280434 | cnbjb | https://www.ss.lv/msg/lv/real-estate/flats/jurmala/kauguri/cnbjb.html | Īpašnieks pārdod vienistabas dzīvokli ķieģeļu mājā ar visām | sale | {3 fields} | 1 | 18 | m2 | 1 | 3 | Hrušč. | 26000 | 1444 | EUR | 26,000 € | https://i.ss.lv/gallery/8/1551/387503/77500540.th2.jpg | | 3 | 58125611 | aenlg | https://www.ss.lv/msg/lv/real-estate/flats/jurmala/kauguri/aenlg.html | Pārdod 1-istabas dzīvokli Kauguros, lieliskā vietā dzīvošana | sale | {3 fields} | 1 | 31 | m2 | 5 | 5 | Hrušč. | 32000 | 1032 | EUR | 32,000 € | https://i.ss.lv/gallery/8/1550/387457/77491215.th2.jpg | Recorded from our API · 3 items shown · 17 datapoints per item GET /v1/ss-lv/search?category=flats®ion=jurmala&listing\_type=sale&max\_price=60000&sort=price\_asc 17 datapoints ### Identity - id string - title string - listing\_type string ### Contact - url url ### Location - location object - area integer - area\_unit string ### Price - price integer - price\_per\_sqm integer - currency string - price\_text string ### Other - code string - rooms integer - floor integer - floors\_total integer - series string - thumbnail url Playground ## Run this API cURL shell ``` curl "https://api.perceptlayer.com/v1/ss-lv/search?category=flats®ion=jurmala&listing_type=sale&max_price=60000&sort=price_asc" \ -H "X-API-Key: $API_KEY" ``` SS.lv · 7 endpoints ## Endpoints Every endpoint takes the same key. Open one for its parameters and an example request. | Endpoint | Required parameters | Cost | | --- | --- | --- | | [GET `/v1/ss-lv/agencies`](https://perceptlayer.com/apis/ss-lv/agencies) | none +1 optional | 1 credit | | [GET `/v1/ss-lv/agency`](https://perceptlayer.com/apis/ss-lv/agency) | `url` | 1 credit | | [GET `/v1/ss-lv/autocomplete`](https://perceptlayer.com/apis/ss-lv/autocomplete) | `query` +2 optional | 1 credit | | [GET `/v1/ss-lv/latest`](https://perceptlayer.com/apis/ss-lv/latest) | none +5 optional | 1 credit | | [GET `/v1/ss-lv/listing`](https://perceptlayer.com/apis/ss-lv/listing) | `url` | 1 credit | | [GET `/v1/ss-lv/search`](https://perceptlayer.com/apis/ss-lv/search) | none +19 optional | 1 credit | | [GET `/v1/ss-lv/text-search`](https://perceptlayer.com/apis/ss-lv/text-search) | `query` +1 optional | 1 credit | Overview ## About the SS.lv API ## What you can get The SS.lv API returns SS.lv real estate classifieds as JSON through 7 endpoints. - **Search:** `search` takes a `category` (flats, homes, farms, plots, offices, wood, premises or other), `sub_category`, `region` (riga, jurmala, riga-region and the other regions), `district` (Riga districts such as centre, plus nearby towns), `listing_type` (sale or rent), `posted` (today, 2d or 5d), `min_price`, `max_price`, `min_price_per_sqm`, `max_price_per_sqm`, `min_rooms`, `max_rooms`, `min_area`, `max_area`, `min_floor`, `max_floor`, `series`, `sort` (price\_asc, price\_desc, area\_asc, area\_desc, price\_per\_sqm\_asc or price\_per\_sqm\_desc) and `page`. - **Latest and text search:** `latest` takes `category`, `sub_category`, `region`, `district` and `listing_type`; `text-search` takes a `query`, with `page`. - **Listings:** `listing` takes an ad `url`. - **Agencies:** `agencies` takes a `page`; `agency` takes a `url`. - **Autocomplete:** `autocomplete` takes a `query`, with `type` (region, district or sub\_category) and `limit`. The recorded `search` for flats for sale in Jūrmala up to €60,000, sorted by `price_asc`, returns `items`, each with `id`, `code`, `url`, `title`, `listing_type`, `location`, `rooms`, `area`, `area_unit`, `floor`, `floors_total`, `series`, `price`, `price_per_sqm`, `currency`, `price_text` and `thumbnail`. It also returns `pagination` with `source_page`, `filtered_from`, `per_page`, `has_more` and `total_pages`, the `applied_filters` and `notices`. ## How a call works Search a region: `GET /v1/ss-lv/search?category=flats®ion=jurmala&listing_type=sale&max_price=60000&sort=price_asc` with your key in the `X-API-Key` header. Each item's `url` is what `listing` takes. Check `has_more` before asking for the next `page`. Every successful call costs 1 credit; failed calls cost nothing. Real estate JSON REST MCP ### More real estate APIs [28Hse](https://perceptlayer.com/apis/28hse) [4zida](https://perceptlayer.com/apis/4zida) [591](https://perceptlayer.com/apis/591-house) [99.co](https://perceptlayer.com/apis/99co) [99acres](https://perceptlayer.com/apis/99acres) [Adondevivir](https://perceptlayer.com/apis/adondevivir) [Apartment List](https://perceptlayer.com/apis/apartment-list) [Apartments.com](https://perceptlayer.com/apis/apartments-com) [Aqar](https://perceptlayer.com/apis/aqar) [Aqarmap](https://perceptlayer.com/apis/aqarmap) [Argenprop](https://perceptlayer.com/apis/argenprop) [athome](https://perceptlayer.com/apis/athome) Use cases ### Track asking prices and price per m² for flats in Riga and Jūrmala `Use the SS.lv API to track asking prices and price per m² for flats in Riga and Jūrmala` ### Compare flats by building \`series\` `` Use the SS.lv API to compare flats by building `series` `` ### Watch new ads with \`latest\` or \`posted=today\` `` Use the SS.lv API to watch new ads with `latest` or `posted=today` `` ### Find plots, farms and commercial premises by region `Use the SS.lv API to find plots, farms and commercial premises by region` FAQ ## Questions **Do I need an SS.lv account?** No. You call this SS.lv API with your Perceptlayer key in the \`X-API-Key\` header, with no SS.lv login. **How much does the SS.lv API cost?** Each successful call costs one credit. New accounts get free credits to start, and credit packs bring the price down as you scale. **What format are responses in?** Every endpoint returns JSON, with no HTML parsing on your side. **Do filters and sort apply across all pages?** No. They apply to the one source page that was fetched, as \`notices\` says. \`source\_page\` and \`filtered\_from\` show which page and how many ads it held. **Should I build a SS.lv scraper instead?** You can, but a SS.lv scraper is code you maintain: page changes break it, requests get blocked, and SS.lv's terms govern how you collect data. The SS.lv API gives you 7 endpoints of named JSON fields for 1 credit per successful call, and failed calls cost nothing. A scraper makes sense only for data these endpoints don't return, so check the response in the playground on this page first. ## Try the SS.lv API with 100 free credits No credit card. Failed calls are never billed. [Get a free API key](https://perceptlayer.com/signup) [Read the docs](https://docs.perceptlayer.com)