Bolha
Slovenia's biggest classifieds: second-hand goods, car parts, cars and property, with price in EUR, details and seller.
/bolha/v1/search2 creditsKeyword search across all of bolha.com (Slovenia, prices in EUR), with the source's own filters: category id, price range, condition, photos only, title-only matching, BREZ SKRBI (online payment) only, and 5 sort orders. Each row: listing id, title, URL, image, price (parsed + as printed), location, condition, the card's attributes (year, mileage, kW …), dates, promoted flag and the seller (id, name, private/business, rating). Plus the source's total, page count, the last page it actually serves (400) and the category bolha adapts the keyword to.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| query | required | — | Search words (Slovenian or product names, e.g. `kolo`, `rtx 5070`, `otroški voziček`). Matched in title and description unless `title_only`. |
| category_id | optional | — | Numeric bolha.com category id to narrow the search (e.g. 13688 = Avto oglasi). Ids come from `categories` (`category_id`) or a listing's `category`. An id the site does not know is rejected (INVALID_PARAM). |
| min_price | optional | 0– | Minimum price in EUR. |
| max_price | optional | 0– | Maximum price in EUR. |
| condition | optional | new · used · defective | Item condition (one value). Listings with no condition set are in none of the three classes. |
| with_images | optional | — | Only listings that have at least one photo. |
| title_only | optional | — | Match the words in the listing TITLE only. |
| payprotect_only | optional | — | Only listings that can be bought with bolha's escrow payment (BREZ SKRBI). |
| sort = relevance | optional | relevance · new · old · cheap · expensive | Result order (the site's own options). |
| page = 1 | optional | 1–400 | Result page: 25 regular rows on most pages (36 measured on `mobiteli`) plus up to 6 promoted rows on page 1. The source serves at most 400 pages (10,000 rows) per query even when its own page count is higher; see `last_reachable_page`. |
/bolha/v1/browse3 creditsList one bolha.com category page (e.g. `avto-oglasi`, `nadomestni-deli`, `avdio-in-video`) with the price range in EUR, condition, photos-only and sort — plus any of the category's OWN filters (car year, mileage, fuel, power …) through `filters`, using the parameter names the response lists in `available_filters`. Rows have the same shape as search. Also returns the category's sub-categories with counts.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| category | required | — | Category path as in the bolha.com URL, without the domain: `avto-oglasi`, `nadomestni-deli`, `avdio-in-video`, `motociklizem`. Slugs come from `categories`. Landing pages without listings (`avto-moto`, `marketplac`, `nepremicnine`) are refused — list their children with `categories`. |
| min_price | optional | 0– | Minimum price in EUR. |
| max_price | optional | 0– | Maximum price in EUR. |
| seller_type | optional | private · business | Private or business sellers, only where the category itself has that filter. None of the bolha.com categories measured on 2026-11-22 has it (avto-oglasi, nadomestni-deli, avdio-in-video): such a call is refused (INVALID_PARAM), never answered with the whole category. Each row's `seller.seller_type` still says private or business. |
| condition | optional | new · used · defective | Item condition (one value). Listings with no condition set are in none of the three classes. |
| with_images | optional | — | Only listings that have at least one photo. |
| filters | optional | — | The category's own filters as `{parameter: value}`, named exactly as listed in `available_filters[].params` (on `avto-oglasi`: `yearManufactured[min]`, `mileage[max]`, `fuelTypeId`, `motorPower[min]`, `bodyTypeId` …). A parameter the category does not have is rejected, never silently ignored. |
| sort = new | optional | new · old · cheap · expensive | Result order (category pages default to newest). |
| page = 1 | optional | 1–400 | Result page: 25 regular rows on most pages (36 measured on `mobiteli`) plus up to 6 promoted rows on page 1. The source serves at most 400 pages (10,000 rows) per query even when its own page count is higher; see `last_reachable_page`. |
/bolha/v1/categories2 creditsThe bolha.com category tree, one level at a time: without `category` the site's top-level sections (Nepremičnine, Avto-moto, Marketplac) and their main categories; with a category path its child categories with the live listing count of each. Feed a `slug` to `browse`, a `category_id` to `search`.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| category | optional | — | Category path whose children to list (`avto-moto`, `nepremicnine`, `marketplac`). Omit for the top level. |
/bolha/v1/listing2 creditsFull bolha.com listing by listing_id or URL: title, price in EUR (parsed + printed, on-request flag), state, created / expiry dates, view count, category path, location + map coordinates (approximate flag), every detail field the listing shows (car: make, model, year, mileage, power, VIN, registration …), equipment groups, full description, all photos, BREZ SKRBI fees, and the seller (id, username, private / business / store, profile URL, region, phone-verified flag, rating).
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| listing_id | optional | — | Bolha.com listing id: the digits after `-oglas-` in a listing URL, returned as `listing_id` in every search/browse row. Provide listing_id OR url. |
| url | optional | — | A bolha.com listing URL; alternative to listing_id. |
curl -X POST https://api.reefapi.com/bolha/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"kolo"}'{
"ok": true,
"data": { /* the result */ },
"meta": {
"latency_ms": 240,
"record_count": 12,
"completeness_pct": 100
},
"error": null
}Measured at 60 requests a second across the fleet, with no central bottleneck. Volume pricing is on request, and per-key limits are raised for high-volume accounts.
Tell us a site we do not cover yet and it becomes an engine. A customer asked for bestprice.gr on a Sunday and it was in the catalog the next day.
Median time from a question in the live chat to the first answer, measured across every answered conversation. Setup help included, no support tier to buy.
No per-site plans and no separate subscriptions. One key and one credit pool across the whole catalog, so adding a source costs nothing up front.
Planning something large? Tell us the volume and the sources and we will come back with what it costs and what we would have to build.