Sign inGet a free API keyDashboard
Menu

APIs / Real estate / SS.lv

1 credit per call7 endpoints17 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 keyRun it below
SS.lv
GET/v1/ss-lv/search?category=flats&region=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 OKJSONX-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.

#idstringcodestringurlurltitlestringlisting_typestringlocationobjectroomsintegerareaintegerarea_unitstringfloorintegerfloors_totalintegerseriesstringpriceintegerprice_per_sqmintegercurrencystringprice_textstringthumbnailurl
158166421becpehttps://www.ss.lv/msg/lv/real-estate/flats/jurmala/sloka/becpe.htmlPārdošanā ekonomisks 2 istabu dzīvoklis ar malkas apkuri. Atsale{3 fields}238m222P. kara15000395EUR15,000 €https://i.ss.lv/gallery/8/1568/391927/78385219.th2.jpg
258280434cnbjbhttps://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āmsale{3 fields}118m213Hrušč.260001444EUR26,000 €https://i.ss.lv/gallery/8/1551/387503/77500540.th2.jpg
358125611aenlghttps://www.ss.lv/msg/lv/real-estate/flats/jurmala/kauguri/aenlg.htmlPārdod 1-istabas dzīvokli Kauguros, lieliskā vietā dzīvošanasale{3 fields}131m255Hrušč.320001032EUR32,000 €https://i.ss.lv/gallery/8/1550/387457/77491215.th2.jpg

Recorded from our API · 3 items shown · 17 datapoints per itemGET /v1/ss-lv/search?category=flats&region=jurmala&listing_type=sale&max_price=60000&sort=price_asc

17 datapoints

Identity

  • idstring
  • titlestring
  • listing_typestring

Contact

  • urlurl

Location

  • locationobject
  • areainteger
  • area_unitstring

Price

  • priceinteger
  • price_per_sqminteger
  • currencystring
  • price_textstring

Other

  • codestring
  • roomsinteger
  • floorinteger
  • floors_totalinteger
  • seriesstring
  • thumbnailurl

Playground

Run this API

cURLshell
curl "https://api.perceptlayer.com/v1/ss-lv/search?category=flats&region=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.

EndpointRequired parametersCost
GET/v1/ss-lv/agencies
none+1 optional
1 credit
GET/v1/ss-lv/agency
url
1 credit
GET/v1/ss-lv/autocomplete
query+2 optional
1 credit
GET/v1/ss-lv/latest
none+5 optional
1 credit
GET/v1/ss-lv/listing
url
1 credit
GET/v1/ss-lv/search
none+19 optional
1 credit
GET/v1/ss-lv/text-search
query+1 optional
1 credit

Overview

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&region=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 estateJSONRESTMCP

More real estate APIs

28Hse4zida59199.co99acresAdondevivirApartment ListApartments.comAqarAqarmapArgenpropathome

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 keyRead the docs