Reef AI: ask for any data. Try it
This page is the Sbazar.cz parameter reference. What the data is used for, a real sample and pricing are on Sbazar.cz API: what you get →
Classifieds & Second-hand

Sbazar.cz API & Scraper: parameters and responses

This is the reference for the 3 Sbazar.cz endpoints under /sbazar/v1 (search, listing and categories) and their 13 parameters. Each endpoint lists its parameters, required or optional, with allowed values and defaults, and comes with a cURL, Python and JavaScript call; every response uses the same { ok, data, meta, error } envelope.

Sbazar.cz API returns live Sbazar.cz data as clean JSON for sbazar.cz The primary endpoint, search, returns query/category echo, total_results, page, page_size, has_more and listings[] with listing_id, url, title, price, price_currency, price_ki….

3 actionsLive JSON1,000 free credits$0.67–$1.50 / 1,000 creditsMCP-ready
Get a free keyOpen in playground

🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.

Developers reach for it when they need to read second-hand listings, asking prices, seller inventory and country-specific listing ids without maintaining one-off scraping code or separate API contracts. If you were about to build or fix a Sbazar.cz scraper, this API is the maintained alternative — it returns the same data as clean JSON, with the proxies, rotation and anti-bot handling already solved. This page covers the live example, request shape, response shape and available actions: search, listing, categories. Every request uses the same ReefAPI envelope, one API key and one shared credit pool, so it fits alongside the rest of your data stack.

Live example

Real request and response JSON

Captured from the indexed primary action, search, on .

Captured request
{
  "method": "POST",
  "url": "https://api.reefapi.com/sbazar/v1/search",
  "headers": {
    "x-api-key": "$REEF_KEY",
    "content-type": "application/json"
  },
  "body": {
    "query": "iphone"
  }
}
Captured response
{
  "ok": true,
  "meta": {
    "api": "sbazar",
    "endpoint": "search",
    "mode": "live",
    "latency_ms": 1008.9,
    "record_count": 20,
    "bytes": 25760,
    "cache_hit": false,
    "source_url": "https://www.sbazar.cz/api/v1/items/search?phrase=iphone&limit=20&offset=0",
    "filters_verified": null,
    "promoted_count": 7,
    "paging_window": 10000,
    "next_page": 2,
    "charged_credits": 1,
    "version": "1.0.1",
    "request_id": "1b48ee5d33f5424a",
    "queue_ms": 3.5,
    "fetched_at": "2026-11-03T17:32:12.425Z"
  },
  "data": {
    "query": "iphone",
    "category_id": null,
    "sort": "relevance",
    "total_results": 3670,
    "page": 1,
    "page_size": 20,
    "has_more": true,
    "listings": [
      {
        "listing_id": "234260046",
        "url": "https://www.sbazar.cz/schano/detail/234260046-iphone-16-pro-max-1-tb",
        "title": "Iphone 16 pro max 1 TB",
        "price": 25000,
        "price_currency": "CZK",
        "price_kind": "fixed",
        "price_raw": 25000,
        "category_id": 237,
        "category": "iPhone",
        "category_seo_name": "237-iphone",
        "locality": {
          "municipality": "Třebívlice",
          "municipality_id": 1933,
          "quarter": null,
          "district": "Litoměřice",
          "district_id": 23,
          "region": "Ústecký kraj",
          "region_id": 4,
          "street": null,
          "zip": null
        },
        "posted_date": "2026-09-24T00:23:42",
        "updated_date": "2026-11-03T18:17:21",
        "promoted": true,
        "is_reserved": false,
        "buyer_protection": false,
        "is_orderable": false,
        "source": "web_source",
        "seller": {
          "user_id": 4665948,
          "shop_name": null,
          "shop_url": "schano",
          "shop_page": "https://www.sbazar.cz/schano",
          "verification": null,
          "portrait_url": null,
          "unique_url": null,
          "is_business": false,
          "business_id": null,
          "business_name": null
        },
        "phone_obfuscated": null,
        "dont_show_phone": null,
        "image": "https://d46-a.sdn.cz/d_46/c_img_qF_B/nOdL4BtPEyBFnmYCoiH2vNYs/8311.jpeg",
        "description": null
      },
      {
        "listing_id": "235513944",
        "url": "https://www.sbazar.cz/dobrezbozi2/detail/235513944-apple-iphone-16e-128gb",
        "title": "Apple iPhone 16e 128GB",
        "price": 11000,
        "price_currency": "CZK",
        "price_kind": "fixed",
        "price_raw": 11000,
        "category_id": 237,
        "category": "iPhone",
        "category_seo_name": "237-iphone",
        "locality": {
          "municipality": "Plzeň",
          "municipality_id": 1243,
          "quarter": "Plzeň 2-Slovany",
          "district": "Plzeň-město",
          "district_id": 12,
          "region": "Plzeňský kraj",
          "region_id": 2,
          "street": null,
          "zip": "326 00"
        },
        "posted_date": "2026-11-03T18:01:04",
        "updated_date": "2026-11-03T18:02:20",
        "promoted": false,
        "is_reserved": false,
        "buyer_protection": false,
        "is_orderable": false,
        "source": "web_source",
        "seller": {
          "user_id": 206724312,
          "shop_name": null,
          "shop_url": "dobrezbozi2",
          "shop_page": "https://www.sbazar.cz/dobrezbozi2",
          "verification": null,
          "portrait_url": null,
          "unique_url": null,
          "is_business": false,
          "business_id": null,
          "business_name": null
        },
        "phone_obfuscated": null,
        "dont_show_phone": null,
        "image": "https://d46-a.sdn.cz/d_46/c_img_qH_A/nQO0xPd86TDi9WNDcwKIQlbqD/95ce.jpeg",
        "description": null
      },
      {
        "listing_id": "235514007",
        "url": "https://www.sbazar.cz/dobrezbozi2/detail/235514007-apple-iphone-12-mini-64gb",
        "title": "Apple iPhone 12 mini 64GB",
        "price": 4190,
        "price_currency": "CZK",
        "price_kind": "fixed",
        "price_raw": 4190,
        "category_id": 237,
        "category": "iPhone",
        "category_seo_name": "237-iphone",
        "locality": {
          "municipality": "Plzeň",
          "municipality_id": 1243,
          "quarter": "Plzeň 2-Slovany",
          "district": "Plzeň-město",
          "district_id": 12,
          "region": "Plzeňský kraj",
          "region_id": 2,
          "street": null,
          "zip": "326 00"
        },
        "posted_date": "2026-11-03T18:02:32",
        "updated_date": "2026-11-03T18:03:18",
        "promoted": false,
        "is_reserved": false,
        "buyer_protection": false,
        "is_orderable": false,
        "source": "web_source",
        "seller": {
          "user_id": 206724312,
          "shop_name": null,
          "shop_url": "dobrezbozi2",
          "shop_page": "https://www.sbazar.cz/dobrezbozi2",
          "verification": null,
          "portrait_url": null,
          "unique_url": null,
          "is_business": false,
          "business_id": null,
          "business_name": null
        },
        "phone_obfuscated": null,
        "dont_show_phone": null,
        "image": "https://d46-a.sdn.cz/d_46/c_img_qH_A/nQO0xPd86Tw5RPIkS6IQldxw/9aa2.jpeg",
        "description": null
      }
    ]
  }
}
Actions

What the Sbazar.cz API does

ActionDescriptionConcrete use caseKey params
searchSearch 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.Price-intelligence teams call search to search Sbazar classifieds by keyword and/or category, with a CZK price band, seller/shop filt….query, category_id, price_min, price_max, sort, ...
listingFull 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.Classifieds aggregators call listing to get full detail of one Sbazar ad.listing_id, url
categoriesSbazar'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.Resale and arbitrage tools call categories to get sbazar's live category tree.category_id
Code samples

Call search from your stack

curl -X POST https://api.reefapi.com/sbazar/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"iphone"}'
MCP one-liner
Ask your MCP-connected assistant: call reefapi.sbazar.search with {"query":"iphone"}.
Use cases

Who uses this API and why

  • Price-intelligence teams use Sbazar.cz to search Sbazar classifieds by keyword and/or category, with a CZK price band, seller/shop filt….
  • Classifieds aggregators use Sbazar.cz to get full detail of one Sbazar ad.
  • Resale and arbitrage tools use Sbazar.cz to get sbazar's live category tree.
FAQ

Questions developers ask before integrating

What is the Sbazar.cz API?

Sbazar.cz API is a ReefAPI endpoint group for sbazar.cz It returns live JSON through POST requests under /sbazar/v1.

Is the Sbazar.cz API free to try?

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

Do I need a Sbazar.cz login or account?

No login to Sbazar.cz 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 Sbazar.cz 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 Sbazar.cz API use?

Sbazar.cz actions currently cost 1 credit per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.

Can I call Sbazar.cz from an AI assistant or MCP client?

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

Is the Sbazar.cz API a Sbazar.cz scraper?

It is the managed alternative to a DIY Sbazar.cz 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 sbazar.cz back as clean JSON.

Why does my Sbazar.cz scraper keep getting blocked?

Most Sbazar.cz scrapers break on anti-bot defenses, rate limits and IP bans that need rotating residential proxies and browser fingerprinting to clear. ReefAPI handles all of that for you — no proxies, no captchas, no maintenance — and returns live JSON. Blocked calls are free.

docs / sbazar

Sbazar.cz

Sbazar.cz

base /sbazar/v13 endpoints
post/sbazar/v1/listing1 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.

ParameterAllowed / rangeDescription
listing_idoptional—Numeric ad id, as `search` returns it in `listing_id`. Give this OR `url` — at least one is required.
urloptional—Full Sbazar ad address, exactly as `search` returns it. The ad id is read out of it. Give this OR `listing_id`.
Try in playground →
post/sbazar/v1/categories1 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.

ParameterAllowed / rangeDescription
category_idoptional—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.
Try in playground →
Built for volume
5M+ requests a day

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.

Missing a source?
We build it

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.

Support
2 minute median reply

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.

One key, one balance
Every API included

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.