Bolha API

Search Slovenia's Bolha the way the site does, then read any listing in full

Bolha (bolha.com) is Slovenia's largest classifieds site: second-hand goods, electronics, car parts, cars and property, from private people and businesses, and this API reads it as JSON with prices in euros.

endpoints
4
credits per call
2–3

2 credits per call≈ $2/1,000 calls1,000 free credits, no card

4 active endpoints, on 2 and 3 credit tiers.

  • POST/bolha/v1/search2 credits
  • POST/bolha/v1/browse3 credits
  • POST/bolha/v1/categories2 credits
  • POST/bolha/v1/listing2 credits
Try it live

Run the call yourself, on the real endpoint

Change a parameter and press Try it. The response on the right is what your code will receive.

Bolha API

5 of 4 endpoints, ready to run

View docs ↗

Graphics cards on Bolha, newest first

2 credits1 required · 1 optional
POST/bolha/v1/search
idle
// 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.

Try every endpoint in the playground

Endpoints

What Bolha endpoints does ReefAPI ship?

4 live read endpoints. Read-only data API: no writes, no account actions, no dashboard access on the target site.

4 endpoints

search

2 cr

Keyword search across all of bolha.com (Slovenia, prices in EUR), with the source's own filters.

required
query
optional
category_id, min_price, max_price, condition, with_images, title_only, payprotect_only, sort, page

browse

3 cr

List one bolha.com category page (e.g.

required
category
optional
min_price, max_price, seller_type, condition, with_images, filters, sort, page

categories

2 cr

The bolha.com category tree, one level at a time.

required
—
optional
category

listing

2 cr

Full bolha.com listing by listing_id or URL.

required
—
optional
listing_id, url

Every parameter, every allowed value →

Missing a Bolha endpoint, or need a source we don't have yet?Contact us real people · same-day reply.
How it works

How the Bolha API works

Bolha is a normal ReefAPI surface — the same four rules that hold for every other engine on the key.

01
Authenticate
x-api-key header

No OAuth app, no request signing, no per-site account. One key covers all 746 engines.

02
Call
POST /bolha/v1/…

Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.

03
Pay
2 or 3 credits per call

Credits, not seats. Failed and blocked calls are never charged, and nothing is cached: every call reads the source live.

04
Read
{ ok, data, meta, error }

One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.

Recipe

From a keyword to a dated price list of Slovenian listings

Search Bolha, page through, then read the listings that matter. This is the same data as /njuskalo-api with the site fixed to bolha.com; calls to POST /njuskalo/v1/... with site=si keep working unchanged.

01search?query=RTX%205070&sort=new
GET/bolha/v1/search?query=RTX%205070&sort=new

Rows with price in EUR, condition, location, date, promoted flag and the private or business seller, plus the site's total and page count.

02search?query=RTX%205070&sort=new&page=2
GET/bolha/v1/search?query=RTX%205070&sort=new&page=2

Page until has_more is false (page 400 at most).

03categories?category=avto-moto
GET/bolha/v1/categories?category=avto-moto

Child categories with live listing counts; the slug goes into browse.

04listing?listing_id=<listing_id>
GET/bolha/v1/listing?listing_id=<listing_id>

Every detail field, description, photos, coordinates, view count, expiry date and the seller's profile.

A dated feed of Slovenian listings with euro prices, the category's own facts and the private or business seller behind each one.

request
curl -X POST https://api.reefapi.com/bolha/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"kolo"}'
response envelope
{
  "ok": true,
  "data": { … },
  "meta": {
    "api": "bolha",
    "endpoint": "search",
    "mode": "live",
    "latency_ms": …,
    "record_count": …
  },
  "error": null
}
Fields

What a Bolha field actually contains

Fields that read differently from how they look. Every row was measured against live bolha.com responses on 2026-11-22.

FieldWhat it holds
listing_idThe number after -oglas- in the listing's web address (16796466). Pass it unchanged to listing; a bolha.com listing URL works too.
price, price_textprice is the asking price in euros as a number; price_text is the site's own string ("14.400 €": the dot groups thousands). 31 of 31 "kolo" rows carried a price.
conditionThe site's own word on the card: rabljeno (used) or novo (new); null when the seller set none (6 of 31 "kolo" rows, all of them promoted).
is_promotedPaid promoted listings shown above the regular results on page 1 (6 for "kolo"). The site picks a different set on each request; the 25 regular rows are stable.
payprotecttrue when the listing can be bought with Bolha's BREZ SKRBI online payment (5 of 31 "kolo" rows); payprotect_only keeps only those.
seller.seller_typeprivate or business on search rows, as the site labels the seller (29 private and 2 business on "kolo").
attributesThe key facts the site prints on the card for that category: for cars year, fuel, power and body type on 27 of 27 rows, mileage on 24 of 27.
total, last_reachable_page, adapted_category_idtotal is the site's own count (18,595 for "kolo"); the site serves at most 400 pages of 25, so last_reachable_page says where results stop. adapted_category_id is the category Bolha matched the keyword to (30122 for "kolo").
coordinatesThe listing's map point with approximate true when the site itself marks the point as approximate (true on the car listing measured).

Prices are in euros as the sellers list them. The private-or-business seller filter (seller_type) is refused on Bolha's categories because the site has none there; every row still says which kind of seller it is.

Coverage

Bolha coverage, measured

Every number below was read from live bolha.com responses on 2026-11-22 (10 calls plus a 15-case comparison run that included a paying customer's own searches).

Site and currency

bolha.com, Slovenia, prices in euros: 31 of 31 rows for "kolo" carried EUR and a link on www.bolha.com, from 10 to 2,550 EUR.

Search

"kolo" matched 18,595 listings in 744 pages, of which the site serves 400; page 1 had 25 regular rows and 6 promoted ones. "RTX 5070" matched 217, "RTX 5060" 178 and "RTX 5080" 72.

Filters that bite

"kolo" (18,597 listings on that call) → used and payable online with BREZ SKRBI 600, with 25 of 25 rows used and BREZ SKRBI. Cars (avto-oglasi) 2,694 → built 2018 or later 1,525.

Categories

Avto-moto children with live counts: Nadomestni deli 315,162, Platišča, pnevmatike, tuning 110,023, Dodatna oprema 26,456, Motociklizem 2,929, Avto oglasi 2,694, Novi avtomobili 498 and 5 more.

Seller

Every row carries the seller's name and type: 29 private and 2 business sellers on "kolo", 19 business and 6 private on "RTX 5080". A listing adds username, profile link, region and the phone-verified flag.

Listing detail

A car listing returned 28 of 36 fields: price 14,400 EUR, 18 detail rows (make, model, VIN, year, first registration, mileage, power), 19 photos, approximate coordinates, view count 616 and the expiry date.

Limits

At most 400 pages (10,000 rows) per query. The private-or-business seller filter exists on no Bolha category tried (cars, spare parts, audio and video): the call is refused instead of returning the whole category. Promoted rows rotate between requests.

Use cases

What people build with Bolha

The jobs this data is most often used for.

4

endpoints

2/3

credits per call

01

Track second-hand graphics card, phone and bike prices in Slovenia with condition and seller type.

02

Collect new Bolha listings for a keyword every day, newest first, and read each one in full.

03

Monitor used-car asking prices on Bolha by year and mileage with the site's own filters.

04

Count supply per category with the live listing counts of the category tree.

Pricing

What Bolha 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 →
$0.67–$1.50 / 1,000 credits
  • 1,000 free credits on signup, no card
  • One key, all 746 APIs, one credit pool
  • Failed and blocked calls are never charged
  • Credits roll over and never expire
no credit card1,000 free credits · instant API key · pay by card or crypto
Quickstart

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
curl -X POST https://api.reefapi.com/bolha/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"kolo"}'
python
import os
import requests

REEF_KEY = os.environ["REEF_KEY"]

r = requests.post(
    "https://api.reefapi.com/bolha/v1/search",
    headers={"x-api-key": REEF_KEY},
    json={
        "query": "kolo"
    },
    timeout=90,
)
print(r.json()["data"])
FAQ

Have a question? We got answers.

The questions people actually ask before wiring up Bolha.

Is there a Bolha API?▾

Yes. This API reads bolha.com as JSON: keyword search, category pages, the category tree and full listings, logged out, with one ReefAPI key.

Which currency are the prices in?▾

Euros, as the sellers list them on bolha.com: every row measured on 2026-11-22 carried EUR.

Does it return the seller?▾

Yes. Every search row carries the seller's id, name and type (private or business), and listing adds the username, profile link, region and whether the phone number is verified. The phone number itself is not shown to logged-out visitors.

Can I filter cars by year and mileage?▾

Yes, with browse on avto-oglasi and the site's own filter names from available_filters: on 2026-11-22 the category held 2,694 cars and yearManufactured[min] 2018 left 1,525.

Can I keep only private sellers?▾

Not with a filter: no Bolha category tried has one (cars, spare parts, audio and video), so seller_type is refused instead of returning the whole category. Every row carries seller.seller_type, so you can split the results yourself.

How deep can I page?▾

Up to page 400 of a search or category, which is 10,000 rows; "kolo" reported 744 pages on 2026-11-22. Narrow by category, price or condition to reach the rest.

Is this different from the Njuškalo API?▾

It is the same engine with the site fixed to bolha.com. /njuskalo-api also reads njuskalo.hr (Croatia) with site = hr or si, and calls to POST /njuskalo/v1/... with site=si keep working unchanged.

What is the Bolha API?▾

Bolha API is a ReefAPI endpoint group for slovenia's biggest classifieds: second-hand goods, car parts, cars and property, with price in eur, details and seller. It returns live JSON through POST requests under /bolha/v1.

Is the Bolha API free to try?▾

Yes. ReefAPI starts with 1,000 free credits, no card required. Bolha calls use the same shared credit balance as every other ReefAPI engine.

Do I need a Bolha login or account?▾

No login to Bolha 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 Bolha 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 Bolha API use?▾

Bolha 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 Bolha from an AI assistant or MCP client?▾

Yes. Connect ReefAPI once through MCP and your assistant can call bolha actions with the same key, credit pool and JSON envelope used by normal REST requests.

Is the Bolha API a Bolha scraper?▾

It is the managed alternative to a DIY Bolha scraper. Instead of building and maintaining your own scraper — proxies, headless browsers, captcha and constant breakage — you call one ReefAPI endpoint and get the same slovenia's biggest classifieds: second-hand goods, car parts, cars and property, with price in eur, details and seller back as clean JSON.

Same key

126 Classifieds & Second-hand APIs on the same key

One key, one credit pool, one response envelope. If you are pulling Bolha, you are one call away from the rest of the category — no second contract, no second integration.

Contact

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.

0/4000

No account needed · we reply from [email protected]

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 745 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-11-22.