---
title: "SS.lv API: Search | Perceptlayer"
description: "Search from SS.lv as JSON. 1 credit per successful call."
url: https://perceptlayer.com/apis/ss-lv/search
---

[APIs](https://perceptlayer.com/apis) / [SS.lv](https://perceptlayer.com/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.

| Parameter | Type | Required | Allowed values |
| --- | --- | --- | --- |
| `category` | string | Optional | flats, homes, farms, plots, offices, wood, premises, other |
| `sub_category` | string | Optional | hangars, 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 |
| `region` | string | Optional | riga, 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 |
| `district` | string | Optional | centre, 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_type` | string | Optional | sale, rent |
| `posted` | string | Optional | today, 2d, 5d |
| `min_price` | number | Optional | Any |
| `max_price` | number | Optional | Any |
| `min_price_per_sqm` | number | Optional | Any |
| `max_price_per_sqm` | number | Optional | Any |
| `min_rooms` | integer | Optional | Any |
| `max_rooms` | integer | Optional | Any |
| `min_area` | number | Optional | Any |
| `max_area` | number | Optional | Any |
| `min_floor` | integer | Optional | Any |
| `max_floor` | integer | Optional | Any |
| `series` | string | Optional | Up to 40 characters |
| `sort` | string | Optional | price\_asc, price\_desc, area\_asc, area\_desc, price\_per\_sqm\_asc, price\_per\_sqm\_desc |
| `page` | integer | Optional | Any |

## 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 OK JSON X-Credits-Used: 1

Recorded from our API and shortened.

[Run this endpoint in the playground](https://perceptlayer.com/apis/ss-lv?try=search#playground) with your own parameters. 1 credit per successful call; failed calls are free.
