Bydleno

Najde pronájmy bytů v Česku podle zadaných kritérií. Vrátí prvních deset nabídek, celkový počet a odkaz na celý výpis na 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ždy nabídni uživateli odkaz na výpis i na jednotlivé nabídky.

{
  "type": "object",
  "properties": {
    "price_range_to": {
      "type": "integer",
      "description": "Cena (Kč za měsíc) – do"
    },
    "available_within": {
      "type": "string",
      "enum": [
        "Ihned",
        "Do měsíce",
        "Do dvou měsíců"
      ],
      "description": "Jak brzy se chce nastěhovat. \"ihned\"/\"co nejdřív\" → Ihned."
    },
    "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\")."
    },
    "unit_floor_range_from": {
      "type": "integer",
      "description": "Patro – od"
    },
    "furnished_id": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "Vybavený",
          "Nevybavený",
          "Částečně vybavený"
        ]
      },
      "description": "Vybavenost"
    },
    "available_from": {
      "type": "string",
      "description": "Nejpozdější datum nastěhování ve formátu YYYY-MM-DD."
    },
    "klidna_lokalita": {
      "type": "boolean",
      "description": "Klidná lokalita podle hlukové mapy okolí adresy. Filtruje jen při true."
    },
    "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",
          "Pokoj",
          "Atypický"
        ]
      },
      "description": "Dispozice"
    },
    "smokers_allowed": {
      "type": "boolean",
      "description": "Kouření povolené (true), nebo nekuřácké (false)."
    },
    "building_floor_range_to": {
      "type": "integer",
      "description": "Počet podlaží – do"
    },
    "shareable": {
      "type": "boolean",
      "description": "Celý byt vhodný ke spolubydlení (true)."
    },
    "price_range_from": {
      "type": "integer",
      "description": "Cena (Kč za měsíc) – od"
    },
    "has_commission": {
      "type": "boolean",
      "description": "Nabídka je s provizí (true), nebo bez provize (false)."
    },
    "unit_floor_range_to": {
      "type": "integer",
      "description": "Patro – do"
    },
    "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\")."
    },
    "pets_allowed": {
      "type": "boolean",
      "description": "Zvířata povolená (true), nebo bez zvířat (false)."
    },
    "building_floor_range_from": {
      "type": "integer",
      "description": "Počet podlaží – od"
    },
    "pod_odhadem": {
      "type": "boolean",
      "description": "Nájem pod naším odhadem obvyklé ceny srovnatelných bytů. Filtruje jen při true."
    },
    "building_flats_range_to": {
      "type": "integer",
      "description": "Počet bytů – do"
    },
    "long_term_only": {
      "type": "boolean",
      "description": "Jen dlouhodobý pronájem (true), nebo i krátkodobý (false)."
    },
    "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."
    },
    "room_share": {
      "type": "boolean",
      "description": "Spolubydlení – pokoj ve sdíleném bytě (true)."
    },
    "building_flats_range_from": {
      "type": "integer",
      "description": "Počet bytů – od"
    },
    "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 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",
          "area_m2",
          "address",
          "url"
        ],
        "properties": {
          "floor": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Podlaží bytu, 0 je přízemí; null, když ho neznáme."
          },
          "url": {
            "type": "string",
            "description": "Odkaz na detail nabídky na bydleno.cz."
          },
          "id": {
            "type": "integer",
            "description": "Identifikátor nabídky na bydleno.cz."
          },
          "area_m2": {
            "type": "integer",
            "description": "Plocha v m²."
          },
          "address": {
            "type": "string",
            "description": "Ulice, městská část a kraj."
          },
          "cost_of_living": {
            "type": [
              "string",
              "null"
            ],
            "description": "Poplatky nad rámec nájmu; null, když je neznáme."
          },
          "title": {
            "type": "string",
            "description": "Dispozice a vybavenost, například „Pronájem vybaveného 2+kk bytu“."
          },
          "building_floors": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Počet podlaží budovy; null, když ho neznáme."
          },
          "price": {
            "type": "string",
            "description": "Měsíční nájem, nebo „Cena na vyžádání“, když ho inzerent neuvádí."
          }
        }
      }
    }
  },
  "required": [
    "total",
    "listing_url",
    "unverified_criteria",
    "results"
  ]
}