ss.lv APIss.lv ↗
Access real estate listings, spare parts search, and full listing details from ss.lv, Latvia's largest classifieds site, via a structured JSON API.
curl -X GET 'https://api.parse.bot/scraper/551d0073-7cc1-4df7-b326-4ee5da9dd679/get_real_estate_listings?category=real-estate%2Fflats%2Friga%2Fcentre' \ -H 'X-API-Key: $PARSE_API_KEY'
Fetch real estate listings from a specific leaf-level category path on ss.lv. The category must be a complete path down to a district or sub-category level (e.g., 'real-estate/flats/riga/centre'). Non-leaf paths may return empty results.
| Param | Type | Description |
|---|---|---|
| category | string | Category path without /lv/ prefix. Must be a leaf-level path including district (e.g., 'real-estate/flats/riga/centre', 'real-estate/flats/riga/purvciems'). |
{
"type": "object",
"fields": {
"count": "integer total number of listings returned",
"listings": "array of listing objects each containing title, url, price, and attributes"
},
"sample": {
"data": {
"count": 30,
"listings": [
{
"url": "https://www.ss.lv/msg/lv/real-estate/flats/riga/centre/hxinf.html",
"price": "113,000 €",
"title": "",
"attributes": [
"",
"",
"Piedāvājumā plašs dzīvoklis vēsturiskā mūra namā Rīgas centrā (Ģ"
]
}
]
},
"status": "success"
}
}About the ss.lv API
The ss.lv API provides 3 endpoints for extracting structured data from Latvia's largest classifieds platform. Use get_real_estate_listings to pull property listings from specific district-level category paths, search_spare_parts to query transport and automotive parts by keyword with optional price and region filters, and get_listing_detail to retrieve complete details — including description, attributes, and location — for any individual listing URL.
Real Estate Listings
The get_real_estate_listings endpoint accepts a category parameter representing a leaf-level path on ss.lv, such as real-estate/flats/riga/centre. The path must extend all the way down to a district or sub-category level — passing a higher-level path like real-estate/flats will return empty results. The response includes a count integer and a listings array where each object carries title, url, price, and an attributes map of additional fields like area, floor, and number of rooms as they appear on the listing card.
Spare Parts Search
The search_spare_parts endpoint accepts a required query string (e.g., bmw, brake pad) and two optional filters: region as a region code string (use '0' for all regions) and price_max as an integer EUR ceiling. Listings priced above price_max are excluded before the response is returned. Results come from the transport/spare-parts category on ss.lv and follow the same count plus listings shape as the real estate endpoint.
Listing Detail
The get_listing_detail endpoint takes a full ss.lv listing URL and returns a single structured object. Response fields include title, price (with currency), location (extracted from listing attributes), description (full text body), and details — a key-value object containing all attribute pairs shown on the listing page, such as make, model, year, condition, or property size depending on the category. This endpoint works for any listing URL on ss.lv, not only real estate or spare parts.
- Track asking prices for Riga centre flats by polling
get_real_estate_listingswith a district-level category path - Build a price-alert tool for car parts by running
search_spare_partswith aprice_maxfilter and comparing results over time - Aggregate multi-district property data by calling
get_real_estate_listingsfor several leaf paths and merging thelistingsarrays - Enrich spare parts search results with full descriptions by piping listing
urlfields fromsearch_spare_partsintoget_listing_detail - Extract structured property attributes (floor, area, rooms) from individual listing pages using the
detailsobject inget_listing_detail - Monitor regional availability of specific spare parts by varying the
regionparameter insearch_spare_partsacross multiple requests
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does ss.lv have an official developer API?+
What does `get_real_estate_listings` return and how specific does the category path need to be?+
count and a listings array where each entry has title, url, price, and attributes. The category parameter must reach a leaf level that includes a district or sub-category, for example real-estate/flats/riga/centre. Paths that stop at a higher level — like real-estate/flats — will return empty results because ss.lv paginates data at the district level.