Bydleno – prodej bytů

Najde byty na prodej v Česku podle zadaných kritérií. Vrátí prvních deset nabídek, celkový počet a odkaz na celý výpis na za.bydleno.cz. Všechny parametry jsou volitelné a bez nich dostaneš nejnovější nabídky; zadávej jen ta kritéria, která uživatel řekl. Nejčastěji stačí location_texts, layout_id a price_range_to. Hodnoty výčtů piš přesně jako popisky ze schématu ("2+kk", "Vybavený"); hodnotu mimo výčet i neznámý parametr zahodíme. Místa (kraje, okresy, obce, městské části, čtvrti, ulice, adresy) předávej česky v 1. pádě v poli location_texts ("Praha 1", ne "Prague 1"), nejvýš deset; místo, které nerozpoznáme, hledáme v textu inzerátu. Když nic neodpovídá, vrátí nulový počet a odkaz na výpis; když hledání selže, vrátí isError a text chyby. Výpis je zdarma, celý detail nabídky je placený (199 Kč za 30 dní přístupu ke všem prodejům). Vždy nabídni uživateli odkaz na výpis i na jednotlivé nabídky.

{
  "type": "object",
  "properties": {
    "share_of_flat": {
      "type": "boolean",
      "description": "Jen podíl na bytě (true), nebo jen celý byt (false)."
    },
    "price_range_to": {
      "type": "integer",
      "description": "Cena (Kč) – do"
    },
    "penb": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "A – Mimořádně úsporná",
          "B – Velmi úsporná",
          "C – Úsporná",
          "D – Méně úsporná",
          "E – Nehospodárná",
          "F – Velmi nehospodárná",
          "G – Mimořádně nehospodárná"
        ]
      },
      "description": "PENB – energetický štítek budovy."
    },
    "ground_floor": {
      "type": "boolean",
      "description": "Přízemí – chci přízemí (true), nechci přízemí (false)."
    },
    "nearby_place_from_type_id": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "Bar",
          "Kasino",
          "Čerpací stanice",
          "Vlakové nádraží",
          "Restaurace",
          "Zastávka",
          "Nemocnice"
        ]
      },
      "description": "Daleko od vybraného typu místa (\"daleko od baru, benzínky\")."
    },
    "price_per_m2_range_from": {
      "type": "integer",
      "description": "Cena za m² (Kč) – od"
    },
    "unit_floor_range_from": {
      "type": "integer",
      "description": "Patro – od"
    },
    "furnished_id": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "Vybavený",
          "Nevybavený",
          "Částečně vybavený"
        ]
      },
      "description": "Vybavenost"
    },
    "klidna_lokalita": {
      "type": "boolean",
      "description": "Klidná lokalita podle hlukové mapy okolí adresy. Filtruje jen při true."
    },
    "price_per_m2_range_to": {
      "type": "integer",
      "description": "Cena za m² (Kč) – do"
    },
    "condition": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "Velmi dobrý",
          "Dobrý",
          "Špatný",
          "Ve výstavbě",
          "Projekt",
          "Novostavba",
          "K demolici",
          "Před rekonstrukcí",
          "Po rekonstrukci",
          "V rekonstrukci"
        ]
      },
      "description": "Stav"
    },
    "location_texts": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Názvy míst v základním tvaru (1. pád) – např. \"Brno\" (ne \"Brně\"), \"Praha 1\", \"Vinohrady\", \"Vinohradská\". Patří sem názvy krajů, okresů, měst a obcí, městských částí, čtvrtí, katastrálních území, ulic i adres – i těch, které neznáš."
    },
    "layout_id": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "1+kk",
          "1+1",
          "2+kk",
          "2+1",
          "3+kk",
          "3+1",
          "4+kk",
          "4+1",
          "5+kk",
          "5+1",
          "6 a více",
          "Atypický"
        ]
      },
      "description": "Dispozice"
    },
    "building_floor_range_to": {
      "type": "integer",
      "description": "Počet podlaží – do"
    },
    "price_range_from": {
      "type": "integer",
      "description": "Cena (Kč) – od"
    },
    "unit_floor_range_to": {
      "type": "integer",
      "description": "Patro – do"
    },
    "auction": {
      "type": "boolean",
      "description": "Dražba nebo aukce – chci jen dražby (true), nechci dražby (false)."
    },
    "keywords": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Ve většině dotazů zůstává prázdné. Jen slovo, které uživatel sám napsal, popisuje konkrétní vlastnost bytu, nemá vlastní pole a čekáš, že ho majitel napsal i v popisu inzerátu. Slovo, kterému nerozumíš, překlep ani zbytek sousloví sem nepatří – ty dej do unsupported; název místa patří do location_texts."
    },
    "amenities": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "Balkon",
          "Garáž",
          "Sklep",
          "Výtah",
          "Vnitroblok",
          "Výhled do zeleně",
          "Vana",
          "Recepce",
          "Sauna",
          "Sprchový kout",
          "Klimatizace",
          "Rekuperace",
          "Pračka",
          "Sušička",
          "Myčka",
          "TV",
          "Krb",
          "Žaluzie",
          "Bezpečnostní systém",
          "Podlahové topení"
        ]
      },
      "description": "Vybavení a příslušenství bytu, které uživatel chce (balkon, garáž, sklep, výtah, pračka, myčka, klimatizace…). \"vnitroblok\" znamená byt orientovaný okny do klidného vnitrobloku, ne do ulice. Vyber jen ta, která uživatel zmínil."
    },
    "area_range_from": {
      "type": "integer",
      "description": "Plocha (m²) – od"
    },
    "bezpecna_lokalita": {
      "type": "boolean",
      "description": "Bezpečná lokalita podle dat o kriminalitě v okolí adresy. Filtruje jen při true."
    },
    "last_floor": {
      "type": "boolean",
      "description": "Poslední patro – chci (true), nechci (false)."
    },
    "nearby_place_distance_from": {
      "type": "string",
      "enum": [
        "100 m",
        "200 m",
        "300 m",
        "400 m",
        "500 m",
        "1 km"
      ],
      "description": "Nejméně jak daleko musí být nechtěné místo."
    },
    "nearby_place_to_type_id": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "Zastávka",
          "Metro",
          "Vlakové nádraží",
          "Restaurace",
          "Pekárna",
          "Supermarket",
          "Večerka",
          "Bar",
          "Kasino",
          "Lékárna",
          "Nemocnice",
          "Posilovna",
          "Bankomat",
          "Pošta",
          "Výdejní boxy",
          "Škola",
          "Kino",
          "Veterinární klinika",
          "Čerpací stanice"
        ]
      },
      "description": "Poblíž vybraného typu místa (\"chci to blízko restaurace, metra\")."
    },
    "building_floor_range_from": {
      "type": "integer",
      "description": "Počet podlaží – od"
    },
    "building_flats_range_to": {
      "type": "integer",
      "description": "Počet bytů – do"
    },
    "area_range_to": {
      "type": "integer",
      "description": "Plocha (m²) – do"
    },
    "svetly_byt": {
      "type": "boolean",
      "description": "Světlý byt podle naší analýzy fotek inzerátu. Filtruje jen při true."
    },
    "building_flats_range_from": {
      "type": "integer",
      "description": "Počet bytů – od"
    },
    "ownership": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "Osobní vlastnictví",
          "Družstevní vlastnictví"
        ]
      },
      "description": "Vlastnictví"
    },
    "cardinal_directions": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "Sever",
          "Severovýchod",
          "Východ",
          "Jihovýchod",
          "Jih",
          "Jihozápad",
          "Západ",
          "Severozápad"
        ]
      },
      "description": "Světová strana"
    },
    "nearby_place_distance_to": {
      "type": "string",
      "enum": [
        "100 m",
        "200 m",
        "300 m",
        "400 m",
        "500 m",
        "1 km"
      ],
      "description": "Nejvýš jak daleko smí být blízké místo."
    }
  }
}

{
  "type": "object",
  "properties": {
    "total": {
      "type": "integer",
      "description": "Kolik nabídek kritériím odpovídá celkem, ne jen v results."
    },
    "listing_url": {
      "type": "string",
      "description": "Odkaz na celý výpis na za.bydleno.cz se stejnými filtry."
    },
    "unverified_criteria": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Kritéria, u kterých výpis pouští i nabídky s chybějícím údajem. U nich neplatí, že je vlastnost doložená — neříkej to uživateli jako fakt."
    },
    "results": {
      "type": "array",
      "description": "Prvních deset nabídek.",
      "items": {
        "type": "object",
        "required": [
          "id",
          "title",
          "price",
          "auction",
          "partial_price",
          "remaining_payment",
          "area_m2",
          "address",
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "description": "Odkaz na detail nabídky na za.bydleno.cz. Výpis je zdarma, celý detail je placený."
          },
          "id": {
            "type": "integer",
            "description": "Identifikátor nabídky na za.bydleno.cz."
          },
          "area_m2": {
            "type": "integer",
            "description": "Plocha v m²."
          },
          "remaining_payment": {
            "type": [
              "string",
              "null"
            ],
            "description": "Doplatek k uvedené ceně přečtený z popisu inzerátu, zaokrouhlený na desetiny milionu Kč, jak ho ukazuje karta nabídky (např. „4,7 mil.“). Jen u partial_price remaining_payment a jen když se na částce shodne každý model, který ji z popisu přečetl; jinak null."
          },
          "address": {
            "type": "string",
            "description": "Ulice, městská část a kraj."
          },
          "price_per_m2": {
            "type": [
              "string",
              "null"
            ],
            "description": "Cena za m²; null, když neznáme cenu nebo plochu, nebo když cena není celá (partial_price)."
          },
          "partial_price": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "share_of_flat",
              "remaining_payment",
              null
            ],
            "description": "Proč uvedená cena není celá: share_of_flat – cena je jen za podíl na bytě, ne za celý byt; remaining_payment – k ceně se platí ještě doplatek, například nesplacená anuita. null, když je cena celá."
          },
          "auction": {
            "type": "boolean",
            "description": "Byt se prodává v dražbě nebo aukci; o konečné ceně rozhodne aukce."
          },
          "title": {
            "type": "string",
            "description": "Dispozice, například „Prodej 2+kk bytu“."
          },
          "price": {
            "type": "string",
            "description": "Celková cena, nebo „Cena na vyžádání“, když ji inzerent neuvádí. U dražby je to vyvolávací cena, u neúplné ceny viz partial_price."
          }
        }
      }
    }
  },
  "required": [
    "total",
    "listing_url",
    "unverified_criteria",
    "results"
  ]
}