Bazoš API: inzeráty z bazos.cz jako JSON

Inzeráty z Bazoše tu dostanete ve stejném rozsahu, jaký vidí nepřihlášený návštěvník: titulek, cenu v Kč, lokalitu s PSČ, počet zobrazení, datum vložení, fotky a celý text inzerátu. Hledat se dá v celém Bazoši, v jedné rubrice (auto, deti, reality, mobil…) i v podrubrice, a hlavně v okruhu kolem PSČ: tedy „kočárek do 25 km od Brna“, ne kočárky z celé republiky. Nejde o nástroj na hromadné vkládání ani správu vlastních inzerátů (moje inzeráty): čte se jen to, co je na Bazoši veřejně vidět. Slovenský bazos.sk obslouží stejný engine s `market: "sk"`, s cenami v eurech.

Funkční příklad

Okruh 25 km kolem PSČ 602 00 (Brno) zúžil výsledky hledání „kočárek“ z 8 724 na 666. Engine k tomu pošle i stejný dotaz bez PSČ a obě čísla vrátí ve `filters_verified`. Důvod: neznámé PSČ Bazoš bez varování přeskočí a vrátí celou republiku, takže filtr je potřeba ověřit. Prvních 6 řádků z 20 tvoří placené TOP inzeráty (`promoted_label` „TOP 5x Platí do 13.11. 2026“). Do průměrné ceny je buď započítejte vědomě, nebo je vyřaďte.

curl -X POST https://api.reefapi.com/bazos/v1/search \
  -H "x-api-key: VAS_KLIC" \
  -H "content-type: application/json" \
  -d '{"market": "cz", "query": "kočárek", "postal_code": "60200", "radius_km": 25}'

{
  "ok": true,
  "data": {
    "market": "cz",
    "currency": "CZK",
    "query": "kočárek",
    "sort": "newest",
    "total_results": 666,
    "page": 1,
    "page_size": 20,
    "has_more": true,
    "listings": [
      {
        "listing_id": "225312502",
        "url": "https://deti.bazos.cz/inzerat/225312502/kocarek-cybex.php",
        "title": "Kočárek CYBEX Priam",
        "price": 17500,
        "price_currency": "CZK",
        "price_kind": "fixed",
        "price_text": "17 500 Kč",
        "locality": "Vyškov",
        "postal_code": "684 01",
        "views": 437,
        "posted_date": "2026-10-24",
        "promoted": true,
        "promoted_label": "TOP 5x Platí do 13.11. 2026",
        "category": "deti"
      },
      ...
      {
        "listing_id": "225510171",
        "url": "https://deti.bazos.cz/inzerat/225510171/inglesina-aptica-xt.php",
        "title": "Inglesina Aptica XT",
        "description_excerpt": "Prodám kočárek značky Inglesina Aptica XT zakoupený v březnu 2023, po jednom dítěti. ...",
        "price": 12500,
        "price_currency": "CZK",
        "price_kind": "fixed",
        "price_text": "12 500 Kč",
        "locality": "Brno",
        "postal_code": "639 00",
        "views": 11,
        "posted_date": "2026-10-24",
        "promoted": false,
        "promoted_label": null,
        "category": "deti"
      },
      ...
    ]
  },
  "meta": {
    "record_count": 20,
    "promoted_count": 6,
    "sort_drops_unpriced_ads": false,
    "filters_verified": { "postal_code": { "control_total": 8724, "filtered_total": 666, "applied": true } },
    "next_page": 2,
    "cache_hit": false,
    "mode": "live"
  }
}

Omezení a poctivé poznámky

• Jde o neoficiální přístup: Bazoš za ním nestojí a nemáme s ním uzavřenou žádnou dohodu.
• Telefon prodejce engine nikdy nenačítá. Běžně zapsaná telefonní čísla a e-maily, které prodejce napíše do popisu, se v každé odpovědi nahrazují značkou „[phone removed]“ nebo „[email removed]“. Z údajů o prodejci se vrací jen veřejně zobrazené jméno.
• Cena napsaná slovem není nula: „Dohodou“, „Nabídněte“ a „V textu“ vrací `price: null` s původním textem v `price_text`; „Zdarma“ je 0 s `price_kind: "free"`. Řazení podle ceny takové inzeráty vyřadí (to dělá sám Bazoš) a celkový počet se zmenší; `meta.sort_drops_unpriced_ads` to oznámí.
• Bazoš nemá pole pro stav zboží, dopravu ani hodnocení prodejce, takže je nevracíme. Desetinné ceny Bazoš nezná.
• Řádky z hledání napříč Bazošem nesou jen rubriku (je součástí adresy), ne podrubriku. Podrubriku zjistíte z drobečkové navigace v `listing`.
• Stránkovat jde nejvýš do 500. stránky: dál Bazoš sice odpovídá, ale jen opakuje konec výpisu.
• Odkaz na inzerát zestárne, jakmile ho prodejce smaže. Pak `listing` vrátí NOT_FOUND.