# Kleinanzeigen Scraper ($0.9 per 1000 results) (`igolaizola/kleinanzeigen-scraper`) Actor 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. - **URL**: https://apify.com/igolaizola/kleinanzeigen-scraper.md - **Developed by:** [Iñigo Garcia Olaizola](https://apify.com/igolaizola) (community) - **Categories:** E-commerce, Real estate, Jobs - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $0.70 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Kleinanzeigen Scraper - Germany Classifieds Data Extractor ### 🤖 What this actor does The **Kleinanzeigen Scraper** extracts listing data from **kleinanzeigen.de**, one of Germany's largest classifieds marketplaces. Kleinanzeigen includes many verticals like real estate, vehicles, electronics, home & garden, jobs, and more. This actor can search **any category** via a built-in category dropdown sourced from the live category tree. It returns clean dataset items you can export as JSON, CSV or Excel. ### 💡 Typical use cases - Monitor new listings for any niche or category - Track prices over time in specific cities or ZIP codes - Build lead lists from private or commercial sellers - Collect listing data for market analysis and dashboards - Fetch specific listings directly with `adIds` ### 🚀 How to use 1. Set `maxItems`. 2. Add a `query` (recommended). 3. Optionally choose `category` to target a specific category. 4. Add location filters (`location`, `zipCode`, coordinates, radius). 5. Run the actor and export your dataset. If you set `adIds`, search is skipped and those listing IDs are fetched directly. ### 📝 Input parameters | Parameter | Type | Default | Description | | --- | --- | --- | --- | | `maxItems` | integer | `50` | Maximum number of listings to collect. | | `query` | string | | Search keywords, for example `iphone`, `fahrrad`, `wohnung`. | | `category` | string (enum) | `alle_kategorien` | Category selector with all app categories. Values are mapped to numeric category IDs automatically. | | `location` | string | | City or region text, for example `Berlin`. | | `locationId` | string | | Advanced: Kleinanzeigen location ID if already known. | | `zipCode` | string | | Filter by ZIP code. | | `streetAddress` | string | | Filter by street/address text. | | `latitude` / `longitude` | number | | Coordinate-based search (use together). | | `distanceKm` | integer | `20` | Search radius in kilometers. | | `minPrice` / `maxPrice` | integer | | Price range filter. | | `priceType` | string | | Advanced price type filter used by API. | | `adType` | string (enum) | | `offered` or `wanted`. | | `posterType` | string (enum) | | `private` or `commercial`. | | `sortType` | string (enum) | | Sorting option (recommended, newest, price, distance). | | `openHomesType` | string (enum) | | Open homes period: `today`, `this_week`, or `this_weekend`. | | `onlyWithPictures` | boolean | `false` | Only listings with images. | | `excludeExternalListings` | boolean | `false` | Exclude imported external listings. | | `includeTopAds` | boolean | `false` | Include promoted top ads. | | `includeAdvertisingBackfillAds` | boolean | `false` | Include ad backfill inventory. | | `updatedAfter` | string (date) | | Minimum updated date (`YYYY-MM-DD`). | | `updatedBefore` | string (date) | | Maximum updated date (`YYYY-MM-DD`). | | `sellerUserIds` | array | `[]` | Advanced: only specific seller user IDs. | | `sellerStoreIds` | array | `[]` | Advanced: only specific store IDs. | | `fetchDetails` | boolean | `false` | Fetch full ad details for each listing (`_details`). | | `adIds` | array | `[]` | Advanced direct mode. Numeric listing IDs only. | ### 🔎 Example input (search mode) ```json { "maxItems": 100, "query": "iphone", "location": "Berlin", "distanceKm": 20, "minPrice": 100, "maxPrice": 800, "posterType": "private", "sortType": "newest", "onlyWithPictures": true, "updatedAfter": "2026-04-01", "fetchDetails": false } ```` ### 🗂️ Example input (search with category) ```json { "maxItems": 100, "query": "wohnung", "category": "immobilien_mietwohnungen", "location": "Berlin", "sortType": "newest" } ``` ### 🎯 Example input (direct IDs mode) ```json { "maxItems": 3, "adIds": ["3364756114", "3364700001", "3364609999"], "fetchDetails": true } ``` ### 📊 Output Each dataset item is one listing. Common fields include: - `id` - `title.value` - `price.amount.value` - `price.price-type.value` - `poster-type.value` - `category.id` - `ad-address.zip-code.value` - `ad-address.state.value` - `store-title.value` - `start-date-time.value` - `_meta.url` (listing URL) - `_meta.image` (main image URL) If `fetchDetails` is enabled, each item also includes `_details` with full listing payload. ### ⚠️ Notes - `fetchDetails` adds extra requests per listing, so runs are slower and more expensive. - Date filters accept `YYYY-MM-DD` and are normalized to day boundaries internally. # Actor input Schema ## `maxItems` (type: `integer`): Maximum number of listings to collect ## `query` (type: `string`): Free text search (for example: wohnung, haus, penthouse) ## `category` (type: `string`): Choose a Kleinanzeigen category. ## `location` (type: `string`): Location search text (for example: Berlin). Automatically resolves to location ID. ## `locationId` (type: `string`): Use this if you already know the Kleinanzeigen location ID ## `zipCode` (type: `string`): Filter by ZIP code ## `streetAddress` (type: `string`): Filter by street or address text ## `latitude` (type: `number`): Use together with Longitude for coordinate-based search ## `longitude` (type: `number`): Use together with Latitude for coordinate-based search ## `distanceKm` (type: `integer`): Search radius around location/coordinates ## `minPrice` (type: `integer`): Minimum listing price ## `maxPrice` (type: `integer`): Maximum listing price ## `priceType` (type: `string`): Optional price type filter ## `adType` (type: `string`): Filter by 'I offer' or 'I search' ## `posterType` (type: `string`): Filter by private or commercial sellers ## `sortType` (type: `string`): Sorting option ## `openHomesType` (type: `string`): Open homes time window ## `onlyWithPictures` (type: `boolean`): Only include listings with images ## `excludeExternalListings` (type: `boolean`): Hide imported external listings ## `includeTopAds` (type: `boolean`): Include promoted top ads in results ## `includeAdvertisingBackfillAds` (type: `boolean`): Include additional advertising backfill listings ## `updatedAfter` (type: `string`): Only listings updated on/after this date (YYYY-MM-DD) ## `updatedBefore` (type: `string`): Only listings updated on/before this date (YYYY-MM-DD) ## `sellerUserIds` (type: `array`): Only include listings from these seller user IDs ## `sellerStoreIds` (type: `array`): Only include listings from these store IDs ## `fetchDetails` (type: `boolean`): Fetch full listing details for each result ## `adIds` (type: `array`): Fetch these listing IDs directly (skips search). Provide raw numeric IDs only. ## Actor input object example ```json { "maxItems": 100, "query": "wohnung", "category": "alle_kategorien", "location": "Berlin", "distanceKm": 20, "adType": "", "posterType": "", "sortType": "", "openHomesType": "", "onlyWithPictures": false, "excludeExternalListings": false, "includeTopAds": false, "includeAdvertisingBackfillAds": false, "sellerUserIds": [], "sellerStoreIds": [], "fetchDetails": false, "adIds": [] } ``` # Actor output Schema ## `results` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "query": "wohnung", "location": "Berlin" }; // Run the Actor and wait for it to finish const run = await client.actor("igolaizola/kleinanzeigen-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "query": "wohnung", "location": "Berlin", } # Run the Actor and wait for it to finish run = client.actor("igolaizola/kleinanzeigen-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "query": "wohnung", "location": "Berlin" }' | apify call igolaizola/kleinanzeigen-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=igolaizola/kleinanzeigen-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "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 } } } } } } } } } } ```