# Sbazar.cz API scraper — search Seznam.cz's Czech classifieds marketplace (~1.9 M live ads): keyword and category search with price band, seller/shop filter and four sorts, full ad detail with every photo and the complete description, and the live 451-node category tree with per-category ad counts. Prices are returned in CZK with the source's own integer beside every number, and 'price on request' ads return null instead of the fake zero the source publishes. No account, public logged-out data only; ad text is returned as the seller wrote it.

> Search Sbazar classifieds by keyword and/or category, with a CZK price band, seller/shop filter, buyer-protection and orderable flags, four sorts and paging. At least one of query, category_id, user_id or premise_id must be given (the source would otherwise return its entire catalogue). Every narrowing filter is checked against an unfiltered control in the same call and the effect is reported in meta.filters_verified, because Sbazar drops filter names it does not know without saying so. Paid 'topped' ads are returned where Sbazar puts them and flagged `promoted: true` rather than hidden.
> ReefAPI engine `sbazar` · 3 endpoints · clean JSON, no scraping or browsers to manage.

## How to call
- **Endpoint:** `POST https://api.reefapi.com/sbazar/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/sbazar/v1/search — 1 credit
Search Sbazar classifieds by keyword and/or category, with a CZK price band, seller/shop filter, buyer-protection and orderable flags, four sorts and paging. At least one of query, category_id, user_id or premise_id must be given (the source would otherwise return its entire catalogue). Every narrowing filter is checked against an unfiltered control in the same call and the effect is reported in meta.filters_verified, because Sbazar drops filter names it does not know without saying so. Paid 'topped' ads are returned where Sbazar puts them and flagged `promoted: true` rather than hidden.

**Parameters:**
- `query` (string, optional) — Keyword Sbazar matches against ad titles and bodies (its own `phrase` filter). Optional when `category_id`, `user_id` or `premise_id` is given — at least ONE of those four is required, because an unfiltered search returns the whole ~1.9 M-ad catalogue.
- `category_id` (string, optional) — Sbazar category, given either as its numeric id (237) or as its SEO slug ('237-iphone', or plain 'iphone'). A parent category includes every descendant (measured: id 1 'Auto-moto' returns ads filed under its child categories). Call `categories` for the live list. At least one of query, category_id, user_id or premise_id is required.
- `price_min` (integer, optional) — Lowest price to include, a whole number of CZK. Sbazar's own price field is a whole number of koruna. 🔴 A price band does NOT exclude 'Dohodou' (price on request) ads — the source keeps them inside any band (measured: 4 of 20 rows in a 20 000-25 000 CZK band). They come back with `price: null` and `price_kind: "by_agreement"`, so drop them on that flag if you need a priced-only list.
- `price_max` (integer, optional) — Highest price to include, a whole number of CZK. Sbazar's own price field is a whole number of koruna. 🔴 A price band does NOT exclude 'Dohodou' (price on request) ads — the source keeps them inside any band (measured: 4 of 20 rows in a 20 000-25 000 CZK band). They come back with `price: null` and `price_kind: "by_agreement"`, so drop them on that flag if you need a priced-only list.
- `sort` (enum, optional, default "relevance") — Result order. These four are the ONLY orders Sbazar actually applies — it answers HTTP 200 to any other sort string and then returns its default order, so an unknown value is rejected here rather than silently ignored. There is no oldest-first: ascending by creation date does not work at the source. [one of: relevance, newest, price_asc, price_desc]
- `user_id` (integer, optional) — Return only ads of this Sbazar user (the `seller.user_id` every search row carries). One of the four filters that can stand alone.
- `premise_id` (integer, optional) — Return only ads of this business/shop account (the `seller.business_id` on rows posted by a registered premise).
- `buyer_protection_only` (boolean, optional, default false) — True returns only ads sold with Sbazar's buyer protection. A small slice of the catalogue (measured 28 ads site-wide on 2026-09-30).
- `orderable_only` (boolean, optional, default false) — True returns only ads that can be ordered and paid through Sbazar rather than arranged with the seller (26 ads site-wide, measured).
- `page` (integer, optional, default 1) — 1-based page. Sbazar's paging window is 10 000 rows, so page x page_size must stay at or below that; beyond it the source answers HTTP 422 and this engine rejects the request.
- `page_size` (integer, optional, default 20) — Ads per page, 1-100.

**Returns:** query/category echo, total_results, page, page_size, has_more and listings[] with listing_id, url, title, price, price_currency, price_kind (fixed|zero|by_agreement|absent), price_raw (the source's own integer), image, category_id, category, category_seo_name, locality{municipality, quarter, district, region, zip, …}, posted_date, updated_date, promoted, is_reserved, buyer_protection, is_orderable, source, phone_obfuscated, dont_show_phone and seller{user_id, shop_name, shop_url, shop_page, verification, portrait_url, unique_url, is_business, business_id, business_name}.

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

### POST https://api.reefapi.com/sbazar/v1/listing — 1 credit
Full detail of one Sbazar ad: complete description, every photo, price, locality, category, status and the seller's public shop identity. Accepts the ad URL or the numeric listing_id. The ad text is returned as written (contacts typed into it included); Sbazar's API does not publish the seller's phone number itself.

**Parameters:**
- `listing_id` (string, optional) — Numeric ad id, as `search` returns it in `listing_id`. Give this OR `url` — at least one is required.
- `url` (string, optional) — Full Sbazar ad address, exactly as `search` returns it. The ad id is read out of it. Give this OR `listing_id`.

**Returns:** everything `search` returns for a row, plus description, images[], image_count, video_count, status, valid_to and price_original.

**Example request body:**
```json
{
  "url": "https://www.sbazar.cz/dan.mlynar/detail/234318630-apple-iphone-16-pro"
}
```

### POST https://api.reefapi.com/sbazar/v1/categories — 1 credit
Sbazar's live category tree — 451 categories over 3 levels, each with the number of ads currently filed under it. This is the resolver `search` needs: a numeric category_id is what the search filter takes. With a `category_id` it returns that category plus its direct children.

**Parameters:**
- `category_id` (string, optional) — Sbazar category, given either as its numeric id (237) or as its SEO slug ('237-iphone', or plain 'iphone'). A parent category includes every descendant (measured: id 1 'Auto-moto' returns ads filed under its child categories). Call `categories` for the live list. Omit to get the whole 451-node tree.

**Returns:** total_categories and categories[] with category_id, name, seo_name, level, parent_id, listing_count and url; with a category_id, also category{} and children[].

**Example request body:**
```json
{
  "category_id": "237"
}
```

## 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=sbazar
- Human docs page: https://reefapi.com/docs/sbazar
- Overview page: https://reefapi.com/sbazar-api
- Every ReefAPI API in one file (for your AI): https://reefapi.com/llms-full.txt
