{ "openapi": "3.0.1", "info": { "title": "Kleinanzeigen Scraper ($0.9 per 1000 results)", "description": "Scrape listings from kleinanzeigen.de in Germany across categories like real estate, vehicles, electronics and more. Filter by query, location, price, seller type and dates. Export clean listing data with URL, image and optional detail payloads.", "version": "0.0", "x-build-id": "1XEyh07AWVGwx2Qgt" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/igolaizola~kleinanzeigen-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-igolaizola-kleinanzeigen-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/igolaizola~kleinanzeigen-scraper/runs": { "post": { "operationId": "runs-sync-igolaizola-kleinanzeigen-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/igolaizola~kleinanzeigen-scraper/run-sync": { "post": { "operationId": "run-sync-igolaizola-kleinanzeigen-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", "required": [ "maxItems" ], "properties": { "maxItems": { "title": "Max Listings", "minimum": 1, "type": "integer", "description": "Maximum number of listings to collect", "default": 100 }, "query": { "title": "Search Keywords", "type": "string", "description": "Free text search (for example: wohnung, haus, penthouse)" }, "category": { "title": "Category", "enum": [ "alle_kategorien", "auto_rad_and_boot", "auto_rad_and_boot_autos", "auto_rad_and_boot_autoteile_and_reifen", "auto_rad_and_boot_boote_and_bootszubehoer", "auto_rad_and_boot_fahrraeder_and_zubehoer", "auto_rad_and_boot_motorraeder_and_motorroller", "auto_rad_and_boot_motorradteile_and_zubehoer", "auto_rad_and_boot_nutzfahrzeuge_and_anhaenger", "auto_rad_and_boot_reparaturen_and_dienstleistungen", "auto_rad_and_boot_wohnwagen_and_mobile", "auto_rad_and_boot_weiteres_auto_rad_and_boot", "immobilien", "immobilien_auf_zeit_and_wg", "immobilien_container", "immobilien_eigentumswohnungen", "immobilien_ferien_and_auslandsimmobilien", "immobilien_garagen_and_stellplaetze", "immobilien_gewerbeimmobilien", "immobilien_grundstuecke_and_gaerten", "immobilien_haeuser_zum_kauf", "immobilien_haeuser_zur_miete", "immobilien_mietwohnungen", "immobilien_neubauprojekte", "immobilien_umzug_and_transport", "immobilien_weitere_immobilien", "haus_and_garten", "haus_and_garten_badezimmer", "haus_and_garten_buero", "haus_and_garten_dekoration", "haus_and_garten_dienstleistungen_haus_and_garten", "haus_and_garten_gartenzubehoer_and_pflanzen", "haus_and_garten_heimtextilien", "haus_and_garten_heimwerken", "haus_and_garten_kueche_and_esszimmer", "haus_and_garten_lampen_and_licht", "haus_and_garten_schlafzimmer", "haus_and_garten_wohnzimmer", "haus_and_garten_weiteres_haus_and_garten", "mode_and_beauty", "mode_and_beauty_beauty_and_gesundheit", "mode_and_beauty_damenbekleidung", "mode_and_beauty_damenschuhe", "mode_and_beauty_herrenbekleidung", "mode_and_beauty_herrenschuhe", "mode_and_beauty_taschen_and_accessoires", "mode_and_beauty_uhren_and_schmuck", "mode_and_beauty_weiteres_mode_and_beauty", "elektronik", "elektronik_audio_and_hifi", "elektronik_dienstleistungen_elektronik", "elektronik_foto", "elektronik_handy_and_telefon", "elektronik_haushaltsgeraete", "elektronik_konsolen", "elektronik_notebooks", "elektronik_pcs", "elektronik_pc_zubehoer_and_software", "elektronik_tablets_and_reader", "elektronik_tv_and_video", "elektronik_videospiele", "elektronik_wearables", "elektronik_wearables_zubehoer", "elektronik_weitere_elektronik", "haustiere", "haustiere_fische", "haustiere_hunde", "haustiere_katzen", "haustiere_kleintiere", "haustiere_nutztiere", "haustiere_pferde", "haustiere_tierbetreuung_and_training", "haustiere_vermisste_tiere", "haustiere_voegel", "haustiere_zubehoer", "familie_kind_and_baby", "familie_kind_and_baby_altenpflege", "familie_kind_and_baby_baby_and_kinderkleidung", "familie_kind_and_baby_baby_and_kinderschuhe", "familie_kind_and_baby_baby_ausstattung", "familie_kind_and_baby_babyschalen_and_kindersitze", "familie_kind_and_baby_babysitter_in_and_kinderbetreuung", "familie_kind_and_baby_kinderwagen_and_buggys", "familie_kind_and_baby_kinderzimmermoebel", "familie_kind_and_baby_spielzeug", "familie_kind_and_baby_weiteres_familie_kind_and_baby", "jobs", "jobs_ausbildung", "jobs_bau_handwerk_and_produktion", "jobs_bueroarbeit_and_verwaltung", "jobs_gastronomie_and_tourismus", "jobs_kundenservice_and_call_center", "jobs_mini_and_nebenjobs", "jobs_praktika", "jobs_sozialer_sektor_and_pflege", "jobs_transport_logistik_and_verkehr", "jobs_vertrieb_einkauf_and_verkauf", "jobs_weitere_jobs", "freizeit_hobby_and_nachbarschaft", "freizeit_hobby_and_nachbarschaft_esoterik_and_spirituelles", "freizeit_hobby_and_nachbarschaft_essen_and_trinken", "freizeit_hobby_and_nachbarschaft_freizeitaktivitaeten", "freizeit_hobby_and_nachbarschaft_handarbeit_basteln_and_kunsthandwerk", "freizeit_hobby_and_nachbarschaft_kunst_and_antiquitaeten", "freizeit_hobby_and_nachbarschaft_kuenstler_in_and_musiker_in", "freizeit_hobby_and_nachbarschaft_modellbau", "freizeit_hobby_and_nachbarschaft_reise_and_eventservices", "freizeit_hobby_and_nachbarschaft_sammeln", "freizeit_hobby_and_nachbarschaft_sport_and_camping", "freizeit_hobby_and_nachbarschaft_troedel", "freizeit_hobby_and_nachbarschaft_verloren_and_gefunden", "freizeit_hobby_and_nachbarschaft_weiteres_freizeit_hobby_and_nachbarschaft", "musik_filme_and_buecher", "musik_filme_and_buecher_buecher_and_zeitschriften", "musik_filme_and_buecher_buero_and_schreibwaren", "musik_filme_and_buecher_comics", "musik_filme_and_buecher_fachbuecher_schule_and_studium", "musik_filme_and_buecher_film_and_dvd", "musik_filme_and_buecher_musik_and_cds", "musik_filme_and_buecher_musikinstrumente", "musik_filme_and_buecher_weitere_musik_filme_and_buecher", "eintrittskarten_and_tickets", "eintrittskarten_and_tickets_bahn_and_oepnv", "eintrittskarten_and_tickets_comedy_and_kabarett", "eintrittskarten_and_tickets_gutscheine", "eintrittskarten_and_tickets_kinder", "eintrittskarten_and_tickets_konzerte", "eintrittskarten_and_tickets_sport", "eintrittskarten_and_tickets_theater_and_musical", "eintrittskarten_and_tickets_weitere_eintrittskarten_and_tickets", "dienstleistungen", "dienstleistungen_altenpflege", "dienstleistungen_auto_rad_and_boot", "dienstleistungen_babysitter_in_and_kinderbetreuung", "dienstleistungen_elektronik", "dienstleistungen_haus_and_garten", "dienstleistungen_kuenstler_in_and_musiker_in", "dienstleistungen_reise_and_event", "dienstleistungen_tierbetreuung_and_training", "dienstleistungen_umzug_and_transport", "dienstleistungen_weitere_dienstleistungen", "verschenken_and_tauschen", "verschenken_and_tauschen_tauschen", "verschenken_and_tauschen_verleihen", "verschenken_and_tauschen_verschenken", "unterricht_and_kurse", "unterricht_and_kurse_beauty_and_gesundheit", "unterricht_and_kurse_computerkurse", "unterricht_and_kurse_esoterik_and_spirituelles", "unterricht_and_kurse_kochen_and_backen", "unterricht_and_kurse_kunst_and_gestaltung", "unterricht_and_kurse_musik_and_gesang", "unterricht_and_kurse_nachhilfe", "unterricht_and_kurse_sportkurse", "unterricht_and_kurse_sprachkurse", "unterricht_and_kurse_tanzkurse", "unterricht_and_kurse_weiterbildung", "unterricht_and_kurse_weitere_unterricht_and_kurse", "nachbarschaftshilfe", "nachbarschaftshilfe_nachbarschaftshilfe" ], "type": "string", "description": "Choose a Kleinanzeigen category.", "default": "alle_kategorien" }, "location": { "title": "City / Region", "type": "string", "description": "Location search text (for example: Berlin). Automatically resolves to location ID." }, "locationId": { "title": "Location ID (Advanced)", "type": "string", "description": "Use this if you already know the Kleinanzeigen location ID" }, "zipCode": { "title": "ZIP Code", "type": "string", "description": "Filter by ZIP code" }, "streetAddress": { "title": "Street / Address", "type": "string", "description": "Filter by street or address text" }, "latitude": { "title": "Latitude", "type": "number", "description": "Use together with Longitude for coordinate-based search" }, "longitude": { "title": "Longitude", "type": "number", "description": "Use together with Latitude for coordinate-based search" }, "distanceKm": { "title": "Radius (km)", "minimum": 1, "type": "integer", "description": "Search radius around location/coordinates", "default": 20 }, "minPrice": { "title": "Min Price", "type": "integer", "description": "Minimum listing price" }, "maxPrice": { "title": "Max Price", "type": "integer", "description": "Maximum listing price" }, "priceType": { "title": "Price Type", "type": "string", "description": "Optional price type filter" }, "adType": { "title": "Offer Type", "enum": [ "", "offered", "wanted" ], "type": "string", "description": "Filter by 'I offer' or 'I search'", "default": "" }, "posterType": { "title": "Seller Type", "enum": [ "", "private", "commercial" ], "type": "string", "description": "Filter by private or commercial sellers", "default": "" }, "sortType": { "title": "Sort By", "enum": [ "", "recommended", "newest", "price_low_to_high", "price_high_to_low", "distance_ascending" ], "type": "string", "description": "Sorting option", "default": "" }, "openHomesType": { "title": "Open Homes Type", "enum": [ "", "today", "this_week", "this_weekend" ], "type": "string", "description": "Open homes time window", "default": "" }, "onlyWithPictures": { "title": "Only With Pictures", "type": "boolean", "description": "Only include listings with images", "default": false }, "excludeExternalListings": { "title": "Exclude External Listings", "type": "boolean", "description": "Hide imported external listings", "default": false }, "includeTopAds": { "title": "Include Top Ads", "type": "boolean", "description": "Include promoted top ads in results", "default": false }, "includeAdvertisingBackfillAds": { "title": "Include Backfill Ads", "type": "boolean", "description": "Include additional advertising backfill listings", "default": false }, "updatedAfter": { "title": "Updated After", "pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$", "type": "string", "description": "Only listings updated on/after this date (YYYY-MM-DD)" }, "updatedBefore": { "title": "Updated Before", "pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$", "type": "string", "description": "Only listings updated on/before this date (YYYY-MM-DD)" }, "sellerUserIds": { "title": "Specific Seller Accounts (Advanced)", "type": "array", "description": "Only include listings from these seller user IDs", "default": [], "items": { "type": "string" } }, "sellerStoreIds": { "title": "Specific Store Accounts (Advanced)", "type": "array", "description": "Only include listings from these store IDs", "default": [], "items": { "type": "string" } }, "fetchDetails": { "title": "Fetch Listing Details", "type": "boolean", "description": "Fetch full listing details for each result", "default": false }, "adIds": { "title": "Specific Listing IDs (Advanced)", "type": "array", "description": "Fetch these listing IDs directly (skips search). Provide raw numeric IDs only.", "items": { "type": "string", "pattern": "^\\d+$" }, "default": [] } } }, "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 } } }, "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 } } } } } } } } } }