APIs / SS.lv / Search

SS.lv: Search

Search from SS.lv as JSON. 1 credit per successful call.

GET /v1/ss-lv/search

Parameters

Send parameters in the query string.

ParameterTypeRequiredAllowed values
categorystringOptionalflats, homes, farms, plots, offices, wood, premises, other
sub_categorystringOptionalhangars, garrets, buildings-and-complexes, workshops, garages, storehouses-and-storages, basements-and-semi-basements, penthouses, bathhouses, production-facilities, restaurants-cafe-dining-halls, household-buildings, saloons, playing-halls, training-halls, premises-for-service-centers, shops, other, parkings, vegetable-gardens, grounds, module-houses, unfinished-and-emergency-facilities, movable-houses, advertising-squares, farm-management, sport-grounds, places-for-picnics-and-rest
regionstringOptionalriga, jurmala, riga-region, aizkraukle-and-reg, aluksne-and-reg, balvi-and-reg, bauska-and-reg, cesis-and-reg, daugavpils-and-reg, dobele-and-reg, gulbene-and-reg, jekabpils-and-reg, jelgava-and-reg, kraslava-and-reg, kuldiga-and-reg, liepaja-and-reg, limbadzi-and-reg, ludza-and-reg, madona-and-reg, ogre-and-reg, preili-and-reg, rezekne-and-reg, saldus-and-reg, talsi-and-reg, tukums-and-reg, valka-and-reg, valmiera-and-reg, ventspils-and-reg
districtstringOptionalcentre, agenskalns, aplokciems, bergi, bierini, bolderaya, breksi, bukulti, bulli, chiekurkalns, darzciems, daugavgriva, dreilini, dzeguzhkalns, grizinkalns, ilguciems, imanta, janjavarti, jaunciems, jaunmilgravis, yugla, katlakalns, kengarags, kiburga, kipsala, kleisti, kliversala, krasta-st-area, kundzinsala, maskavas-priekshpilseta, lucavsala, mangali, mangalsala, mezhapark, mezhciems, plyavnieki, purvciems, rumbula, shampeteris-pleskodale, sarkandaugava, shkirotava, teika, tornjakalns, trisciems, vecaki, vecdaugava, vecmilgravis, vecriga, voleri, zakusala, zasulauks, ziepniekkalns, zolitude, vef, other, all, baldone, balozi, olaine, salaspils, saulkrasti, sigulda, vangazi, adazu-nov, allazu-pag, babites-pag, carnikavas-nov, daugmales-pag, garkalnes-nov, incukalna-nov, kekavas-pag, krimuldas-pag, malpils-pag, marupes-pag, olaines-pag, ropazu-nov, salas-pag, salaspils-l-t, saulkrastu-l-t, sejas-nov, stopinu-nov
listing_typestringOptionalsale, rent
postedstringOptionaltoday, 2d, 5d
min_pricenumberOptionalAny
max_pricenumberOptionalAny
min_price_per_sqmnumberOptionalAny
max_price_per_sqmnumberOptionalAny
min_roomsintegerOptionalAny
max_roomsintegerOptionalAny
min_areanumberOptionalAny
max_areanumberOptionalAny
min_floorintegerOptionalAny
max_floorintegerOptionalAny
seriesstringOptionalUp to 40 characters
sortstringOptionalprice_asc, price_desc, area_asc, area_desc, price_per_sqm_asc, price_per_sqm_desc
pageintegerOptionalAny

Example request

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.

Run this endpoint in the playground with your own parameters. 1 credit per successful call; failed calls are free.