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

Bazos API & Scraper: parameters and responses

This is the reference for the 3 Bazos endpoints under /bazos/v1 (search, listing and categories) and their 12 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.

Bazos API returns live Bazos data as clean JSON for bazos The primary endpoint, search, returns market, currency, query/category/subcategory echo, total_results (+ the source's own printed string), page, page_size, has_more, and list….

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 Bazos 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/bazos/v1/search",
  "headers": {
    "x-api-key": "$REEF_KEY",
    "content-type": "application/json"
  },
  "body": {
    "market": "cz",
    "query": "iphone"
  }
}
Captured response
{
  "ok": true,
  "meta": {
    "api": "bazos",
    "endpoint": "search",
    "mode": "live",
    "latency_ms": 1119.1,
    "record_count": 40,
    "bytes": 83056,
    "cache_hit": false,
    "source_url": "https://www.bazos.cz/search.php?hledat=iphone&rubriky=www&hlokalita=&humkreis=25&cenaod=&cenado=",
    "source_range": "1-40",
    "promoted_count": 40,
    "sort_drops_unpriced_ads": false,
    "filters_verified": null,
    "next_page": 2,
    "charged_credits": 1,
    "version": "1.0.1",
    "request_id": "9dd1c4dcf334478f",
    "queue_ms": 1.2,
    "fetched_at": "2026-11-03T17:31:59.834Z"
  },
  "data": {
    "market": "cz",
    "currency": "CZK",
    "query": "iphone",
    "category": null,
    "subcategory": null,
    "sort": "newest",
    "total_results": 7595,
    "total_results_text": "7 595",
    "page": 1,
    "page_size": 20,
    "has_more": true,
    "listings": [
      {
        "listing_id": "224806153",
        "url": "https://mobil.bazos.cz/inzerat/224806153/iphone-16-pro-1-tb-bily.php",
        "title": "IPhone 16 PRO MAX 512GB zánovní",
        "description_excerpt": "Telefon je nový, nepoužívaný, pouze rozbalený a odzkoušený",
        "image": "https://www.bazos.cz/img/1t/153/224806153.jpg?t=1793691901",
        "price": 23500,
        "price_currency": "CZK",
        "price_kind": "fixed",
        "price_text": "23 500 Kč",
        "locality": "Hradec Králové",
        "postal_code": "504 01",
        "views": 265,
        "posted_date": "2026-11-03",
        "promoted": true,
        "promoted_label": "TOP 5x Platí do 28.11. 2026",
        "category": "mobil"
      },
      {
        "listing_id": "225093108",
        "url": "https://auto.bazos.cz/inzerat/225093108/audi-rs6-c8-441kwservis-audibodrcrs-dynamic-pluszaruka.php",
        "title": "AUDI RS6 C8 441KW,SERVIS AUDI,B&O,DRC,RS DYNAMIC PLUS,ZÁRUKA",
        "description_excerpt": "Prodám Audi RS6 C8 4.0 TFSI 441KW. Koupeno nové v ČR. Model: 2022, Najeto: 91 000 km. Vůz má kompletní servisní historii z Audi a dohledatelný původ v ČR. Vozidlo polepeno ochrannou PPF folii. Záruka u Audi: 11/2026 Auto není odpočtové. Kontakt: [redacted-phone] K vozu jsou 2 klíče. Vůz ...",
        "image": "https://www.bazos.cz/img/1t/108/225093108.jpg?t=1792050749",
        "price": 1699999,
        "price_currency": "CZK",
        "price_kind": "fixed",
        "price_text": "1 699 999 Kč",
        "locality": "Praha 1",
        "postal_code": "110 00",
        "views": 6841,
        "posted_date": "2026-11-03",
        "promoted": true,
        "promoted_label": "TOP 21x Platí do 25.11. 2026",
        "category": "auto"
      },
      {
        "listing_id": "225937513",
        "url": "https://sluzby.bazos.cz/inzerat/225937513/aktivace-apple-car-play-android-auto-vw-skoda-audi-seat.php",
        "title": "Aktivace apple car play, android auto, VW, Škoda, Audi, Seat",
        "description_excerpt": "Nabízím aktivaci App Connect ( Android Auto, Apple CarPlay ) pro vozy Volkswagen, Škoda, Seat a Audi. Pro VŠECHNY radia: MIB 2 - s navigací i bez navigace MIB 3 - s navigací i bez navigace Swing - s navigací i bez navigace Delphi - s navigací i bez navigace Aktivace při vyskakující hlášc ...",
        "image": "https://www.bazos.cz/img/1t/513/225937513.jpg?t=1793692361",
        "price": 2500,
        "price_currency": "CZK",
        "price_kind": "fixed",
        "price_text": "2 500 Kč",
        "locality": "Semily",
        "postal_code": "512 45",
        "views": 25,
        "posted_date": "2026-11-03",
        "promoted": true,
        "promoted_label": "TOP 4x Platí do 25.11. 2026",
        "category": "sluzby"
      }
    ]
  }
}
Actions

What the Bazos API does

ActionDescriptionConcrete use caseKey params
searchSearch 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.Price-intelligence teams call search to search Bazos classifieds by keyword and/or category, with subcategory, postal-code radius, pr….market, query, category, subcategory, sort, ...
listingFull 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.Classifieds aggregators call listing to get full detail of one Bazos ad.market, url, listing_id, category
categoriesThe 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.Resale and arbitrage tools call categories to get the market's own category tree.market, category
Code samples

Call search from your stack

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

Who uses this API and why

  • Price-intelligence teams use Bazos to search Bazos classifieds by keyword and/or category, with subcategory, postal-code radius, pr….
  • Classifieds aggregators use Bazos to get full detail of one Bazos ad.
  • Resale and arbitrage tools use Bazos to get the market's own category tree.
FAQ

Questions developers ask before integrating

What is the Bazos API?

Bazos API is a ReefAPI endpoint group for bazos It returns live JSON through POST requests under /bazos/v1.

Is the Bazos API free to try?

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

Do I need a Bazos login or account?

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

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

Can I call Bazos from an AI assistant or MCP client?

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

Is the Bazos API a Bazos scraper?

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

Why does my Bazos scraper keep getting blocked?

Most Bazos 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 / bazos

Bazos

Bazos

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

ParameterAllowed / rangeDescription
market = czoptionalcz · skWhich 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.
urloptional—Full Bazos ad address, exactly as `search` returns it. The simplest handle — it already carries the category and the market.
listing_idoptional—Numeric ad id. Needs `category` as well, because the category is the host of the address on Bazos. Prefer `url`.
categoryoptional—Rubrika slug that hosts the ad — required with `listing_id`, ignored when `url` is given.
Try in playground →
post/bazos/v1/categories1 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.

ParameterAllowed / rangeDescription
market = czoptionalcz · skWhich 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.
categoryoptional—Omit to list the market's 20 rubriky with their live totals; pass a rubrika slug to list ITS subcategories instead.
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.