{ "openapi": "3.0.1", "info": { "title": "willhaben Scraper: Immobilien, Cars, Jobs & Ads", "description": "willhaben.at Marktplatz, Immobilien, Auto & Motor and Jobs in one run by keyword, filter, search link, seller, employer or ad link, no login. Rows hold price, m2, rooms, make, mileage, salary; full records add costs, energy class, car equipment, VAT id. New ad alerts, pay per row, JSON, CSV, API.", "version": "0.1", "x-build-id": "SgSPGZKsXnGOyW8dd" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/automation_craft~willhaben-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-automation_craft-willhaben-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/automation_craft~willhaben-scraper/runs": { "post": { "operationId": "runs-sync-automation_craft-willhaben-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/automation_craft~willhaben-scraper/run-sync": { "post": { "operationId": "run-sync-automation_craft-willhaben-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "sections": { "title": "Sections", "type": "array", "description": "The willhaben sections to search: marktplatz (general goods), immobilien (real estate), auto (cars, motorbikes, commercial vehicles, caravans), jobs. Each section is searched on its own, once per keyword. Left empty, the section is taken from the section settings you give (property types, vehicle types, a category), else Marktplatz.", "items": { "type": "string", "enum": [ "marktplatz", "immobilien", "auto", "jobs" ], "enumTitles": [ "Marktplatz (general goods)", "Immobilien (real estate)", "Auto & Motor (vehicles)", "Jobs" ] } }, "keywords": { "title": "Keywords", "type": "array", "description": "Search words, each one its own search (for example \"fahrrad\", \"3 zimmer balkon\", \"golf 7\"). Left empty, the section is searched without words. Up to 100 characters each.", "items": { "type": "string" } }, "propertyTypes": { "title": "Property types (Immobilien)", "type": "array", "description": "Immobilien only: which property searches to read, each its own search. \"all\" is every property ad. Rooms, living area and some other filters exist only for a property type, not for \"all\".", "items": { "type": "string", "enum": [ "all", "mietwohnungen", "eigentumswohnung", "haus-mieten", "haus-kaufen", "grundstuecke", "neubauprojekte", "gewerbe-mieten", "gewerbe-kaufen", "ferien-mieten", "ferien-kaufen", "sonstige" ], "enumTitles": [ "All property ads", "Flats for rent (Wohnung mieten)", "Flats for sale (Wohnung kaufen)", "Houses for rent (Haus mieten)", "Houses for sale (Haus kaufen)", "Plots (Grundstücke)", "New build projects (Neubauprojekte)", "Commercial for rent (Gewerbe mieten)", "Commercial for sale (Gewerbe kaufen)", "Holiday homes for rent", "Holiday homes for sale", "Other property (Sonstige)" ] } }, "vehicleTypes": { "title": "Vehicle types (Auto & Motor)", "type": "array", "description": "Auto & Motor only: which vehicle searches to read, each its own search. Left empty: cars (Gebrauchtwagen); with sellerIds: all four.", "items": { "type": "string", "enum": [ "cars", "motorbikes", "commercial", "caravans" ], "enumTitles": [ "Cars (Gebrauchtwagen)", "Motorbikes and quads (Motorrad)", "Commercial vehicles and pickups (Nutzfahrzeuge)", "Caravans and motorhomes (Wohnwagen, Wohnmobile)" ] } }, "marktplatzCategories": { "title": "Marktplatz categories", "type": "array", "description": "Marktplatz only: a category by its willhaben name or id, each its own search: a top category (\"Sport / Sportgeräte\") or one of its sub categories (\"Fahrräder / Radsport\"). A name several categories share is refused with the candidates.", "items": { "type": "string", "enumSuggestedValues": [ "Antiquitäten / Kunst", "Baby / Kind", "Beauty / Gesundheit / Wellness", "Boote / Yachten / Jetskis", "Bücher / Filme / Musik", "Computer / Software", "Dienstleistungen", "Freizeit / Instrumente / Kulinarik", "Games / Konsolen", "Haus / Garten / Werkstatt", "Kameras / TV / Multimedia", "KFZ-Zubehör / Motorradteile", "Mode / Accessoires", "Smartphones / Telefonie", "Spielen / Spielzeug", "Sport / Sportgeräte", "Tiere / Tierbedarf", "Uhren / Schmuck", "Wohnen / Haushalt / Gastronomie" ] } }, "states": { "title": "States (Bundesländer)", "type": "array", "description": "The Austrian states to search in (\"Wien\", \"Niederösterreich\" or \"Niederoesterreich\", \"Steiermark\", ...), or \"andere Länder\" for ads abroad. Works in every section.", "items": { "type": "string", "enumSuggestedValues": [ "Burgenland", "Kärnten", "Niederösterreich", "Oberösterreich", "Salzburg", "Steiermark", "Tirol", "Vorarlberg", "Wien", "andere Länder" ] } }, "districts": { "title": "Districts (Bezirke)", "type": "array", "description": "Districts (Bezirke), the towns that are districts included: \"Graz\", \"St. Pölten\", \"Salzburg\", \"Graz-Umgebung\", and Vienna's districts as \"1030\", \"Wien 3\" or \"Landstraße\". Case, umlauts written out and hyphens do not matter. For a smaller town use a radius around its coordinates. Every section.", "items": { "type": "string", "enumSuggestedValues": [ "Eisenstadt", "Eisenstadt - Umgebung", "Güssing", "Jennersdorf", "Mattersburg", "Neusiedl am See", "Oberpullendorf", "Oberwart", "Rust (Stadt)", "Feldkirchen", "Hermagor", "Klagenfurt", "Klagenfurt Land", "Sankt Veit an der Glan", "Spittal an der Drau", "Villach", "Villach Land", "Völkermarkt", "Wolfsberg", "Amstetten", "Baden", "Bruck an der Leitha", "Gmünd", "Gänserndorf", "Hollabrunn", "Horn", "Korneuburg", "Krems an der Donau", "Krems Land", "Lilienfeld", "Melk", "Mistelbach", "Mödling", "Neunkirchen", "Sankt Pölten", "Sankt Pölten Land", "Scheibbs", "Tulln", "Waidhofen an der Thaya", "Waidhofen an der Ybbs", "Wiener Neustadt", "Wiener Neustadt Land", "Zwettl", "Braunau am Inn", "Eferding", "Freistadt", "Gmunden", "Grieskirchen", "Kirchdorf an der Krems", "Linz", "Linz Land", "Perg", "Ried im Innkreis", "Rohrbach", "Schärding", "Steyr", "Steyr-Land", "Urfahr-Umgebung", "Vöcklabruck", "Wels", "Wels-Land", "Hallein", "Salzburg Stadt", "Salzburg-Umgebung", "Sankt Johann im Pongau", "Tamsweg", "Zell am See", "Bruck-Mürzzuschlag", "Deutschlandsberg", "Graz", "Graz-Umgebung", "Hartberg-Fürstenfeld", "Leibnitz", "Leoben", "Liezen", "Murau", "Murtal", "Südoststeiermark", "Voitsberg", "Weiz", "Imst", "Innsbruck", "Innsbruck-Land", "Kitzbühel", "Kufstein", "Landeck", "Lienz", "Reutte", "Schwaz", "Bludenz", "Bregenz", "Dornbirn", "Feldkirch", "Wien, 01. Bezirk, Innere Stadt", "Wien, 02. Bezirk, Leopoldstadt", "Wien, 03. Bezirk, Landstraße", "Wien, 04. Bezirk, Wieden", "Wien, 05. Bezirk, Margareten", "Wien, 06. Bezirk, Mariahilf", "Wien, 07. Bezirk, Neubau", "Wien, 08. Bezirk, Josefstadt", "Wien, 09. Bezirk, Alsergrund", "Wien, 10. Bezirk, Favoriten", "Wien, 11. Bezirk, Simmering", "Wien, 12. Bezirk, Meidling", "Wien, 13. Bezirk, Hietzing", "Wien, 14. Bezirk, Penzing", "Wien, 15. Bezirk, Rudolfsheim-Fünfhaus", "Wien, 16. Bezirk, Ottakring", "Wien, 17. Bezirk, Hernals", "Wien, 18. Bezirk, Währing", "Wien, 19. Bezirk, Döbling", "Wien, 20. Bezirk, Brigittenau", "Wien, 21. Bezirk, Floridsdorf", "Wien, 22. Bezirk, Donaustadt", "Wien, 23. Bezirk, Liesing", "Bosnien und Herzegowina", "Bulgarien", "Deutschland", "Frankreich", "Griechenland", "Großbritannien", "Italien", "Kroatien", "Malta", "Montenegro", "Niederlande", "Polen", "Portugal", "Russland", "Schweiz", "Serbien", "Slowakei", "Slowenien", "Spanien", "Tschechien", "Türkei", "Ungarn" ] } }, "latitude": { "title": "Latitude", "minimum": 45.5, "maximum": 49.5, "type": "number", "description": "With \"longitude\" and \"radiusKm\": the point a radius is measured from, in Austria (for example 48.2082 for Vienna centre). Ads farther away, or without coordinates, are left out free; job searches send the radius to willhaben." }, "longitude": { "title": "Longitude", "minimum": 9, "maximum": 17.5, "type": "number", "description": "With \"latitude\" and \"radiusKm\" (for example 16.3738 for Vienna centre)." }, "radiusKm": { "title": "Radius", "minimum": 1, "maximum": 300, "type": "integer", "description": "The distance from latitude and longitude, in kilometres (1 to 300). The sort \"nearest\" ends a search at the radius." }, "minPrice": { "title": "Minimum price", "minimum": 0, "type": "number", "description": "Marktplatz, Immobilien and Auto & Motor: the lowest price (for rentals the rent) in euros, sent to willhaben." }, "maxPrice": { "title": "Maximum price", "minimum": 0, "type": "number", "description": "The highest price (for rentals the rent) in euros, sent to willhaben." }, "sellerType": { "title": "Seller type", "enum": [ "any", "private", "business" ], "type": "string", "description": "Private sellers or businesses (dealers, agencies, shops). Marktplatz and Auto & Motor filter at willhaben; Immobilien rows are checked one by one.", "default": "any" }, "postedWithinDays": { "title": "Posted within (days)", "minimum": 1, "maximum": 365, "type": "integer", "description": "Only ads published or bumped within this many days (1 to 365, willhaben's own window). On jobs: 1, 3 or 7." }, "postedAfter": { "title": "Posted on or after", "type": "string", "description": "A date (YYYY-MM-DD, Vienna time): only rows published or bumped (jobs: published or reordered) on or after it. Checked on every row." }, "postedBefore": { "title": "Posted on or before", "type": "string", "description": "A date (YYYY-MM-DD, Vienna time): only rows published or bumped on or before it. Checked on every row." }, "minLivingArea": { "title": "Minimum living area", "minimum": 0, "type": "number", "description": "Immobilien, a property type: the smallest living area in square metres." }, "maxLivingArea": { "title": "Maximum living area", "minimum": 0, "type": "number", "description": "The largest living area in square metres." }, "minPlotArea": { "title": "Minimum plot area", "minimum": 0, "type": "number", "description": "Houses and plots: the smallest plot (Grundfläche) in square metres." }, "maxPlotArea": { "title": "Maximum plot area", "minimum": 0, "type": "number", "description": "The largest plot in square metres." }, "rooms": { "title": "Rooms", "type": "array", "description": "Number of rooms as willhaben groups them: \"1\", \"2\", \"3\", \"4\", \"5\", \"6-9\", \"ab 10\".", "items": { "type": "string", "enumSuggestedValues": [ "1", "2", "3", "4", "5", "6-9", "ab 10", "keine Angaben" ] } }, "objectTypes": { "title": "Object types", "type": "array", "description": "Object types as willhaben names them (\"Dachgeschoßwohnung\", \"Erdgeschoßwohnung\", \"Einfamilienhaus\", \"Reihenhaus\", \"Baugrundstück\", ...).", "items": { "type": "string", "enumSuggestedValues": [ "Almhütte/Berghütte", "Ausstellungsfläche", "Bauernhaus", "Baugrundstück", "Bungalow", "Büro/Ordination", "Dachgeschoßwohnung", "Doppelhaushälfte", "Einfamilienhaus", "Erdgeschoßwohnung", "Ferienwohnung/Ferienhaus", "Garconniere", "Gartenhaus", "Gastronomie", "Genossenschaftshaus", "Genossenschaftswohnung", "Geschäfts-/Ladenlokal", "Gewerbegrundstück", "Grundstück", "Hotel/Pension", "Industriegrundstück", "Jagd-/Forstwirtschaft", "Kleingarten", "Lagerhalle", "Land-/Forstwirtschaft", "Landhaus", "Loft/Studio", "Maisonette", "Mehrfamilienhaus", "Penthousewohnung", "Reihenhaus", "Rohbau", "Rohdachboden", "Schloss/Burg/Chalet", "Sonstige", "Teich-/Fischwirtschaft", "Villa", "Werkstatt", "Wohnung", "Zimmer/WG", "Zinshaus" ] } }, "outdoorAreas": { "title": "Outdoor areas", "type": "array", "description": "Balkon, Dachterrasse, Garten, Loggia, Terrasse, Wintergarten (any of them).", "items": { "type": "string", "enumSuggestedValues": [ "Balkon", "Dachterrasse", "Garten", "Loggia", "Terrasse", "Wintergarten" ] } }, "propertyFeatures": { "title": "Features", "type": "array", "description": "Ausstattung as willhaben names it: Abstellraum, Barrierefrei, Carport, Einbauküche, Fahrstuhl, Garage, Keller, Parkplatz, \"Teilmöbliert / Möbliert\".", "items": { "type": "string", "enumSuggestedValues": [ "Abstellraum", "Barrierefrei", "Carport", "Einbauküche", "Fahrstuhl", "Garage", "Keller", "Parkplatz", "Teilmöbliert / Möbliert" ] } }, "availableNow": { "title": "Available now", "type": "boolean", "description": "Only properties available at once (\"ab sofort\").", "default": false }, "newBuildOnly": { "title": "New build projects only", "type": "boolean", "description": "Only new build projects (Neubauprojekte) within the property type.", "default": false }, "makes": { "title": "Makes", "type": "array", "description": "Auto & Motor: makes as willhaben names them (\"VW\", \"BMW\", \"Mercedes-Benz\", \"KTM\" for motorbikes).", "items": { "type": "string", "enumSuggestedValues": [ "Audi", "BMW", "Citroën", "Fiat", "Ford", "Hyundai", "KIA", "Mazda", "Mercedes-Benz", "Mitsubishi", "Nissan", "Opel", "Peugeot", "Porsche", "Renault", "Seat", "Skoda", "Suzuki", "Toyota", "Volvo", "VW", "Abarth", "Aixam", "Alfa Romeo", "Alpina", "Alpine", "Aston Martin", "Austin", "BAIC", "BAW", "Bentley", "British Leyland", "Buick", "BYD", "Cadillac", "Casalini", "Caterham", "Chery", "Chevrolet", "Chevrolet / Daewoo", "Chrysler", "Corvette", "Cupra", "Dacia", "Daihatsu", "DFSK", "Dodge", "Dongfeng", "DS Automobiles", "Elaris", "Eli", "Ferrari", "Fisker", "GAC", "Geco", "Geely", "Genesis", "GMC", "Graf Carello", "Honda", "Hongqi", "Hudson", "Hummer", "Ineos", "Infiniti", "IVECO", "JAC", "Jaecoo", "Jaguar", "Jeep", "KGM/SsangYong", "KTM", "Lada", "Lamborghini", "Lancia", "Land Rover", "Leapmotor", "Lexus", "Ligier", "Lincoln", "Lotus", "LYNK & Co", "Mahindra", "MAN", "Maserati", "Maxus", "McLaren", "Mercury", "MG", "Microcar", "Microlino", "MINI", "Morgan", "NIO", "NSU", "Oldsmobile", "Omoda", "Polestar", "Pontiac", "Puch", "Riley", "Rolls-Royce", "Rover", "Saab", "Skywell Automobile", "smart", "Steyr", "Subaru", "Talbot", "Tata", "Tesla", "Trabant", "Triumph", "Wiesmann", "XPENG", "Zeekr", "ZhiDou", "Sonstige" ] } }, "models": { "title": "Models", "type": "array", "description": "Models of the makes given (\"Golf\", \"Polo\", \"3er-Reihe\"); needs \"makes\". A model name two of your makes share is refused with the candidates.", "items": { "type": "string" } }, "minYear": { "title": "First registration from", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "The earliest year of first registration." }, "maxYear": { "title": "First registration to", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "The latest year of first registration." }, "minMileageKm": { "title": "Minimum mileage", "minimum": 0, "maximum": 5000000, "type": "integer", "description": "The lowest mileage in kilometres." }, "maxMileageKm": { "title": "Maximum mileage", "minimum": 0, "maximum": 5000000, "type": "integer", "description": "The highest mileage in kilometres." }, "minPowerKw": { "title": "Minimum power", "minimum": 0, "maximum": 5000, "type": "integer", "description": "The lowest engine power in kW." }, "maxPowerKw": { "title": "Maximum power", "minimum": 0, "maximum": 5000, "type": "integer", "description": "The highest engine power in kW." }, "fuelTypes": { "title": "Fuel", "type": "array", "description": "Benzin, Diesel, Elektro, Gas, \"Hybrid Elektro/Benzin\", \"Hybrid Elektro/Diesel\", Wasserstoff.", "items": { "type": "string", "enumSuggestedValues": [ "Benzin", "Diesel", "Elektro", "Gas", "Hybrid Elektro/Benzin", "Hybrid Elektro/Diesel", "Wasserstoff" ] } }, "transmissions": { "title": "Transmission", "type": "array", "description": "Automatik or Schaltgetriebe (commercial vehicles also Halbautomatik, Direkt).", "items": { "type": "string", "enumSuggestedValues": [ "Automatik", "Direkt", "Halbautomatik", "Schaltgetriebe" ] } }, "bodyTypes": { "title": "Vehicle body types", "type": "array", "description": "Cars: \"Klein-/ Kompaktwagen\", Limousine, \"Kombi / Family Van\", \"SUV / Geländewagen\", \"Cabrio / Roadster\", \"Sportwagen / Coupé\", Kleinbus, Mopedauto. Motorbikes and others have their own types.", "items": { "type": "string", "enumSuggestedValues": [ "Cabrio / Roadster", "Klein-/ Kompaktwagen", "Kleinbus", "Kombi / Family Van", "Limousine", "Mopedauto", "Sportwagen / Coupé", "SUV / Geländewagen" ] } }, "vehicleConditions": { "title": "Vehicle condition", "type": "array", "description": "Gebrauchtwagen, Jahreswagen, Neuwagen, Oldtimer, Tageszulassung, Unfallwagen, Vorführwagen.", "items": { "type": "string", "enumSuggestedValues": [ "Gebrauchtwagen", "Jahreswagen", "Neuwagen", "Oldtimer", "Tageszulassung", "Unfallwagen", "Vorführwagen" ] } }, "marktplatzCondition": { "title": "Item condition (Marktplatz)", "type": "array", "description": "Marktplatz only: Neu, Neuwertig, Generalüberholt, Gebraucht, Defekt, Ausstellungsstück.", "items": { "type": "string", "enumSuggestedValues": [ "Neu", "Neuwertig", "Generalüberholt", "Gebraucht", "Defekt", "Ausstellungsstück" ] } }, "delivery": { "title": "Handover (Marktplatz)", "enum": [ "any", "pickup", "shipping" ], "type": "string", "description": "Marktplatz only: pickup (Selbstabholung) or shipping (Versand).", "default": "any" }, "buyerProtectionOnly": { "title": "Buyer protection only (Marktplatz)", "type": "boolean", "description": "Marktplatz only: ads with willhaben's PayLivery (payment and shipping with buyer protection).", "default": false }, "jobFields": { "title": "Job fields (Jobs)", "type": "array", "description": "Jobs only: fields of work or their sub fields as willhaben names them (\"IT / EDV\", \"Vertrieb / Handel\", \"Softwareentwicklung\", ...).", "items": { "type": "string", "enumSuggestedValues": [ "Assistenz / Sekretariat / Sachbearbeitung", "Administration", "Assistenz", "Projektmanagement", "Assistenz der Geschäftsführung", "Bürokaufmann/frau", "Büroleitung", "Sachbearbeitung", "Sekretariat", "Übersetzung", "Empfang / Telefonzentrale", "Aus- und Weiterbildung / Pädagogik / Forschung", "Aus- und Weiterbildung", "Erziehung", "Forschung / Wissenschaft", "Schule", "Universität und Fachhochschule", "Beratung / Consulting / Recht", "Notariat", "Rechtsabteilung", "Rechtsanwalt", "Unternehmensberatung", "Einkauf / Logistik / Transport", "Einkauf", "Entsorgungslogistik", "Fuhrparkmanagement", "Import / Export / Zölle", "Lager", "Logistik", "Spedition", "Supply-Chain-Management", "Transport", "Facilitymanagement / Sicherheit / Reinigung", "Hausverwaltung", "Gebäudemanagement", "Reinigung", "Sicherheitsdienst", "Finanzen / Rechnungswesen / Controlling", "Bank", "Buchhaltung", "Controlling", "Lohnverrechnung", "Finanz- / Rechnungswesen", "Steuerberatung", "Versicherung", "Wirtschaftsprüfung / Revision", "Gastgewerbe / Tourismus / Freizeit / Hilfskräfte", "Bedienung / Service / Catering", "Empfang / Rezeption", "Gästebetreuung", "Haushaltshilfe", "Hilfskräfte Gastgewerbe", "Hotelverwaltung / Restaurantleitung", "Housekeeping", "Kinderbetreuung", "Küche", "Reiseverkehr", "Sport- & Fitnesstraining", "Handwerk / Gewerbliche Berufe", "Bäckerei", "Beauty / Wellness", "CNC / Zerspanungstechnik", "Elektro", "Feinmechanik / Uhrmacherei", "Fleischhauerei", "Forstwirtschaft / Landwirtschaft / Gartenbau / Umwelt", "Glas / Stein", "Hochbau und Tiefbau", "Holz / Tischlerei", "Kfz-Werkstätte", "Metall / Schlosserei", "Montage", "Rauchfangkehrer", "Schweißen / Löten", "Tierpflege", "Fußboden / Malen / Tapezieren", "Heizung / Klima / Sanitär", "Hilfskräfte Handwerk / Gewerbe", "Näherei / Schneiderei", "IT / EDV", "Datenbanken / Data Warehouse / BI", "IT-Beratung", "IT-Helpdesk / Training", "IT-Projektmanagement / Testing", "Mobile Entwicklung", "Softwareentwicklung", "Web-Entwicklung", "Embedded Systems / Firmware", "IT Operations", "IT Security", "Management / Geschäftsführung", "Vorstand / Geschäftsführung", "Bereichsleitung", "Filialleitung", "Marketing / Medien / PR / Grafik / Kultur", "PR / Unternehmenskommunikation", "Event Management", "Grafik / Design", "Kunst / Kultur", "Marketing", "Marktforschung", "Medien", "Online-Marketing", "Produktmanagement", "Öffentlicher Dienst", "Bestattung", "Bundesheer", "Bundesverwaltung / Behörden", "Feuerwehr", "Finanzverwaltung", "Justiz", "Müllabfuhr", "Polizei", "Straßenreinigung", "Personalwesen / HR", "Personalberatung / Vermittlung", "Personalmanagement", "Pflege / Soziales / Gesundheit", "Ärzt:innen", "Ernährungsberatung", "Hörgeräteakustik", "Labor", "Logopädie", "Medizinische Assistenz", "Optik", "Pflege", "Physiotherapie", "Psychotherapie", "Sanitätsdienst", "Sozialarbeit", "Zahntechnik", "Zivildienst", "Pharma", "Geburtshilfe", "Produktion / Fertigung", "Abfalltechnik / Abfallwirtschaft", "Arbeitsvorbereitung / Sicherheit", "Chemische Produktion", "Druckerei", "Maschineninstandhaltung", "Nahrungsmittelproduktion", "Produktion", "Hilfskraft Produktion", "Produktionsplanung", "Qualitätsmanagement Produktion", "Betriebstechnik / Inbetriebnahme", "Technische Berufe / Engineering / Architektur", "Elektrotechnik / Elektronik", "Energietechnik", "Entwicklung", "Gebäude- und Sicherheitstechnik", "Konstruktion / Techn. Zeichnen / CAD", "Kunststofftechnik", "Maschinenbau", "Medizintechnik", "Technische Dokumentation", "Technischer Kundendienst", "Telekommunikation / Mobilfunk", "Umwelttechnik / Verkehr", "Verfahrenstechnik", "Wirtschaftsingenieurwesen", "Anlagenbau", "Architektur", "Automatisierungstechnik / Mechatronik", "Bauwesen", "Vertrieb / Handel", "Call Center", "Einzelhandel", "Franchising", "Großhandel", "Immobilienmanagement", "Kundenbetreuung", "Promotion", "Technischer Vertrieb", "Vertrieb" ] } }, "employmentTypes": { "title": "Employment types (Jobs)", "type": "array", "description": "Vollzeit, Teilzeit, Freiberuflich, Geringfügig.", "items": { "type": "string", "enumSuggestedValues": [ "Vollzeit", "Teilzeit", "Freiberuflich", "Geringfügig" ] } }, "positionLevels": { "title": "Positions (Jobs)", "type": "array", "description": "\"Gruppen-/Teamleitung\", Lehre, \"Leitung/Management\", \"Mitarbeiter:in\", Praktikum, Projektmanagement, Traineeship.", "items": { "type": "string", "enumSuggestedValues": [ "Gruppen-/Teamleitung", "Lehre", "Leitung/Management", "Mitarbeiter:in", "Praktikum", "Projektmanagement", "Traineeship" ] } }, "employerType": { "title": "Employer type (Jobs)", "enum": [ "any", "company", "agency" ], "type": "string", "description": "Jobs only: direct employers (Firmen) or staffing agencies (Personaldienstleister).", "default": "any" }, "minSalary": { "title": "Minimum salary (Jobs)", "minimum": 0, "type": "number", "description": "Jobs only, checked on every job row against the salary willhaben shows, in the period below. Jobs without a salary are left out free." }, "maxSalary": { "title": "Maximum salary (Jobs)", "minimum": 0, "type": "number", "description": "Jobs only: the highest salary shown." }, "salaryPeriod": { "title": "Salary period (Jobs)", "enum": [ "month", "year", "hour" ], "type": "string", "description": "The period of the salary range: per month (the default), per year or per hour. A monthly and a yearly salary are compared at 14 salaries a year, as Austrian pay is counted; an hourly salary only with an hourly range." }, "attributeFilters": { "title": "Any other willhaben filter", "type": "object", "description": "Any other filter of the search's own willhaben filter list, by its German label or id, with values by label or id, or {\"min\": n, \"max\": n} for a range. For example {\"Farbe\": [\"Schwarz\"], \"Anzahl der Sitze\": {\"min\": 7}, \"Garantie\": [\"Garantie\"]}. A filter the search does not offer is refused with the filters it does offer." }, "sort": { "title": "Sort", "enum": [ "newest", "relevance", "priceLow", "priceHigh", "nearest", "areaLow", "areaHigh", "mileageLow", "mileageHigh", "yearNew", "yearOld" ], "type": "string", "description": "The order willhaben answers in. Left empty: newest first (published or bumped; the only order read past 199,800 rows), nearest first when a radius is set, and a pasted link keeps its own order. Or choose: newest, relevance (needs keywords), price, nearest (needs latitude, longitude and radiusKm), living area (Immobilien), mileage or first registration (Auto & Motor). Jobs: newest or relevance." }, "includeKeywords": { "title": "Must contain one of", "type": "array", "description": "Only rows whose title or description holds one of these words (whole words, any case). Checked on every row; with details on, on the full description.", "items": { "type": "string" } }, "requireAllKeywords": { "title": "Must contain all of them", "type": "boolean", "description": "Rows must hold every word of \"includeKeywords\", not just one.", "default": false }, "excludeKeywords": { "title": "Must not contain", "type": "array", "description": "Leave out rows whose title or description holds one of these words (the same whole word rule).", "items": { "type": "string" } }, "titleOnly": { "title": "Words in the title only", "type": "boolean", "description": "Read \"includeKeywords\" and \"excludeKeywords\" in the title alone.", "default": false }, "excludeAdIds": { "title": "Ad ids to leave out", "type": "array", "description": "Ad or job ids or links that are never delivered (for example ones you already have).", "items": { "type": "string" } }, "searchUrls": { "title": "Search links", "type": "array", "description": "Search pages copied from willhaben.at (Marktplatz, Immobilien, Auto & Motor under /iad/, or jobs under /jobs/suche), read with all their filters. A link parameter its search does not know is refused, since willhaben would ignore it without saying so.", "items": { "type": "string" } }, "sellerIds": { "title": "Sellers", "type": "array", "description": "A seller's ads in Marktplatz, Immobilien and Auto & Motor: the seller number (the ORGID of their ads, delivered in sellerId for business sellers) or a private seller's profile link. Combined with the sections and filters you give. A search link with \"orgId=\" goes into Search links, which keeps its section and filters.", "items": { "type": "string" } }, "employerUrls": { "title": "Employer pages (Jobs)", "type": "array", "description": "All open jobs of an employer: its willhaben employer page link (https://www.willhaben.at/jobs/firma//).", "items": { "type": "string" } }, "adUrls": { "title": "Ad and job links", "type": "array", "description": "Ad links (https://www.willhaben.at/iad/.../d/...), ad ids, or job links (https://www.willhaben.at/jobs/job/...): each read with its full record and billed as a Listing with its Listing details. A removed or unknown one is a free row.", "items": { "type": "string" } }, "maxItems": { "title": "Maximum rows", "minimum": 1, "maximum": 200000, "type": "integer", "description": "The most paid rows the run delivers (ads, jobs, change rows, removed rows), across all searches and links.", "default": 100 }, "maxItemsPerSearch": { "title": "Maximum rows per search", "minimum": 1, "maximum": 200000, "type": "integer", "description": "The most rows one search delivers." }, "maxPagesPerSearch": { "title": "Maximum pages per search", "minimum": 1, "maximum": 999, "type": "integer", "description": "The most result pages one search reads (up to 200 ads or 90 jobs a page)." }, "maxRowsPerSearch": { "title": "Rows read per search", "minimum": 1, "maximum": 199800, "type": "integer", "description": "How many rows of each search are read (a monitor's window, 200 by default for a monitor)." }, "includeDetails": { "title": "Include details (full record)", "type": "boolean", "description": "Read each ad's or job's full record: the full description, every attribute, seller or company facts, car equipment, property costs and energy data, the apply link. Billed as Listing details per row with details.", "default": false }, "includePersonalData": { "title": "Include personal data", "type": "boolean", "description": "Deliver the fields that name or reach a private person: a private seller's name and id, the street and exact map point of a private ad, contact persons' names on ads and job ads, and the contacts found in such texts. Off by default; you are responsible for using such data lawfully (GDPR). Business data is always delivered.", "default": false }, "includeRawData": { "title": "Include raw data", "type": "boolean", "description": "Add willhaben's own search row and full record as served (for a private seller's ad only with \"includePersonalData\").", "default": false }, "descriptionFormat": { "title": "Description format", "enum": [ "html", "text", "markdown", "all" ], "type": "string", "description": "html: as willhaben serves it (the default); text: plain text; markdown; all: html plus text and markdown fields.", "default": "html" }, "descriptionMaxLength": { "title": "Description length", "minimum": 20, "maximum": 100000, "type": "integer", "description": "Cut descriptions after this many characters (20 to 100,000)." }, "compactOutput": { "title": "Compact rows", "type": "boolean", "description": "Deliver only the core fields of each row.", "default": false }, "excludeEmptyFields": { "title": "Leave out empty fields", "type": "boolean", "description": "Drop fields that are null, empty texts or empty lists.", "default": false }, "extractContacts": { "title": "Extract contacts from texts", "type": "boolean", "description": "Add the e-mail addresses, phone numbers, websites and social profiles written in the title and description (for private sellers' ads and job ads only with \"includePersonalData\"). Texts themselves are never changed.", "default": false }, "phoneExtractionMode": { "title": "Phone extraction", "enum": [ "strict", "lenient" ], "type": "string", "description": "strict: numbers after a contact word or written with a country code; lenient: also bare numbers that start with 0. Needs \"extractContacts\"." }, "monitorName": { "title": "Monitor name", "type": "string", "description": "Name a monitor to deliver only ads new to it on every scheduled run (each ad billed once). The memory belongs to this Actor; up to 60 characters of letters, digits, spaces and . _ , - : # ( )." }, "resetMonitor": { "title": "Reset the monitor", "type": "boolean", "description": "Start the named monitor empty on this run.", "default": false }, "trackChanges": { "title": "Track changes", "type": "boolean", "description": "With a monitor: deliver a known ad again when its price changed (priceChanged, with the previous price and a price history), its title, images or place changed (updated) or it came back (reappeared), and report ads no longer found when every search was read to its end (removed rows). Each such row is billed as a Listing.", "default": false }, "emitUnchanged": { "title": "Deliver unchanged ads too", "type": "boolean", "description": "With a monitor: deliver known ads that did not change as \"unchanged\" (billed as a Listing).", "default": false }, "markReposts": { "title": "Mark reposts", "type": "boolean", "description": "With a monitor: mark a new ad whose title, price and seller match an ad the monitor delivered (possibleRepostOf).", "default": false }, "skipReposts": { "title": "Skip reposts", "type": "boolean", "description": "With markReposts: leave reposts out free.", "default": false }, "telegramBotToken": { "title": "Telegram bot token", "type": "string", "description": "Send the rows of the run to Telegram through your own bot (the token BotFather gave you)." }, "telegramChatId": { "title": "Telegram chat id", "type": "string", "description": "Your chat id (a number) or a channel name starting with @." }, "slackWebhookUrl": { "title": "Slack webhook", "type": "string", "description": "A Slack incoming webhook link (hooks.slack.com)." }, "discordWebhookUrl": { "title": "Discord webhook", "type": "string", "description": "A Discord webhook link." }, "whatsappAccessToken": { "title": "WhatsApp access token", "type": "string", "description": "Your WhatsApp Cloud API token (with the two settings below)." }, "whatsappPhoneNumberId": { "title": "WhatsApp phone number id", "type": "string", "description": "Your WhatsApp Cloud API phone number id (digits)." }, "whatsappTo": { "title": "WhatsApp recipient", "type": "string", "description": "The number to send to, in international form without + (for example 436641234567)." }, "webhookUrl": { "title": "Webhook", "type": "string", "description": "A link of your own service: the rows are sent as JSON in batches of 100 (signed with HMAC SHA-256 when a secret is given)." }, "webhookSecret": { "title": "Webhook secret", "type": "string", "description": "16 to 200 characters; signs each webhook call (header x-signature-sha256)." }, "webhookHeaders": { "title": "Webhook headers", "type": "object", "description": "Extra headers for the webhook (at most 10)." }, "notificationLimit": { "title": "Rows per message", "minimum": 1, "maximum": 30, "type": "integer", "description": "How many rows a Telegram, Slack, Discord or WhatsApp message lists (1 to 30)." }, "notifyOnlyChanges": { "title": "Notify only new and changed", "type": "boolean", "description": "Leave unchanged rows out of the notifications.", "default": false }, "failIfIncomplete": { "title": "Fail the run if incomplete", "type": "boolean", "description": "Mark the run failed when a search or link was not read completely (the rows stay delivered).", "default": false }, "maxFailedRequestsPercent": { "title": "Fail above this share of failed reads", "minimum": 1, "maximum": 100, "type": "integer", "description": "Mark the run failed when more than this percent of its reads failed." }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Leave as is: the search door is read through Apify's datacenter proxy and willhaben's pages through an Austrian residential session. Your own proxy links replace both." }, "requestsPerSecond": { "title": "Requests per second", "minimum": 0.2, "maximum": 2, "type": "number", "description": "The pace of each of the two exits (0.2 to 2).", "default": 1 }, "maxConcurrency": { "title": "Requests in flight", "minimum": 1, "maximum": 4, "type": "integer", "description": "Requests in flight at once on each exit (1 to 4), inside the pace above: more helps only when willhaben answers slowly.", "default": 2 }, "maxRequestRetries": { "title": "Retries per request", "minimum": 0, "maximum": 5, "type": "integer", "description": "How often a failed or empty answer is asked again (0 to 5). A refusal by willhaben is never a reason to draw a new address.", "default": 2 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }