# Bazos API scraper — search the Czech (bazos.cz) and Slovak (bazos.sk) classifieds: keyword and category search with postal-code radius, price band and sort, full ad detail with photos, and a per-market category/subcategory resolver. Prices come back in the market's own currency (CZK / EUR) with the source string beside every number, and negotiable or unpriced ads return null rather than a fake zero. No account, public logged-out data only; ad text is returned as the seller wrote it.

> Search Bazos classifieds by keyword and/or category, with subcategory, postal-code radius, price band, five sorts and paging (20 ads per page). Paid TOP ads are returned in the position Bazos puts them and flagged `promoted: true` — they are not always on topic, so they are labelled rather than hidden or passed off as hits.
> ReefAPI engine `bazos` · 3 endpoints · clean JSON, no scraping or browsers to manage.

## How to call
- **Endpoint:** `POST https://api.reefapi.com/bazos/v1/<action>` with a JSON body.
- **Auth:** header `x-api-key: <YOUR_REEFAPI_KEY>` — create one free (1,000 credits, no card): https://reefapi.com/signup
- **Response (every call):** `{ ok: boolean, data: ..., meta: { record_count, credits, ... }, error: { code, message } }` — branch on `ok`. Failed calls are free.
- **One key + one shared credit pool** across every ReefAPI API. Per-call credits are listed on each endpoint below.
- **Use it from an AI agent (MCP):** connect `https://api.reefapi.com/mcp` (remote streamable-http). Clients that add connectors by URL, such as ChatGPT and the Claude app, connect with OAuth 2.1 (the user pastes their key once on a ReefAPI page; discovery at `/.well-known/oauth-protected-resource/mcp`). Config files send the key as `Authorization: Bearer <key>`. `?key=<key>` in the URL also works as a last-resort fallback.

## Endpoints

### POST https://api.reefapi.com/bazos/v1/search — 1 credit
Search Bazos classifieds by keyword and/or category, with subcategory, postal-code radius, price band, five sorts and paging (20 ads per page). Paid TOP ads are returned in the position Bazos puts them and flagged `promoted: true` — they are not always on topic, so they are labelled rather than hidden or passed off as hits.

**Parameters:**
- `market` (enum, optional, default "cz") — Which Bazos catalogue to read. The two are separate marketplaces with separate listings, separate category slugs and separate currencies; an unsupported value is rejected, never substituted. [one of: cz, sk]
- `query` (string, optional) — Keyword Bazos matches against ad titles and bodies. Optional when `category` is given (then the whole category is browsed).
- `category` (string, optional) — Bazos rubrika slug. 🔴 The Czech and Slovak slugs differ (dum/dom, motorky/motocykle, nabytek/nabytok, obleceni/oblecenie, prace/praca, zvirata/zvierata, ostatni/ostatne) — call `categories` for the market you are querying. [one of: auto, auto, deti, deti, dom, dum, elektro, elektro, foto, foto, hudba, hudba, knihy, knihy, mobil, mobil, motocykle, motorky, nabytek, nabytok, obleceni, oblecenie, ostatne, ostatni, pc, pc, praca, prace, reality, reality, sluzby, sluzby, sport, sport, stroje, stroje, vstupenky, vstupenky, zvierata, zvirata]
- `subcategory` (string, optional) — Subcategory slug inside `category`, e.g. 'apple' under 'mobil' or 'audi' under 'auto'. Get the list from the `categories` action with a `category`. Requires `category`.
- `sort` (enum, optional, default "newest") — Result order. Note: the two price sorts make Bazos drop ads whose price is a word ('Dohodou', 'Nabidnete', 'V textu'), so the reported total shrinks; meta reports that. [one of: newest, price_asc, price_desc, most_viewed, least_viewed]
- `postal_code` (string, optional) — Five-digit postal code to centre the search on (Czech or Slovak, matching `market`). Combined with `radius_km`. A code Bazos does not know is rejected, not silently ignored.
- `radius_km` (integer, optional, default 25) — Search radius in km around `postal_code`. Ignored by Bazos when no postal code is given.
- `price_min` (integer, optional) — Lowest price to include, a whole number in the market's currency (CZK for cz, EUR for sk). Bazos' own price fields are whole numbers.
- `price_max` (integer, optional) — Highest price to include, a whole number in the market's currency (CZK for cz, EUR for sk). Bazos' own price fields are whole numbers.
- `page` (integer, optional, default 1) — 1-based page. Bazos serves 20 ads per page.

**Returns:** market, currency, query/category/subcategory echo, total_results (+ the source's own printed string), page, page_size, has_more, and listings[] with listing_id, url, title, description_excerpt, image, price, price_currency, price_kind (fixed|free|negotiable|in_text|absent), price_text, locality, postal_code, views, posted_date, promoted, promoted_label and category.

**Example request body:**
```json
{
  "market": "cz",
  "query": "iphone"
}
```

### POST https://api.reefapi.com/bazos/v1/listing — 1 credit
Full detail of one Bazos ad: title, complete description, price, locality, view count, posting date, breadcrumb and every photo. Accepts the ad URL, or a listing_id together with its category.

**Parameters:**
- `market` (enum, optional, default "cz") — Which Bazos catalogue to read. The two are separate marketplaces with separate listings, separate category slugs and separate currencies; an unsupported value is rejected, never substituted. [one of: cz, sk]
- `url` (string, optional) — Full Bazos ad address, exactly as `search` returns it. The simplest handle — it already carries the category and the market.
- `listing_id` (string, optional) — Numeric ad id. Needs `category` as well, because the category is the host of the address on Bazos. Prefer `url`.
- `category` (string, optional) — Rubrika slug that hosts the ad — required with `listing_id`, ignored when `url` is given.

**Returns:** listing_id, url, title, description, price, price_currency, price_kind, price_text, locality, postal_code, views, posted_date, promoted, promoted_label, category, breadcrumb[], images[], image_count and seller.display_name. The description is returned as written (contacts typed into it included); the click-to-reveal phone is not fetched.

**Example request body:**
```json
{
  "url": "https://mobil.bazos.cz/inzerat/224930267/iphone-16-pro-max-256-gb-black-titanium-krabicka-kabel.php"
}
```

### POST https://api.reefapi.com/bazos/v1/categories — 1 credit
The market's own category tree — the resolver `search` needs, because Czech and Slovak Bazos use different slugs for the same rubrika. With no `category` it returns the 20 rubriky with the live totals Bazos prints; with a `category` it returns that rubrika's subcategories.

**Parameters:**
- `market` (enum, optional, default "cz") — Which Bazos catalogue to read. The two are separate marketplaces with separate listings, separate category slugs and separate currencies; an unsupported value is rejected, never substituted. [one of: cz, sk]
- `category` (string, optional) — Omit to list the market's 20 rubriky with their live totals; pass a rubrika slug to list ITS subcategories instead.

**Returns:** market, and either categories[] (slug, label, url, total_listings, listings_last_24h) or category{} plus subcategories[] (slug, label, url).

**Example request body:**
```json
{
  "market": "cz"
}
```

## At scale
- **Volume:** 5M+ requests a day, measured at 60 requests a second across the fleet with no
  central bottleneck. Per-key limits are raised for high-volume accounts; volume pricing on request.
- **Missing a source:** tell us a site we do not cover and it becomes an engine. A customer asked
  for bestprice.gr on 21 Sep 2026 and it was in the catalog on 22 Sep.
- **Support:** 2 minute median time from a question in the live chat to the first answer. Setup
  help included, no support tier to buy.
- **One key, one credit pool** across every API. No per-site plans, no separate subscriptions.

## More
- Try it live, no code: https://reefapi.com/playground?engine=bazos
- Human docs page: https://reefapi.com/docs/bazos
- Overview page: https://reefapi.com/bazos-api
- Every ReefAPI API in one file (for your AI): https://reefapi.com/llms-full.txt
