# Autoscout24 $0.8💰 Powerful Filters + Deep Search (`abotapi/autoscout24-scraper`) Actor From $0.8/1K. A lean, production-grade scraper for autoscout24.com. Point it at a search, get back clean JSON with 30+ fields per vehicle. Designed for dealers, market analysts, valuation pipelines, lead generation, and anyone who needs autoscout24 data on tap. - **URL**: https://apify.com/abotapi/autoscout24-scraper.md - **Developed by:** [AbotAPI](https://apify.com/abotapi) (community) - **Categories:** Lead generation, Developer tools, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: 5.00 out of 5 stars ## Pricing from $0.80 / 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 ## AutoScout24 Scraper **A lean, production-grade scraper for Europe's largest used-car marketplace.** Point it at a search, get back clean JSON with 30+ fields per vehicle. Designed for dealers, market analysts, valuation pipelines, lead generation, and anyone who needs autoscout24 data on tap. ### Why this scraper - ⚡ **Sub-second per listing.** 20 listings in ~1 second; 1,000 listings in ~3 minutes. - 💸 **Cents per thousand.** Designed to run cleanly on the **free Apify plan** with the default proxy configuration — no upgrade needed for typical workloads. - 🎯 **30+ structured fields per car.** Make, model, year, price, mileage, transmission, fuel, body type, location, dealer name + phone, ratings, image URLs. - 📞 **Dealer contact enrichment** (optional). Add **email, VAT ID, registered address, homepage, and opening hours** for every dealer — pulled once per dealer and reused, so the cost doesn't scale with listing count. - 📑 **Real multi-page pagination.** Walks page 2, 3, 4+ with stable de-duplication. Drop in 5 URLs, get 5 paginated runs, no duplicates. - 🌍 **Pan-European coverage.** Filter listings by country across 8 markets — Germany, Austria, Belgium, Spain, France, Italy, Luxembourg, Netherlands. - 🔗 **Two flexible input modes.** Filter dropdowns or paste a URL straight from your browser. ### What you can do with it - **Price intelligence:** track asking prices for specific make/model/year/trim across countries, detect trends. - **Dealer analysis:** pull every listing from a dealer (with their email + VAT) and monitor inventory turnover. - **Lead generation:** extract dealer contacts (name, phone, WhatsApp, email) from fresh listings. - **Market research:** compare fuel-mix, body-style share, or mileage distribution across markets. - **Valuation models:** feed your pricing engine with always-fresh inventory + dealer metadata. - **Inventory mirroring:** sync dealer stock into your CRM or marketplace. ### Two ways to search #### 1. Search by filters (easiest) Pick Make, Model, Country, Price range, Year range, Mileage range, Fuel type, Transmission, Body type. The scraper builds the URL and paginates forward for you. Want "used Mercedes A-Class under €30,000 in Germany, cheapest first"? Five inputs, done. #### 2. Direct URLs (power users) Found a search on autoscout24.com that nails exactly what you want? Paste the URL directly. Each URL paginates independently, so you can drop in many at once: ```` https://www.autoscout24.com/lst/bmw/x5?fregfrom=2020\&pricefrom=20000\&priceto=80000 https://www.autoscout24.com/lst/audi/a4?fuel=D\&gear=A https://www.autoscout24.com/lst/porsche/911 ```` ### Filter coverage | Filter | Search mode | URL mode | |---|:-:|:-:| | Make + Model | ✅ | ✅ via URL | | Country (multi-select: DE / AT / BE / ES / FR / IT / LU / NL) | ✅ | ✅ via URL | | Vehicle state (New / Used / Both) | ✅ | ✅ via URL | | Body type | ✅ | ✅ via URL | | Fuel type (multi-select) | ✅ | ✅ via URL | | Transmission | ✅ | ✅ via URL | | Price range, Year range, Mileage range, Power range | ✅ | ✅ via URL | | Sort order | ✅ | ✅ via URL | ### What you get (30+ fields per car) **Core:** `listingId`, `url`, `title`, `make`, `model`, `modelGroup`, `variant`, `modelVersion`, `year`, `firstRegistration` **Specs:** `bodyType`, `transmission`, `fuel`, `engineDisplacement`, `powerKw`, `powerHp`, `mileageKm`, `mileageDisplay` **Price:** `price`, `priceDisplay`, `currency`, `priceNegotiable`, `taxDeductible`, `netPrice`, `vatRate` **Listing metadata:** `isOfferNew`, `offerType`, `vehicleType`, `isDeliverable`, `createdAt`, `leadsRange`, `offerReference` **Location:** `country`, `city`, `zip`, `street`, `latitude`, `longitude` **Seller:** `sellerType`, `sellerId`, `companyName`, `contactName`, `phones`, `whatsappNumber`, `dealerLogoUrl`, `dealerInfoPageUrl`, `dealerImprintUrl`, `dealerStockUrl`, `dealerSince`, `ratingsCount`, `ratingsStars` **Media:** `images` (high-res URLs), `imageCount`, `youtubeLink`, `twinnerUrl`, `hasThreeSixtyContent` **Optional vehicle enrichment** — enable `Fetch full details` to add: `color`, `paintType`, `upholstery`, `upholsteryColor`, `seats`, `doors`, `cylinders`, `drivetrain`, `fuelConsumptionCombined`, `co2EmissionGramPerKm`, `electricRangeKm`, `previousOwners`, `hadAccident`, `hasFullServiceHistory`, `newInspection`, `warranty`, `equipment` (full feature list, often 50–100 items), `description` (dealer's own free-text). **Optional dealer enrichment** — enable `Fetch dealer email, VAT, address` to add: `dealerEmail`, `dealerVatId`, `dealerAddress`, `dealerHomepage`, `dealerOpeningHours`. Cached per dealer — a 1,000-listing run from 50 dealers only adds ~50 extra requests. #### Example output (illustrative — values shown are placeholders, not a real listing) ```json { "listingId": "00000000-0000-0000-0000-000000000000", "url": "https://www.autoscout24.com/offers/example-listing-00000000-0000-0000-0000-000000000000", "title": "BMW X5", "make": "BMW", "model": "X5", "modelGroup": "X5", "variant": "xDrive25d", "year": 2020, "firstRegistration": "03/2020", "bodyType": "SUV/Off-Road/Pick-Up", "transmission": "Automatic", "fuel": "Diesel", "powerKw": 170, "powerHp": 231, "mileageKm": 120000, "price": 35000, "priceDisplay": "€ 35,000", "currency": "EUR", "country": "DE", "city": "EXAMPLE_CITY", "zip": "00000", "latitude": 0.0, "longitude": 0.0, "createdAt": "2026-04-01T00:00:00.000Z", "sellerType": "Dealer", "companyName": "EXAMPLE_DEALER_GMBH", "phones": [{ "phoneType": "Office", "formattedNumber": "+00 000 - 0000000" }], "whatsappNumber": "+00 000 - 0000000", "dealerEmail": "contact@example-dealer.invalid", "dealerVatId": "DE000000000", "dealerAddress": "Example Street 1, Example City, DE", "color": "Grey", "seats": 5, "doors": 5, "drivetrain": "4WD", "fuelConsumptionCombined": "5.60 l/100 km (comb.)", "previousOwners": 1, "hasFullServiceHistory": true, "imageCount": 15, "scrapedAt": "2026-04-25T10:00:00.000Z" } ```` ### Run limits & cost control - **Maximum Listings:** hard cap across all searches (default 50) - **Maximum Pages:** per-search page cap, ~20 listings per page (default 5, max 200) - **Fetch full details:** opt-in, adds one HTTP request per listing - **Fetch dealer email/VAT/address:** opt-in, adds one HTTP request per *unique dealer* (not per listing) thanks to the dealer cache ### Proxy setup The default proxy configuration works out of the box on the free Apify plan. No setup required. If you'd like to route through your own proxy pool, paste your proxy URLs in the Proxy field. ### Support Questions, feature requests, or issues? Open a ticket on the actor page. # Actor input Schema ## `mode` (type: `string`): Choose how to find listings. Only fields belonging to the chosen mode are used. ## `urls` (type: `array`): AutoScout24 search URLs to scrape. Each URL auto-paginates forward until Maximum Pages or Maximum Listings. Ignored in Search mode. Example: https://www.autoscout24.com/lst/bmw/x5?fregfrom=2020 ## `make` (type: `string`): Manufacturer slug as it appears in the URL, e.g. bmw, audi, mercedes-benz, volkswagen, porsche. Leave empty for all makes. (Search mode only — ignored in URL mode.) ## `model` (type: `string`): Model slug as it appears in the URL, e.g. x5, a4, c-klasse, golf, 911. Requires a Make. (Search mode only — ignored in URL mode.) ## `countries` (type: `array`): Listing country (multi-select). Default = all 8 supported countries. (Search mode only — ignored in URL mode.) ## `ustate` (type: `string`): New / Used / Both. (Search mode only — ignored in URL mode.) ## `bodyType` (type: `string`): Body shape. Codes verified against autoscout24's own taxonomy. (Search mode only — ignored in URL mode.) ## `fuelTypes` (type: `array`): AutoScout24 fuel codes (multi-select). Verified by single-fuel probe: B = Gasoline, D = Diesel, E = Electric, 2 = Hybrid Electric/Gasoline, 3 = Hybrid Electric/Diesel, L = LPG, C = CNG, M = Ethanol (E85), H = Hydrogen, O = Other. Leave empty for any fuel. (Search mode only — ignored in URL mode.) ## `transmission` (type: `string`): Gearbox type. (Search mode only — ignored in URL mode.) ## `priceMin` (type: `integer`): Lower bound for price. (Search mode only — ignored in URL mode.) ## `priceMax` (type: `integer`): Upper bound for price. (Search mode only — ignored in URL mode.) ## `yearMin` (type: `integer`): Oldest first-registration year. (Search mode only — ignored in URL mode.) ## `yearMax` (type: `integer`): Newest first-registration year. (Search mode only — ignored in URL mode.) ## `kmMin` (type: `integer`): Lower bound for mileage. (Search mode only — ignored in URL mode.) ## `kmMax` (type: `integer`): Upper bound for mileage. (Search mode only — ignored in URL mode.) ## `powerMinKw` (type: `integer`): Lower bound for engine power in kW. (1 hp ≈ 0.735 kW) (Search mode only — ignored in URL mode.) ## `powerMaxKw` (type: `integer`): Upper bound for engine power in kW. (Search mode only — ignored in URL mode.) ## `sortBy` (type: `string`): Sort order. AutoScout24 also offers default 'standard' (relevance). (Search mode only — in URL mode the sort comes from the URL itself.) ## `fetchDetails` (type: `boolean`): Fetch each listing's detail page for ~100 extra fields (full equipment list, fuel consumption, body color, paint type, electric range, drivetrain, dealer description, coordinates, WhatsApp, listing creation timestamp). Adds ~1 HTTP request per listing. ## `fetchDealerInfo` (type: `boolean`): Fetch each unique dealer's legal Imprint page to extract email, VAT ID, registered address, homepage URL, and opening hours. The fetch is cached per dealer so a 1000-listing run from 50 dealers only costs ~50 extra requests. Requires `Fetch full details` to be on (the imprint URL comes from the detail page). ## `maxListings` (type: `integer`): Stop after scraping this many listings across the whole run. ## `maxPages` (type: `integer`): Per-search page cap (~20 listings per page). AutoScout24 caps results at page 200 (4000 listings) — narrow your filters to see further. ## `proxyConfiguration` (type: `object`): AutoScout24 has no anti-bot wall — datacenter proxies work fine. The default Apify AUTO group is sufficient and works on the free tier. Residential proxies are not required, but can help if you hit a regional rate limit. ## Actor input object example ```json { "mode": "search", "urls": [ "https://www.autoscout24.com/lst/bmw/x5?fregfrom=2020" ], "countries": [], "ustate": "both", "bodyType": "", "fuelTypes": [], "transmission": "", "sortBy": "standard", "fetchDetails": false, "fetchDealerInfo": false, "maxListings": 20, "maxPages": 200, "proxyConfiguration": { "useApifyProxy": true } } ``` # Actor output Schema ## `overview` (type: `string`): No description ## `seller` (type: `string`): No description ## `media` (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 = { "mode": "search", "urls": [ "https://www.autoscout24.com/lst/bmw/x5?fregfrom=2020" ], "proxyConfiguration": { "useApifyProxy": true } }; // Run the Actor and wait for it to finish const run = await client.actor("abotapi/autoscout24-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 = { "mode": "search", "urls": ["https://www.autoscout24.com/lst/bmw/x5?fregfrom=2020"], "proxyConfiguration": { "useApifyProxy": True }, } # Run the Actor and wait for it to finish run = client.actor("abotapi/autoscout24-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 '{ "mode": "search", "urls": [ "https://www.autoscout24.com/lst/bmw/x5?fregfrom=2020" ], "proxyConfiguration": { "useApifyProxy": true } }' | apify call abotapi/autoscout24-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=abotapi/autoscout24-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Autoscout24 $0.8💰 Powerful Filters + Deep Search", "description": "From $0.8/1K. A lean, production-grade scraper for autoscout24.com. Point it at a search, get back clean JSON with 30+ fields per vehicle. Designed for dealers, market analysts, valuation pipelines, lead generation, and anyone who needs autoscout24 data on tap.", "version": "1.0", "x-build-id": "AbpCZ9yzIIOgDx9gI" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/abotapi~autoscout24-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-abotapi-autoscout24-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/abotapi~autoscout24-scraper/runs": { "post": { "operationId": "runs-sync-abotapi-autoscout24-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/abotapi~autoscout24-scraper/run-sync": { "post": { "operationId": "run-sync-abotapi-autoscout24-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": [ "mode" ], "properties": { "mode": { "title": "Search mode", "enum": [ "search", "url" ], "type": "string", "description": "Choose how to find listings. Only fields belonging to the chosen mode are used.", "default": "search" }, "urls": { "title": "URLs (URL mode only)", "type": "array", "description": "AutoScout24 search URLs to scrape. Each URL auto-paginates forward until Maximum Pages or Maximum Listings. Ignored in Search mode. Example: https://www.autoscout24.com/lst/bmw/x5?fregfrom=2020", "items": { "type": "string" } }, "make": { "title": "Make", "type": "string", "description": "Manufacturer slug as it appears in the URL, e.g. bmw, audi, mercedes-benz, volkswagen, porsche. Leave empty for all makes. (Search mode only — ignored in URL mode.)" }, "model": { "title": "Model", "type": "string", "description": "Model slug as it appears in the URL, e.g. x5, a4, c-klasse, golf, 911. Requires a Make. (Search mode only — ignored in URL mode.)" }, "countries": { "title": "Countries", "uniqueItems": true, "type": "array", "description": "Listing country (multi-select). Default = all 8 supported countries. (Search mode only — ignored in URL mode.)", "items": { "type": "string", "enum": [ "D", "A", "B", "E", "F", "I", "L", "NL" ], "enumTitles": [ "Germany", "Austria", "Belgium", "Spain", "France", "Italy", "Luxembourg", "Netherlands" ] }, "default": [] }, "ustate": { "title": "Vehicle state", "enum": [ "both", "new", "used" ], "type": "string", "description": "New / Used / Both. (Search mode only — ignored in URL mode.)", "default": "both" }, "bodyType": { "title": "Body type", "enum": [ "", "1", "2", "3", "4", "5", "6", "7", "12", "13" ], "type": "string", "description": "Body shape. Codes verified against autoscout24's own taxonomy. (Search mode only — ignored in URL mode.)", "default": "" }, "fuelTypes": { "title": "Fuel type(s)", "uniqueItems": true, "type": "array", "description": "AutoScout24 fuel codes (multi-select). Verified by single-fuel probe: B = Gasoline, D = Diesel, E = Electric, 2 = Hybrid Electric/Gasoline, 3 = Hybrid Electric/Diesel, L = LPG, C = CNG, M = Ethanol (E85), H = Hydrogen, O = Other. Leave empty for any fuel. (Search mode only — ignored in URL mode.)", "items": { "type": "string", "enum": [ "B", "D", "E", "2", "3", "L", "C", "M", "H", "O" ], "enumTitles": [ "Gasoline (Petrol)", "Diesel", "Electric", "Hybrid (Electric/Gasoline)", "Hybrid (Electric/Diesel)", "LPG", "CNG", "Ethanol (E85)", "Hydrogen", "Other" ] }, "default": [] }, "transmission": { "title": "Transmission", "enum": [ "", "A", "M", "S" ], "type": "string", "description": "Gearbox type. (Search mode only — ignored in URL mode.)", "default": "" }, "priceMin": { "title": "Minimum price (EUR)", "minimum": 0, "type": "integer", "description": "Lower bound for price. (Search mode only — ignored in URL mode.)" }, "priceMax": { "title": "Maximum price (EUR)", "minimum": 0, "type": "integer", "description": "Upper bound for price. (Search mode only — ignored in URL mode.)" }, "yearMin": { "title": "Minimum first registration year", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "Oldest first-registration year. (Search mode only — ignored in URL mode.)" }, "yearMax": { "title": "Maximum first registration year", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "Newest first-registration year. (Search mode only — ignored in URL mode.)" }, "kmMin": { "title": "Minimum mileage (km)", "minimum": 0, "type": "integer", "description": "Lower bound for mileage. (Search mode only — ignored in URL mode.)" }, "kmMax": { "title": "Maximum mileage (km)", "minimum": 0, "type": "integer", "description": "Upper bound for mileage. (Search mode only — ignored in URL mode.)" }, "powerMinKw": { "title": "Minimum power (kW)", "minimum": 0, "type": "integer", "description": "Lower bound for engine power in kW. (1 hp ≈ 0.735 kW) (Search mode only — ignored in URL mode.)" }, "powerMaxKw": { "title": "Maximum power (kW)", "minimum": 0, "type": "integer", "description": "Upper bound for engine power in kW. (Search mode only — ignored in URL mode.)" }, "sortBy": { "title": "Sort order", "enum": [ "standard", "price", "price_desc", "age", "age_desc", "mileage", "mileage_desc", "year", "year_desc" ], "type": "string", "description": "Sort order. AutoScout24 also offers default 'standard' (relevance). (Search mode only — in URL mode the sort comes from the URL itself.)", "default": "standard" }, "fetchDetails": { "title": "Fetch full details", "type": "boolean", "description": "Fetch each listing's detail page for ~100 extra fields (full equipment list, fuel consumption, body color, paint type, electric range, drivetrain, dealer description, coordinates, WhatsApp, listing creation timestamp). Adds ~1 HTTP request per listing.", "default": false }, "fetchDealerInfo": { "title": "Fetch dealer email, VAT, address (from imprint)", "type": "boolean", "description": "Fetch each unique dealer's legal Imprint page to extract email, VAT ID, registered address, homepage URL, and opening hours. The fetch is cached per dealer so a 1000-listing run from 50 dealers only costs ~50 extra requests. Requires `Fetch full details` to be on (the imprint URL comes from the detail page).", "default": false }, "maxListings": { "title": "Maximum listings", "minimum": 1, "type": "integer", "description": "Stop after scraping this many listings across the whole run.", "default": 20 }, "maxPages": { "title": "Maximum pages per search", "minimum": 1, "maximum": 200, "type": "integer", "description": "Per-search page cap (~20 listings per page). AutoScout24 caps results at page 200 (4000 listings) — narrow your filters to see further.", "default": 200 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "AutoScout24 has no anti-bot wall — datacenter proxies work fine. The default Apify AUTO group is sufficient and works on the free tier. Residential proxies are not required, but can help if you hit a regional rate limit." } } }, "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 } } } } } } } } } } ```