Projects
List and search /projekt/list
Executes a search and returns basic information of matching projects. The project must be active, "Show on Homepage" flag must be true, and it must have at least one active realty booked into the api feed. Filter parameters are applied to the realties of the project, not the project data itself unless otherwise noted.
Parameters
- limit
-
How many elements should be returned in the list. Max 100
Default: 25 - offset
-
Offset of the first element in the list.
Default: 0 - culture
-
Language for i18n fields
Default: de - orderby
- Order results by specific field. Applied to project, not to realties of project. Supported values are created_at, updated_at
- ordertype
-
Order direction. Supported values are asc or desc
Default: asc - alle
-
Show all projects regardless if active realties are present in project: ?alle=1
Default: 0 - alleProjektObjekte
-
Show all realties with projects regardless of realty state: ?alleProjektObjekte=1
Default: 0 - picturesize
- The Picture Size to be used for picture urls. In combination with showDetails=1 it is also possible to request multiple sizes (e.g. picturesize[]=big&picturesize[]=small)
- showDetails
- Return all details of the realties instead of short summaries: ?showDetails=1
- objektIds
-
Return only realty ids instead of whole realty data in a project tag: ?objektIds=1
Default: 0 - filter[projekt_objektnummer]
- The realty number of the project.
- filter[preis_von]
- The min price. Depending on type it is the rent or purchase price.
- filter[preis_bis]
- The max price. Depending on type it is the rent or purchase price.
- filter[objektart_id]
- The Main Realty Type. Multiple values are supported by using an array notation: ?filter[objektart_id][]=1&filter[objektart_id][]=2
- filter[subobjektart_id]
- The Sub Realty Type. Multiple values are supported by using an array notation.
- filter[project_tag_name]
- The name of the category assigned to the project
- filter[tag_name]
- The name of the category assigned to realties
- filter[plz]
- The zip code
- filter[plz_von]
- The min zip code. Does not work for non-numerical zip codes.
- filter[plz_bis]
- The max zip code. Does not work for non-numerical zip codes.
- filter[zimmer_von]
- The min room count.
- filter[zimmer_bis]
- The max room count.
- filter[objektnummer]
- The realty number.
- filter[objektnummer_von]
- The min realty number.
- filter[objektnummer_bis]
- The max realty number.
- filter[flaeche_von]
- The min area in square meters.
- filter[flaeche_bis]
- The max area in square meters.
- filter[wohnflaeche_von]
- The min living area in square meters.
- filter[wohnflaeche_bis]
- The max living area in square meters.
- filter[nutzflaeche_von]
- The min floor area in square meters.
- filter[nutzflaeche_bis]
- The max floor area in square meters.
- filter[grundflaeche_von]
- The min surface area in square meters.
- filter[grundflaeche_bis]
- The max surface area in square meters.
- filter[stichwort]
- Keyword. Must be present in realty title, ZIP, city, street, object number or internal description.
- filter[bundesland_id]
- The id of the federal state. Multiple values are supported by using an array notation.
- filter[objekt_status_id]
- The Realty Status. Multiple values are supported by using an array notation.
- filter[miete]
- Set value to 1 to search for realties available for rent.
- filter[kauf]
- Set value to 1 to search for realties available for purchase.
- filter[owner_id]
- Id of the employee responsible for the realty
- filter[projekt_status]
- The project state. Value must be one of planning, building, finished.
- filter[referenz]
- Set value to 1 to search only for reference projects
- filter[fertigstellung_von]
- Completion date from.
- filter[fertigstellung_bis]
- Completion date to.
- filter[verkaufsstart_von]
- Sale start from date.
- filter[verkaufsstart_bis]
- Sale start to date.
Example
All active projects with realties booked into api feed.
https://api.justimmo.at/rest/v1/projekt/list
<?xml version="1.0" encoding="UTF-8"?>
<justimmo>
<query-result>
<count>2</count>
</query-result>
<projekt>
<id>46</id>
<titel>Demoprojekt in Zentrumsnähe</titel>
<beschreibung>Demoprojekt. Bitte nicht anfragen</beschreibung>
<dreizeiler></dreizeiler>
<strasse></strasse>
<hausnummer>2</hausnummer>
<plz>1030</plz>
<ort>Wien</ort>
<in_bau>1</in_bau>
<sonstige_angaben></sonstige_angaben>
<lage></lage>
<freitext_1></freitext_1>
<residential_aggregation_data>
<area_from>200</area_from>
<area_to>400</area_to>
<price_from>120000</price_from>
<price_to>180000</price_to>
<rooms_from>2</rooms_from>
<rooms_to>4</rooms_to>
<available>3</available>
</residential_aggregation_data>
<immobilien>
<immobilie>
<id>700169</id>
<objektnummer></objektnummer>
<objektkategorie>
<nutzungsart WOHNEN="1" GEWERBE="0" ANLAGE="0"/>
<vermarktungsart KAUF="0" MIETE_PACHT="1"/>
<objektart>
<wohnung/>
</objektart>
<user_defined_simplefield feldname="objektart_id">2</user_defined_simplefield>
<user_defined_simplefield feldname="objektart_name">Wohnung</user_defined_simplefield>
<user_defined_anyfield>
<ji_kategorie id="4743">Wienerwald</ji_kategorie>
</user_defined_anyfield>
</objektkategorie>
<titel>DEMOOBJEKT! Luxus Wienblick-Dachgeschosswohnung mit Wintergarten, offenen Kamin, Sauna und
Weinkeller
</titel>
<dreizeiler></dreizeiler>
<naehe></naehe>
<objektbeschreibung>DEMOOBJEKT! Bitte nicht anfragen!</objektbeschreibung>
<anzahl_zimmer>5</anzahl_zimmer>
<etage>EG</etage>
<ort>Wien</ort>
<plz>1030</plz>
<preis>0</preis>
<gesamtmiete/>
<wohnflaeche>269</wohnflaeche>
<nutzflaeche>269</nutzflaeche>
<anzahl_terrassen>2</anzahl_terrassen>
<erstes_bild>https://files.justimmo.at/public/pic/medium/AdlOCzRy51.jpg</erstes_bild>
<zweites_bild>https://files.justimmo.at/public/pic/medium/AdlOGYKVg_.jpg</zweites_bild>
<projekt_id>46</projekt_id>
<status>aktiv</status>
<status_id>5</status_id>
<erstellt_am>2016-04-12 14:47:46</erstellt_am>
<aktualisiert_am>2016-04-19 11:18:59</aktualisiert_am>
</immobilie>
<immobilie>
<id>634476</id>
<objektnummer>894949</objektnummer>
<objektkategorie>
<nutzungsart WOHNEN="1" GEWERBE="0" ANLAGE="0"/>
<vermarktungsart KAUF="0" MIETE_PACHT="1"/>
<objektart>
<wohnung/>
</objektart>
<user_defined_simplefield feldname="objektart_id">2</user_defined_simplefield>
<user_defined_simplefield feldname="objektart_name">Wohnung</user_defined_simplefield>
<user_defined_anyfield>
<ji_kategorie id="4743">Wienerwald</ji_kategorie>
</user_defined_anyfield>
</objektkategorie>
<titel>DEMOOBJEKT! Luxus Wienblick-Dachgeschosswohnung mit Wintergarten, offenen Kamin, Sauna und
Weinkeller
</titel>
<dreizeiler></dreizeiler>
<naehe></naehe>
<objektbeschreibung>DEMOOBJEKT! Bitte nicht anfragen!</objektbeschreibung>
<anzahl_zimmer>5</anzahl_zimmer>
<etage>EG</etage>
<ort>Wien</ort>
<plz>1030</plz>
<preis>0</preis>
<gesamtmiete/>
<wohnflaeche>269</wohnflaeche>
<nutzflaeche>269</nutzflaeche>
<anzahl_terrassen>2</anzahl_terrassen>
<erstes_bild>https://files.justimmo.at/public/pic/medium/AdlOCzRy51.jpg</erstes_bild>
<zweites_bild>https://files.justimmo.at/public/pic/medium/AdlOGYKVg_.jpg</zweites_bild>
<projekt_id>46</projekt_id>
<status>aktiv</status>
<status_id>5</status_id>
<erstellt_am>2016-02-08 14:55:02</erstellt_am>
<aktualisiert_am>2016-04-19 11:18:59</aktualisiert_am>
</immobilie>
<immobilie>
<id>620582</id>
<objektnummer>1000003</objektnummer>
<objektkategorie>
<nutzungsart WOHNEN="1" GEWERBE="0" ANLAGE="0"/>
<vermarktungsart KAUF="0" MIETE_PACHT="1"/>
<objektart>
<wohnung/>
</objektart>
<user_defined_simplefield feldname="objektart_id">2</user_defined_simplefield>
<user_defined_simplefield feldname="objektart_name">Wohnung</user_defined_simplefield>
<user_defined_anyfield>
<ji_kategorie id="4743">Wienerwald</ji_kategorie>
</user_defined_anyfield>
</objektkategorie>
<titel>DEMOOBJEKT! Luxus Wienblick-Dachgeschosswohnung mit Wintergarten, offenen Kamin, Sauna und
Weinkeller
</titel>
<dreizeiler></dreizeiler>
<naehe></naehe>
<objektbeschreibung>DEMOOBJEKT! Bitte nicht anfragen!</objektbeschreibung>
<anzahl_zimmer>5</anzahl_zimmer>
<etage>EG</etage>
<ort>Wien</ort>
<plz>1030</plz>
<preis>0</preis>
<gesamtmiete/>
<wohnflaeche>269</wohnflaeche>
<nutzflaeche>269</nutzflaeche>
<anzahl_terrassen>2</anzahl_terrassen>
<erstes_bild>https://files.justimmo.at/public/pic/medium/AdlOCzRy51.jpg</erstes_bild>
<zweites_bild>https://files.justimmo.at/public/pic/medium/AdlOGYKVg_.jpg</zweites_bild>
<projekt_id>46</projekt_id>
<status>aktiv</status>
<status_id>5</status_id>
<erstellt_am>2016-01-15 11:08:56</erstellt_am>
<aktualisiert_am>2016-04-19 11:18:59</aktualisiert_am>
</immobilie>
<immobilie>
<id>560649</id>
<objektnummer>234235</objektnummer>
<objektkategorie>
<nutzungsart WOHNEN="1" GEWERBE="0" ANLAGE="0"/>
<vermarktungsart KAUF="1" MIETE_PACHT="0"/>
<objektart>
<wohnung/>
</objektart>
<user_defined_simplefield feldname="objektart_id">2</user_defined_simplefield>
<user_defined_simplefield feldname="objektart_name">Wohnung</user_defined_simplefield>
<user_defined_simplefield feldname="sub_objektart_id">45</user_defined_simplefield>
<user_defined_simplefield feldname="sub_objektart_name">Wohnung</user_defined_simplefield>
<user_defined_anyfield>
<ji_kategorie id="4743">Wienerwald</ji_kategorie>
</user_defined_anyfield>
</objektkategorie>
<titel>DEMOOBJEKT! Elegantes Büro neben Bristol und Oper</titel>
<dreizeiler></dreizeiler>
<naehe></naehe>
<objektbeschreibung>DEMOOBJEKT! Bitte nicht anfragen</objektbeschreibung>
<etage>2. KG</etage>
<hausnummer>2</hausnummer>
<strasse>Seidlgasse</strasse>
<ort>Wien</ort>
<plz>1030</plz>
<preis>214200</preis>
<kaufpreis>214200</kaufpreis>
<nutzflaeche>15</nutzflaeche>
<grundflaeche>15</grundflaeche>
<anzahl_balkons>2</anzahl_balkons>
<balkons_flaeche>12</balkons_flaeche>
<erstes_bild>https://files.justimmo.at/public/pic/medium/AdlOCzRy51.jpg</erstes_bild>
<zweites_bild>https://files.justimmo.at/public/pic/medium/AdlOGYKVg_.jpg</zweites_bild>
<projekt_id>46</projekt_id>
<status>aktiv</status>
<status_id>5</status_id>
<erstellt_am>2015-11-11 16:20:35</erstellt_am>
<aktualisiert_am>2016-04-19 11:18:59</aktualisiert_am>
</immobilie>
<immobilie>
<id>560556</id>
<objektnummer>33447</objektnummer>
<objektkategorie>
<nutzungsart WOHNEN="1" GEWERBE="0" ANLAGE="0"/>
<vermarktungsart KAUF="1" MIETE_PACHT="0"/>
<objektart>
<wohnung/>
</objektart>
<user_defined_simplefield feldname="objektart_id">2</user_defined_simplefield>
<user_defined_simplefield feldname="objektart_name">Wohnung</user_defined_simplefield>
<user_defined_simplefield feldname="sub_objektart_id">45</user_defined_simplefield>
<user_defined_simplefield feldname="sub_objektart_name">Wohnung</user_defined_simplefield>
<user_defined_anyfield>
<ji_kategorie id="4743">Wienerwald</ji_kategorie>
</user_defined_anyfield>
</objektkategorie>
<titel>DEMOOBJEKT! Elegantes Büro neben Bristol und Oper</titel>
<dreizeiler></dreizeiler>
<naehe></naehe>
<objektbeschreibung>DEMOOBJEKT! Bitte nicht anfragen!</objektbeschreibung>
<etage>2. KG</etage>
<hausnummer>2</hausnummer>
<strasse>Seidlgasse</strasse>
<ort>Wien</ort>
<plz>1030</plz>
<preis>200000</preis>
<kaufpreis>200000</kaufpreis>
<nutzflaeche>15</nutzflaeche>
<grundflaeche>15</grundflaeche>
<anzahl_balkons>2</anzahl_balkons>
<balkons_flaeche>12</balkons_flaeche>
<erstes_bild>https://files.justimmo.at/public/pic/medium/AdlOCzRy51.jpg</erstes_bild>
<zweites_bild>https://files.justimmo.at/public/pic/medium/AdlOGYKVg_.jpg</zweites_bild>
<projekt_id>46</projekt_id>
<status>aktiv</status>
<status_id>5</status_id>
<erstellt_am>2015-11-11 12:32:29</erstellt_am>
<aktualisiert_am>2016-04-19 11:18:59</aktualisiert_am>
</immobilie>
<immobilie>
<id>66079</id>
<objektnummer>18</objektnummer>
<objektkategorie>
<nutzungsart WOHNEN="1" GEWERBE="0" ANLAGE="0"/>
<vermarktungsart KAUF="1" MIETE_PACHT="0"/>
<objektart>
<wohnung/>
</objektart>
<user_defined_simplefield feldname="objektart_id">2</user_defined_simplefield>
<user_defined_simplefield feldname="objektart_name">Wohnung</user_defined_simplefield>
<user_defined_simplefield feldname="sub_objektart_id">45</user_defined_simplefield>
<user_defined_simplefield feldname="sub_objektart_name">Wohnung</user_defined_simplefield>
<user_defined_anyfield>
<ji_kategorie id="4743">Wienerwald</ji_kategorie>
</user_defined_anyfield>
</objektkategorie>
<titel>DEMOOBJEKT! Elegantes Büro neben Bristol und Oper</titel>
<dreizeiler></dreizeiler>
<naehe></naehe>
<objektbeschreibung>DEMOOBJEKT! Bitte nicht anfragen!</objektbeschreibung>
<etage>2. KG</etage>
<hausnummer>2</hausnummer>
<strasse>Seidlgasse</strasse>
<ort>Wien</ort>
<plz>1030</plz>
<preis>200000</preis>
<kaufpreis>200000</kaufpreis>
<nutzflaeche>15</nutzflaeche>
<grundflaeche>15</grundflaeche>
<anzahl_balkons>2</anzahl_balkons>
<balkons_flaeche>12</balkons_flaeche>
<erstes_bild>https://files.justimmo.at/public/pic/medium/AdlOCzRy51.jpg</erstes_bild>
<zweites_bild>https://files.justimmo.at/public/pic/medium/AdlOGYKVg_.jpg</zweites_bild>
<projekt_id>46</projekt_id>
<status>aktiv</status>
<status_id>5</status_id>
<vermittelt_am>2014-03-02</vermittelt_am>
<erstellt_am>2012-04-01 18:30:34</erstellt_am>
<aktualisiert_am>2016-04-19 11:18:59</aktualisiert_am>
</immobilie>
</immobilien>
<erstes_bild>https://files.justimmo.at/public/pic/medium/ACXayjSPLp.jpg</erstes_bild>
</projekt>
<!-- ...... -->
</justimmo>
The query-result>count element contains information of total hits of the search regardless of given limit parameter.
Detail /projekt/detail
Returns detailed information of a single project as xml in the same format as project list call.
Parameters
- id
- The id of the project
- culture
-
Language for i18n fields
Default: de - picturesize
- The Picture Size to be used for picture urls. Multiple sizes can be requested using array notation (e.g. picturesize[]=big&picturesize[]=small)
- alleProjektObjekte
-
Show all realties of the project regardless of realty state: ?alleProjektObjekte=1
Default: 0 - objektIds
-
Return only realty ids instead of whole realty data in a project tag: ?objektIds=1
Default: 0
Short List /projekt/projektList
Returns a list of projekt ids and title of all active projects with "Show on Homepage" flag.
Example
https://api.justimmo.at/rest/v1/projekt/projektList
<?xml version="1.0" encoding="UTF-8"?>
<justimmo>
<query-result>
<count>3</count>
</query-result>
<projekt>
<id>46</id>
<titel>Demoprojekt in Zentrumsnähe</titel>
</projekt>
<projekt>
<id>51</id>
<titel>Neubau mitten im dritten</titel>
</projekt>
<projekt>
<id>2065</id>
<titel></titel>
</projekt>
</justimmo>
The query-result>count element contains information of total hits of the search regardless of given limit parameter.
Ids /projekt/ids
Returns ids of ALL matching projects as JSON. Filters and orderby/ordertype/alle/alleProjektObjekte from the project list call apply. limit, offset, culture, picturesize, showDetails and objektIds have no effect here - the call is not paginated and returns ids only.
Example
All project ids with project state building
https://api.justimmo.at/rest/v1/projekt/ids?filter[projekt_status]=building
["123","125","159"]