Projects

List and search
Detail
Short List
Ids

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: 10
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 or 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_bau_planung]~~: DEPRECATED: use filter[projekt_status]
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. also possible as array (e.g. picturesize[]=big&picturesize[]=small)

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 matching projects as JSON without limit and offset limitations. For parameters see project list call.

Example

All project ids with project state building

https://api.justimmo.at/rest/v1/projekt/ids?filter[projekt_status]=building

["123","125","159"]