Search Latvia's biggest classifieds site, then read any advert in full
SS.com (also reached at ss.lv) is where Latvia sells cars, rents flats, hires and sells almost everything else, and this API reads it as JSON.
4 active endpoints, on 2 and 3 credit tiers.
- POST/ss-lv/v1/search
- POST/ss-lv/v1/browse
- POST/ss-lv/v1/listing
- POST/ss-lv/v1/categories
What SS.com endpoints does ReefAPI ship?
4 live read endpoints. Read-only data API: no writes, no account actions, no dashboard access on the target site.
SS.com API
4 of 4 endpoints, ready to run
Search every SS.com section at once
// Press "Try it" and this pane shows exactly what the // live site returned this second — including an empty // result, if that is the truth. No key, no account.
How the SS.com API works
SS.com is a normal ReefAPI surface — the same four rules that hold for every other engine on the key.
No OAuth app, no request signing, no per-site account. One key covers all 438 engines.
Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.
Credits, not seats. Failed and blocked calls are never charged, and cache hits cost nothing.
One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.
From a category to a filtered, fully read Latvian market feed
Find the category and its filters, browse it with the filters that matter, then read the adverts you keep.
Returns the deal types (sell, buy, hand over, swap), the counts for today / 2 days / 5 days, the table columns, and the filter keys this category offers: price, rooms, area, floor, series.
Flats for sale in central Riga with 3 or more rooms: 16 pages instead of 29, every row with street, rooms, m², floor, series, price per m² and price.
id>
Pass any row's id unchanged for the full advert: description, every attribute, photos, map coordinates, posting time, unique visits and the seller block.
A dated feed of Latvian adverts in EUR with the category's own structured columns, filtered the way the site filters, and the complete advert behind every row.
curl -X POST https://api.reefapi.com/ss-lv/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"iphone 13"}'{
"ok": true,
"data": { … },
"meta": {
"api": "ss-lv",
"endpoint": "search",
"mode": "live",
"latency_ms": …,
"record_count": …
},
"error": null
}What an SS.com field actually contains
Six fields that need one sentence of context. Every row was checked against live SS.com pages on 2026-10-07.
| Field | What it holds |
|---|---|
| price / price_text | price is the number SS.com prints, in EUR; price_text is the printed string. A rent keeps its period in price_period (mon., day, week). Adverts that print no number (buy, swap) have price null and the words in price_text. A list row's price matched the advert's own price on 24 of 24 adverts checked. |
| price_per_m2 | Property only: the site's own price per square metre, shown both in the list column and in the advert's price line. |
| columns | A list row's table cells keyed by the category's own column titles - Model / Year / Volume / Run / Price for cars, Street / R. / m² / Floor / Series / Price, m2 / Price for flats. Titles follow the lang parameter. |
| views | Unique visits to the advert, as the advert page shows them after it loads. The static page text always says 1; the API returns the real figure. |
| seller.phone_masked | SS.com prints the first digits of the seller's phone, e.g. (+371) 20-32-***; the remaining digits, the VIN and the registration number open only after an 'I'm not a robot' check. The API returns what is printed and lists the gated fields in hidden_fields. |
| id and ad_number | id is the few letters before .html in the advert URL (for example cfjjkm) - pass a row's id to listing unchanged and the advert comes back with the same id. ad_number is SS.com's numeric advert number, kept for reference; SS.com cannot open an advert by that number, so listing asks for the id instead. |
Measured limits: text search stops at 50 pages (1,500 adverts) per query and says so with last_page_is_cap; SS.com publishes no total count, only its own last page; page size is the source's (60 on car makes, 30 elsewhere); asking past the last page returns zero rows with page_clamped instead of repeating page 1.
Latvia coverage, measured
Every number below was read from live SS.com pages on 2026-10-07.
Latvia (SS.com and ss.lv are one site), prices in EUR. All sections: work, transport, real estate, construction, electronics, clothes, home, production, children, animals, agriculture, leisure.
BMW adverts 73 pages of 60; flats in central Riga 55 pages of 30, of them 29 for sale; Apple phones 44 pages; search iphone 13 11 pages. Whole site: 298,175 adverts on the site's own counter.
Measured on the same run: BMW 73 pages -> 5 with price_max 3000 and -> 25 with year_min 2015; central Riga flats for sale 29 -> 16 pages with rooms_min 3; no returned row broke its filter. Today / 2 days / 5 days: 60 / 309 / 460 flats in central Riga.
List price matched the advert's own printed price on 12 of 12 adverts per run across cars, flats, phones and furniture. A row's id passed to listing returned the same id and the same price on 6 of 6 rows from cars, flats and search.
Description, attributes, photos, posting time, unique visits and the printed part of the phone on every advert checked; map coordinates on every property advert; car equipment lists on every car advert.
Search stops at 50 pages (1,500 adverts) per query. No total count, no seller rating. Full phone number, VIN and registration plate are behind the site's robot check and are not returned.
What people build with SS.com
The jobs this data is most often used for.
endpoints
credits per call
Track Latvia's used-car prices by make: browse transport/cars/<make> daily and keep id, model, year, engine, mileage and EUR price from each row.
Build a Riga rent and sale index per district from real-estate/flats/riga/<district> with price, price per m², rooms, floor and building series.
Watch new adverts the day they appear with period = today, then pass each row's id to listing for the full text, photos and seller.
Size demand and supply for a product across all of SS.com with search, and read category_names on each row to see where it is listed.
What SS.com data costs
The cheapest call here is 2 credits, so $15/mo (Pro) buys 5,000 of them — $1.50 per 1,000 credits. Credits roll over and never expire, and failed or blocked calls are not charged.
Full pricing →- 1,000 free credits on signup, no card
- One key, all 438 APIs, one credit pool
- Failed and blocked calls are never charged
- Credits roll over and never expire
Call it in two lines
Sign up, get 1,000 credits and one key that works on every engine. Then this is the whole protocol.
curl -X POST https://api.reefapi.com/ss-lv/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"iphone 13"}'import requests
r = requests.post(
"https://api.reefapi.com/ss-lv/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "iphone 13"
},
)
print(r.json()["data"])Have a question? We got answers.
The questions people actually ask before wiring up SS.com.
Get a free key →Do I need an account or a Latvian IP to use the SS.com API?▾
No. Search, category lists and adverts are read without an account or a login, and you call reefapi.com from anywhere.
Is ss.lv the same site as ss.com?▾
Yes. ss.lv and ss.com serve the same adverts, and the API accepts advert URLs from either domain.
Which languages are supported?▾
English, Latvian and Russian (lang = en, lv, ru). The language changes the site's own labels - category names, column titles, attribute names, deal type. The advert text is always the seller's own words, usually Latvian or Russian.
How do I filter cars by price or year, or flats by rooms?▾
Call categories on the category you want: it returns the filter keys that category's own form offers, such as price_min, price_max, year_min, gearbox and fuel_type for a car make, or rooms_min, area_max, floor_min and series for flats. Pass them to browse. Each filter is checked on the returned page; measured: BMW adverts went from 73 pages to 5 with price_max 3000 and to 25 with year_min 2015, with no row outside the limit.
Can I get only new adverts?▾
Yes. browse takes period = today, 2days or 5days. On 2026-10-07 central Riga had 60 flats posted that day, 309 in two days and 460 in five, and categories returns those counts for any category.
How many results can one search return?▾
SS.com stops a text search at 50 pages of 30, so 1,500 adverts. Broad words such as golf or bmw hit that ceiling; the response sets last_page_is_cap so you know to narrow the query or switch to browse, which pages a whole category.
Can I get the seller's full phone number?▾
No. SS.com itself prints only the first digits and reveals the rest after an 'I'm not a robot' check. You get the printed part, the company name, address, working hours and logo when the seller is a business, and how many adverts run on the same phone.
What does SS.com not publish?▾
No total result count (only the last page), no seller rating, no full phone number, VIN or registration plate without the robot check, and no coordinates outside property adverts. Those come back as null rather than guessed.
What is the SS.com API?▾
SS.com API is a ReefAPI endpoint group for latvia's biggest classifieds site: cars, flats, jobs and electronics in eur, with full adverts and seller details. It returns live JSON through POST requests under /ss-lv/v1.
Is the SS.com API free to try?▾
Yes. ReefAPI starts with 1,000 free credits, no card required. SS.com calls use the same shared credit balance as every other ReefAPI engine.
Do I need a SS.com login or account?▾
No login to SS.com is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the SS.com data?▾
The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the SS.com API use?▾
SS.com actions currently cost 2-3 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
Can I call SS.com from an AI assistant or MCP client?▾
Yes. Connect ReefAPI once through MCP and your assistant can call ss-lv actions with the same key, credit pool and JSON envelope used by normal REST requests.
99 Classifieds & Second-hand APIs on the same key
One key, one credit pool, one response envelope. If you are pulling SS.com, you are one call away from the rest of the category — no second contract, no second integration.
Need something this API does not do?
Name the endpoint, the field, or a source we do not carry yet. We ship new APIs every week and you would be first to get the key. Real people read every message and reply the same day.
Try it on your own data before you pay anything
The call above is the real endpoint, not a recording. A free key gives you 1,000 credits, the other 437 APIs, and the same envelope everywhere.
Endpoints, parameters and credit costs on this page are read from the live catalog and cannot drift from what the API accepts. Field notes were captured on 2026-10-07.