# Mobile Cars Search Scraper (`alexist/mobile-cars-search-scraper`) Actor Scrape comprehensive vehicle listings from Mobile.de, Germany's largest automotive marketplace. Extract car specifications, pricing, seller information, and financing options from search results. Ideal for automotive dealers, market analysts, and price comparison platforms. - **URL**: https://apify.com/alexist/mobile-cars-search-scraper.md - **Developed by:** [Alex](https://apify.com/alexist) (community) - **Categories:** Automation, Developer tools, E-commerce - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $0.01 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. 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 ## Mobile.de Cars Search Scraper: Extract German Automotive Marketplace Data **Excerpt:** Scrape comprehensive vehicle listings from Mobile.de, Germany's largest automotive marketplace. Extract car specifications, pricing, seller information, and financing options from search results. Ideal for automotive dealers, market analysts, and price comparison platforms. ### Understanding Mobile.de and Its Automotive Market Value Mobile.de dominates the German automotive marketplace with millions of vehicle listings spanning new cars, used vehicles, motorcycles, and commercial vehicles. As Germany's premier automotive platform, it aggregates inventory from dealerships, private sellers, and fleet operators across Europe, making it essential for understanding vehicle pricing, market supply, and consumer demand patterns. The platform captures unique automotive data: detailed technical specifications (KBA numbers), financing availability, dealer ratings, vehicle condition indicators, and regional pricing variations. For automotive dealers monitoring competitor inventory, market researchers analyzing pricing trends, or developers building price comparison tools, Mobile.de data provides unmatched insights into Europe's largest automotive market. Manually collecting listings across multiple searches, filters, and pages requires hours of repetitive clicking. The Mobile.de Cars Search Scraper automates this process, transforming search result pages into structured datasets ready for analysis, competitive intelligence, or inventory management. ### What This Scraper Extracts and Who Should Use It The Mobile.de Cars Search Scraper processes search result pages—the listings displayed after applying filters for make, model, price range, or location. Unlike detail page scrapers requiring individual vehicle URLs, this tool efficiently captures multiple listings from search pages. **Key extracted data includes:** vehicle identifiers (ID, KBA codes), pricing and financing information, make/model details, seller contact info, media assets (images, videos), listing prominence indicators (eye-catcher status), and vehicle attributes (mileage, year, fuel type). **Target users:** **Automotive dealers** track competitor inventory, pricing strategies, and market availability. **Market researchers** analyze pricing trends, vehicle depreciation, and regional supply patterns. **Price comparison platforms** aggregate listings for consumer-facing tools. **Fleet managers** source vehicles at scale. **Data analytics firms** build predictive models for automotive valuation. ### Input Configuration: Targeting Search Results The scraper processes Mobile.de search result URLs—pages showing filtered vehicle listings, not individual vehicle detail pages. **Example Input:** ```json { "proxy": { "useApifyProxy": true }, "max_items_per_url": 20, "ignore_url_failures": true, "urls": [ "https://suchen.mobile.de/fahrzeuge/search.html?dam=false&isSearchRequest=true&od=up&pageNumber=2&ref=srpNextPage&refId=c855818c-168b-8052-0f51-3b29c69a413e&s=Car&sb=rel&vc=Car" ] } ```` #### Example Screenshot: ![](https://i.ibb.co/MkzFB7sg/Screenshot-from-2025-12-25-23-48-33.png) **Parameter Explanation:** **proxy:** Essential for avoiding detection. Apify's residential proxies mimic genuine user traffic, ensuring reliable scraping without triggering anti-bot mechanisms. **max\_items\_per\_url:** Limits extraction to 20 listings per search page (Mobile.de typically displays 20-30 results per page). Adjust higher (50-100) for comprehensive extraction or lower for testing. **ignore\_url\_failures:** When `true`, continues processing remaining URLs even if some fail—critical for batch scraping multiple search pages where expired listings or pagination issues might occur. **urls array:** Contains search result page URLs. Build these by performing searches on Mobile.de with desired filters (make, model, price, location), then copy resulting URLs. URL parameters like `pageNumber=2` handle pagination. **Pro tip:** Test filters manually on Mobile.de first to ensure relevant results, then systematically collect URLs across multiple pages by incrementing `pageNumber` parameter. ### Complete Output Structure: Field Definitions **Is Eye Catcher:** Boolean indicating premium listing placement. Eye-catcher listings appear prominently, signaling dealer investment in visibility—useful for identifying high-priority inventory or competitive positioning analysis. **Num Images:** Count of listing photos. Higher image counts often correlate with professional dealers and detailed presentations, useful for filtering quality listings or analyzing seller professionalism. **Attr:** Technical attributes object containing detailed specifications (engine size, transmission type, fuel, mileage, first registration). Core data for vehicle matching and specification-based filtering. **Short Title / Sub Title:** Condensed vehicle description (e.g., "BMW 3er 320d") and additional details. Used for display in compact interfaces and quick identification. **Is Video Enabled:** Boolean indicating video content availability. Video-enabled listings suggest premium inventory or dealer marketing sophistication. **Finance Plans:** Array of available financing options including monthly rates, down payment requirements, and terms. Critical for buyers seeking financing and analysts tracking financing penetration rates. **Highlights:** Array of key selling points (e.g., "Full Service History," "Single Owner," "Low Mileage"). Extracted for feature analysis and listing quality assessment. **Seller ID:** Unique dealer/seller identifier. Essential for tracking inventory across specific sellers, analyzing dealer pricing strategies, and building seller performance databases. **Price Rating:** Platform's price competitiveness indicator (typically "fair," "good," "great"). Enables filtering for value opportunities and analyzing price-to-market relationships. **Segment:** Vehicle category (compact, sedan, SUV, luxury). Used for market segmentation analysis and category-specific inventory tracking. **Title:** Full listing title including make, model, variant, and key features. Primary identification field for vehicle matching and search functionality. **VC (Vehicle Category):** Category code (e.g., "Car," "Motorcycle," "Commercial"). Enables filtering by vehicle type when scraping mixed listings. **Category:** Detailed category classification. Provides granular segmentation beyond basic VC field. **ID:** Unique listing identifier assigned by Mobile.de. Primary key for databases, tracking specific listings over time, and avoiding duplicates. **KBA:** German vehicle registration authority code (Kraftfahrt-Bundesamt number). Official vehicle identification enabling precise model matching and regulatory compliance verification. **Custom Dimensions:** Analytics tracking parameters. May contain listing performance metrics or internal classification codes. **Attributes:** Comprehensive specifications object including technical details, equipment, condition ratings. Core data for detailed vehicle analysis. **Contact Info:** Seller contact details including phone numbers, business names, and addresses. Enables direct dealer outreach and geographic analysis of seller distribution. **Email Link:** Seller inquiry email or contact form URL. Facilitates automated lead generation or inquiry systems. **Is Financing Available:** Boolean indicating financing options. Used for filtering finance-eligible vehicles and analyzing financing market penetration. **Is Null Leasing BTO:** Lease-to-own availability flag. Identifies specialized financing products and alternative ownership models. **Leasing Rate:** Monthly lease payment amount. Critical for lease-focused buyers and comparative financing analysis. **Make / Model:** Vehicle manufacturer and model name. Primary filters for inventory segmentation and brand-specific analysis. **Preview Image:** URL to listing thumbnail image. Used for visual display in aggregation platforms and automated image collection. **Price:** Asking price in euros. Core data for pricing analysis, market trends, and valuation models. **Relative URL:** Path to full listing detail page on Mobile.de. Enables accessing complete vehicle information and verification of scraped data. **Supported Leasing Type:** Available lease types (private, commercial). Useful for B2B vs. B2C market segmentation. **Type:** Listing type (dealer, private, fleet). Critical for separating professional inventory from private sales and analyzing market composition. **Sample Output:** ```json [ { "is_eye_catcher": null, "num_images": 49, "attr": { "cn": "DE", "z": "22087", "loc": "Hamburg", "fr": "08/2015", "pw": "165 kW (224 PS)", "ft": "Benzin", "ml": "115.404 km", "cc": "1.984 cm³", "tr": "Automatik", "gi": "10/2027", "ecol": "Schwarz", "eu": "Deutsche Ausführung", "door": "4/5", "sc": "4", "c": "Limousine", "emc": "Euro6", "pvo": "2", "nw": "1.645 kg" }, "short_title": "Audi A5", "sub_title": "Sportback 2.0 TFSI Aut. quattro S-Line-Plus", "is_video_enabled": false, "finance_plans": [ { "type": "AO", "url": "https://www.mobile.de/finanzierung/route/outlink/1?adId=440028268&loanType=balloon&loanDuration=60&downPayment=4199", "short_flow": false, "promotion": false, "show_in_gallery": true, "offer": { "bank_name": "Santander Carcredit", "loan_broker": "Check24 GmbH", "loan_type": "BALLOON", "down_payment": 4199, "credit_term": 60, "yearly_mileage": 10000, "credit_amount": 16800, "interest_rate_nominal": 5.83, "interest_rate_effective": 5.99, "monthly_installment": 226.99, "final_installment": 6929.67, "total_interest": 3522.22, "total_amount": 20322.22, "localized": { "down_payment": "4.199 €", "down_payment_in_percent": "20%", "credit_term": "60", "credit_term_in_years": "5", "yearly_mileage": "10.000", "credit_amount": "16.800 €", "interest_rate_nominal": "5,83%", "interest_rate_effective": "5,99%", "monthly_installment": "227 €", "final_installment": "6.929,67 €", "total_interest": "3.522,22 €", "total_amount": "20.322,22 €", "disclaimer": "Repräsentatives Beispiel gemäß § 17 Abs. 4 PAngV: Nettodarlehensbetrag von 10.000 €, effektiver Jahreszins 7,05%, fester Sollzinssatz 6,83% p.a., Laufzeit 60 Monate, 59 monatliche Raten à 153,07 € und eine Schlussrate à 3.300,00 €, Gesamtbetrag 12.331,29 €", "min_monthly_installment": "227 €", "min_interest_rate_effective": "5,99%", "min_interest_rate_nominal": "5,83%", "max_monthly_installment": "227 €", "max_interest_rate_effective": "5,99%", "max_interest_rate_nominal": "5,83%" }, "min_monthly_installment": 226.99, "min_interest_rate_effective": 5.99, "min_interest_rate_nominal": 5.83, "max_monthly_installment": 226.99, "max_interest_rate_effective": 5.99, "max_interest_rate_nominal": 5.83 }, "budget_status": "FALLBACK", "fallback": true, "down_payment": 0, "loan_duration": 60, "localized": { "down_payment": "0 €" } } ], "highlights": [ "S-Line Plus Paket", "19 Zoll", "Steuerkette neu" ], "seller_id": 12734722, "price_rating": { "rating": "REASONABLE_PRICE", "rating_label": "Fairer Preis", "threshold_labels": [ "13.500 €", "17.600 €", "18.900 €", "21.000 €", "22.600 €", "25.100 €" ], "vehicle_price_offset": 99 }, "segment": "Car", "title": "Audi A5 Sportback 2.0 TFSI Aut. quattro S-Line-Plus", "vc": "Car", "category": "Limousine", "id": 440028268, "kba": { "hsn": "0588", "tsn": "AXK" }, "custom_dimensions": { "10": "platinum" }, "attributes": [ [ { "value": "Unfallfrei", "bold": true }, { "value": "EZ 08/2015" }, { "value": "115.404 km" }, { "value": "165 kW (224 PS)" }, { "value": "Benzin" } ], [] ], "contact_info": { "type_localized": "Händler", "name": "Ronald Richter - Stuwe e.k Automobile", "location": "22087 Hamburg", "rating": { "score": 4.6, "count": 35, "total_count": 321 }, "logo": { "src": "https://img.classistatic.de/api/v1/mo-prod/images/18/18a0a9b3-bdbc-4dbc-8428-1812d6c67c3f?rule=mo-80", "src_set": "https://img.classistatic.de/api/v1/mo-prod/images/18/18a0a9b3-bdbc-4dbc-8428-1812d6c67c3f?rule=mo-80 80w, https://img.classistatic.de/api/v1/mo-prod/images/18/18a0a9b3-bdbc-4dbc-8428-1812d6c67c3f?rule=mo-160 160w, https://img.classistatic.de/api/v1/mo-prod/images/18/18a0a9b3-bdbc-4dbc-8428-1812d6c67c3f?rule=mo-240 240w", "alt": "Ronald Richter - Stuwe e.k Automobile" }, "has_contact_phones": true, "contact_phone": "+49 (0)179 6994103", "country": "DE", "seller_type": "DEALER" }, "email_link": "https://www.mobile.de/checkout/core/440028268?ref=srpContact", "is_financing_available": true, "is_null_leasing_bto": false, "leasing_rate": null, "make": "Audi", "model": "A5", "preview_image": { "src": "https://img.classistatic.de/api/v1/mo-prod/images/44/44fff1ef-868a-4549-85a8-e84edcccc82b?rule=mo-160w", "src_set": "https://img.classistatic.de/api/v1/mo-prod/images/44/44fff1ef-868a-4549-85a8-e84edcccc82b?rule=mo-160w 160w, https://img.classistatic.de/api/v1/mo-prod/images/44/44fff1ef-868a-4549-85a8-e84edcccc82b?rule=mo-240w 240w, https://img.classistatic.de/api/v1/mo-prod/images/44/44fff1ef-868a-4549-85a8-e84edcccc82b?rule=mo-360w 360w, https://img.classistatic.de/api/v1/mo-prod/images/44/44fff1ef-868a-4549-85a8-e84edcccc82b?rule=mo-1024w 1024w", "alt": "Audi A5 Sportback 2.0 TFSI Aut. quattro S-Line-Plus" }, "price": { "gross": "20.999 €", "gross_amount": 20999, "gross_currency": "EUR" }, "relative_url": "/fahrzeuge/details.html?id=440028268&dam=false&isSearchRequest=true&od=up&pageNumber=2&ref=srp&refId=fc45dc61-47ce-fbad-a922-b320c6b5faef&s=Car&sb=rel&searchId=fc45dc61-47ce-fbad-a922-b320c6b5faef&vc=Car", "supported_leasing_type": null, "type": "ad", "from_url": "https://suchen.mobile.de/fahrzeuge/search.html?dam=false&isSearchRequest=true&od=up&pageNumber=2&ref=srpNextPage&refId=c855818c-168b-8052-0f51-3b29c69a413e&s=Car&sb=rel&vc=Car" } ] ``` ### Step-by-Step Usage Guide **1. Define Search Criteria:** Determine target vehicles—specific makes/models, price ranges, regions. Test filters on Mobile.de to ensure relevant results. **2. Build URL List:** Perform searches manually, copy URLs. For large datasets, systematically increment `pageNumber` parameter (page=1, page=2, etc.) to cover multiple result pages. **3. Configure Input:** Create JSON with collected URLs. Set `max_items_per_url` based on needs (20 for standard pages). Enable `ignore_url_failures` for robustness. **4. Execute Scraper:** Launch via Apify console. Monitor real-time progress. Typical run processing 10 search pages (200 listings) completes in 3-5 minutes. **5. Export Data:** Preview results, verify data quality. Export as JSON (databases), CSV (spreadsheets), or Excel (business reports). **6. Handle Pagination:** For hundreds of listings, either include multiple page URLs in one run or increase `max_items_per_url` to auto-handle pagination. **Error handling:** Verify URLs are search result pages, not detail pages. Check that filters produce valid results. Activity log provides detailed error diagnostics. ### Strategic Applications for Automotive Intelligence **Competitive Inventory Monitoring:** Track competitor stock levels, pricing changes, and promotional activities. Identify which dealers dominate specific segments or regions. **Dynamic Pricing Analysis:** Monitor market prices across makes, models, and conditions. Identify pricing opportunities—vehicles listed below market average signal value purchases or motivated sellers. **Market Supply Forecasting:** Analyze listing volumes, days-on-market patterns, and seasonal fluctuations. Predict supply shortages or oversupply for specific vehicle types. **Dealer Performance Benchmarking:** Compare dealer pricing strategies, inventory turnover, and listing quality (image counts, video usage) against market norms. **Financing Penetration Research:** Track financing availability and leasing rate trends across segments. Identify shifts toward alternative ownership models. **Geographic Market Analysis:** Map vehicle availability and pricing by region. Identify arbitrage opportunities—vehicles cheaper in one region vs. another. ### Maximizing Data Value: Best Practices **Schedule Regular Scraping:** Automotive markets change daily. Weekly scraping captures price adjustments, new listings, and sold inventory for trend analysis. **Segment Your Searches:** Create targeted URLs by brand, segment, or price range for cleaner datasets. Example segments: "luxury sedans €50k+," "compact cars Bavaria," "SUVs under 30k km." **Enrich with External Data:** Combine Mobile.de data with vehicle valuation guides (Schwacke, DAT), dealer reviews, and service history databases for comprehensive intelligence. **Quality Checks:** Flag missing critical fields (price, make, model) or suspicious data (unrealistic prices, zero mileage on old cars). **Historical Tracking:** Store timestamped datasets to analyze depreciation curves, time-to-sell patterns, and seasonal pricing variations. **Respect Rate Limits:** Space out large runs to maintain sustainable scraping practices and ensure continued platform access. ### Conclusion The Mobile.de Cars Search Scraper transforms Germany's largest automotive marketplace into actionable intelligence. Whether building inventory databases, conducting pricing research, or monitoring competitive landscapes, this tool delivers comprehensive vehicle data at scale. Start extracting automotive market insights today. # Actor input Schema ## `urls` (type: `array`): Add the URLs of the Cars list urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list. ## `ignore_url_failures` (type: `boolean`): If true, the scraper will continue running even if some URLs fail to be scraped. ## `max_items_per_url` (type: `integer`): The maximum number of items to scrape per URL. ## Actor input object example ```json { "urls": [ "https://suchen.mobile.de/fahrzeuge/search.html?dam=false&isSearchRequest=true&od=up&pageNumber=2&ref=srpNextPage&refId=c855818c-168b-8052-0f51-3b29c69a413e&s=Car&sb=rel&vc=Car" ], "ignore_url_failures": true, "max_items_per_url": 20 } ``` # 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 = { "urls": [ "https://suchen.mobile.de/fahrzeuge/search.html?dam=false&isSearchRequest=true&od=up&pageNumber=2&ref=srpNextPage&refId=c855818c-168b-8052-0f51-3b29c69a413e&s=Car&sb=rel&vc=Car" ], "ignore_url_failures": true, "max_items_per_url": 20 }; // Run the Actor and wait for it to finish const run = await client.actor("alexist/mobile-cars-search-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 = { "urls": ["https://suchen.mobile.de/fahrzeuge/search.html?dam=false&isSearchRequest=true&od=up&pageNumber=2&ref=srpNextPage&refId=c855818c-168b-8052-0f51-3b29c69a413e&s=Car&sb=rel&vc=Car"], "ignore_url_failures": True, "max_items_per_url": 20, } # Run the Actor and wait for it to finish run = client.actor("alexist/mobile-cars-search-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 '{ "urls": [ "https://suchen.mobile.de/fahrzeuge/search.html?dam=false&isSearchRequest=true&od=up&pageNumber=2&ref=srpNextPage&refId=c855818c-168b-8052-0f51-3b29c69a413e&s=Car&sb=rel&vc=Car" ], "ignore_url_failures": true, "max_items_per_url": 20 }' | apify call alexist/mobile-cars-search-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=alexist/mobile-cars-search-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Mobile Cars Search Scraper", "description": "Scrape comprehensive vehicle listings from Mobile.de, Germany's largest automotive marketplace. Extract car specifications, pricing, seller information, and financing options from search results. Ideal for automotive dealers, market analysts, and price comparison platforms.", "version": "0.0", "x-build-id": "OUbfU6BL8bfWPaZtr" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/alexist~mobile-cars-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-alexist-mobile-cars-search-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/alexist~mobile-cars-search-scraper/runs": { "post": { "operationId": "runs-sync-alexist-mobile-cars-search-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/alexist~mobile-cars-search-scraper/run-sync": { "post": { "operationId": "run-sync-alexist-mobile-cars-search-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": { "urls": { "title": "URLs of the Cars list urls to scrape", "type": "array", "description": "Add the URLs of the Cars list urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list.", "items": { "type": "string" } }, "ignore_url_failures": { "title": "Continue running even if some URLs fail to be scraped", "type": "boolean", "description": "If true, the scraper will continue running even if some URLs fail to be scraped." }, "max_items_per_url": { "title": "Max items per URL", "type": "integer", "description": "The maximum number of items to scrape per URL." } } }, "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 } } } } } } } } } } ```