# Automobile Cars Search Scraper (`stealth_mode/automobile-cars-search-scraper`) Actor Scrape car listings from Automobile.it with ease. Collect prices, locations, dealer info, images, and 30+ fields per listing — perfect for automotive analysts, dealers, and price comparison platforms targeting the Italian car market. - **URL**: https://apify.com/stealth\_mode/automobile-cars-search-scraper.md - **Developed by:** [Stealth mode](https://apify.com/stealth_mode) (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 $2.00 / 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 ## Automobile.it Car Search Scraper: Extract Italian Car Listings at Scale --- ### What Is Automobile.it? Automobile.it is one of Italy's leading online automotive marketplaces, hosting thousands of new and used car listings from both private sellers and professional dealers. Manually gathering listing data for market analysis or price benchmarking is impractical at scale. The **Automobile.it Car Search Scraper** automates this, delivering structured, ready-to-use records from any search results page. --- ### Overview The **Automobile.it Scraper** extracts car listings from search and browse pages, transforming them into clean structured datasets. Ideal for: - **Automotive dealers** monitoring competitor pricing and inventory - **Price comparison platforms** aggregating Italian market listings - **Market researchers** analyzing used car trends by make, region, or seller type - **Data engineers** feeding automotive data pipelines --- ### Input Format ```json { "urls": [ "https://www.automobile.it/annunci/page-2?valutazione_del_venditore=tutti" ], "ignore_url_failures": true, "max_items_per_url": 50 } ```` | Field | Type | Description | |---|---|---| | `urls` | `array` | One or more Automobile.it search/listing page URLs. Supports bulk entry. Example: `https://www.automobile.it/annunci/page-2?valutazione_del_venditore=tutti` | | `ignore_url_failures` | `boolean` | If `true`, the scraper skips failed URLs and continues the run instead of stopping. Recommended for bulk jobs. Default: `true` | | `max_items_per_url` | `integer` | Maximum number of listings to collect per URL. Default: `20`. Set higher (e.g., `50`) for fuller page coverage | > **Tip:** Use Automobile.it's built-in filters (make, price range, region, seller type) in the URL before pasting into `urls` to pre-scope your dataset. *** ### Output Format **Sample output** ```json { "id": 180207089, "pictures": [ { "hash": "https://media-ys.automobile.it/api/v1/am-ad/images/90e1e3d300061b5bc6ab283cb4e65c08", "sizes": { "b_i_g": { "href": "https://media-ys.automobile.it/api/v1/am-ad/images/90e1e3d300061b5bc6ab283cb4e65c08?rule=ad-568.jpeg", "width": null, "height": null }, "m_i_n_i": { "href": "https://media-ys.automobile.it/api/v1/am-ad/images/90e1e3d300061b5bc6ab283cb4e65c08?rule=ad-140.jpeg", "width": null, "height": null }, "o_r_i_g": { "href": "https://media-ys.automobile.it/api/v1/am-ad/images/90e1e3d300061b5bc6ab283cb4e65c08?rule=ad-600.jpeg", "width": null, "height": null }, "m_e_d": { "href": "https://media-ys.automobile.it/api/v1/am-ad/images/90e1e3d300061b5bc6ab283cb4e65c08?rule=ad-372.jpeg", "width": null, "height": null }, "x_l": { "href": "https://media-ys.automobile.it/api/v1/am-ad/images/90e1e3d300061b5bc6ab283cb4e65c08?rule=ad-1280.jpeg", "width": null, "height": null }, "t_h_u_m_b_n_a_i_l": { "href": "https://media-ys.automobile.it/api/v1/am-ad/images/90e1e3d300061b5bc6ab283cb4e65c08?rule=ad-118.jpeg", "width": null, "height": null } } }, { "hash": "https://media-ys.automobile.it/api/v1/am-ad/images/a0ec169f51793db4e06be8323fc3e961", "sizes": { "b_i_g": { "href": "https://media-ys.automobile.it/api/v1/am-ad/images/a0ec169f51793db4e06be8323fc3e961?rule=ad-568.jpeg", "width": null, "height": null }, "m_i_n_i": { "href": "https://media-ys.automobile.it/api/v1/am-ad/images/a0ec169f51793db4e06be8323fc3e961?rule=ad-140.jpeg", "width": null, "height": null }, "o_r_i_g": { "href": "https://media-ys.automobile.it/api/v1/am-ad/images/a0ec169f51793db4e06be8323fc3e961?rule=ad-600.jpeg", "width": null, "height": null }, "m_e_d": { "href": "https://media-ys.automobile.it/api/v1/am-ad/images/a0ec169f51793db4e06be8323fc3e961?rule=ad-372.jpeg", "width": null, "height": null }, "x_l": { "href": "https://media-ys.automobile.it/api/v1/am-ad/images/a0ec169f51793db4e06be8323fc3e961?rule=ad-1280.jpeg", "width": null, "height": null }, "t_h_u_m_b_n_a_i_l": { "href": "https://media-ys.automobile.it/api/v1/am-ad/images/a0ec169f51793db4e06be8323fc3e961?rule=ad-118.jpeg", "width": null, "height": null } } }, { "hash": "https://media-ys.automobile.it/api/v1/am-ad/images/3d0d7bdfe3bcecfdd761624f5a146b05", "sizes": { "b_i_g": { "href": "https://media-ys.automobile.it/api/v1/am-ad/images/3d0d7bdfe3bcecfdd761624f5a146b05?rule=ad-568.jpeg", "width": null, "height": null }, "m_i_n_i": { "href": "https://media-ys.automobile.it/api/v1/am-ad/images/3d0d7bdfe3bcecfdd761624f5a146b05?rule=ad-140.jpeg", "width": null, "height": null }, "o_r_i_g": { "href": "https://media-ys.automobile.it/api/v1/am-ad/images/3d0d7bdfe3bcecfdd761624f5a146b05?rule=ad-600.jpeg", "width": null, "height": null }, "m_e_d": { "href": "https://media-ys.automobile.it/api/v1/am-ad/images/3d0d7bdfe3bcecfdd761624f5a146b05?rule=ad-372.jpeg", "width": null, "height": null }, "x_l": { "href": "https://media-ys.automobile.it/api/v1/am-ad/images/3d0d7bdfe3bcecfdd761624f5a146b05?rule=ad-1280.jpeg", "width": null, "height": null }, "t_h_u_m_b_n_a_i_l": { "href": "https://media-ys.automobile.it/api/v1/am-ad/images/3d0d7bdfe3bcecfdd761624f5a146b05?rule=ad-118.jpeg", "width": null, "height": null } } }, { "hash": "https://media-ys.automobile.it/api/v1/am-ad/images/14e5e7b497c0a736280fec0522a05932", "sizes": { "b_i_g": { "href": "https://media-ys.automobile.it/api/v1/am-ad/images/14e5e7b497c0a736280fec0522a05932?rule=ad-568.jpeg", "width": null, "height": null }, "m_i_n_i": { "href": "https://media-ys.automobile.it/api/v1/am-ad/images/14e5e7b497c0a736280fec0522a05932?rule=ad-140.jpeg", "width": null, "height": null }, "o_r_i_g": { "href": "https://media-ys.automobile.it/api/v1/am-ad/images/14e5e7b497c0a736280fec0522a05932?rule=ad-600.jpeg", "width": null, "height": null }, "m_e_d": { "href": "https://media-ys.automobile.it/api/v1/am-ad/images/14e5e7b497c0a736280fec0522a05932?rule=ad-372.jpeg", "width": null, "height": null }, "x_l": { "href": "https://media-ys.automobile.it/api/v1/am-ad/images/14e5e7b497c0a736280fec0522a05932?rule=ad-1280.jpeg", "width": null, "height": null }, "t_h_u_m_b_n_a_i_l": { "href": "https://media-ys.automobile.it/api/v1/am-ad/images/14e5e7b497c0a736280fec0522a05932?rule=ad-118.jpeg", "width": null, "height": null } } }, { "hash": "https://media-ys.automobile.it/api/v1/am-ad/images/54f84509e3acd5a51ecec9ed6f26e735", "sizes": { "b_i_g": { "href": "https://media-ys.automobile.it/api/v1/am-ad/images/54f84509e3acd5a51ecec9ed6f26e735?rule=ad-568.jpeg", "width": null, "height": null }, "m_i_n_i": { "href": "https://media-ys.automobile.it/api/v1/am-ad/images/54f84509e3acd5a51ecec9ed6f26e735?rule=ad-140.jpeg", "width": null, "height": null }, "o_r_i_g": { "href": "https://media-ys.automobile.it/api/v1/am-ad/images/54f84509e3acd5a51ecec9ed6f26e735?rule=ad-600.jpeg", "width": null, "height": null }, "m_e_d": { "href": "https://media-ys.automobile.it/api/v1/am-ad/images/54f84509e3acd5a51ecec9ed6f26e735?rule=ad-372.jpeg", "width": null, "height": null }, "x_l": { "href": "https://media-ys.automobile.it/api/v1/am-ad/images/54f84509e3acd5a51ecec9ed6f26e735?rule=ad-1280.jpeg", "width": null, "height": null }, "t_h_u_m_b_n_a_i_l": { "href": "https://media-ys.automobile.it/api/v1/am-ad/images/54f84509e3acd5a51ecec9ed6f26e735?rule=ad-118.jpeg", "width": null, "height": null } } }, { "hash": "https://media-ys.automobile.it/api/v1/am-ad/images/6d3b2f3af24c1c41b4095edca7347540", "sizes": { "b_i_g": { "href": "https://media-ys.automobile.it/api/v1/am-ad/images/6d3b2f3af24c1c41b4095edca7347540?rule=ad-568.jpeg", "width": null, "height": null }, "m_i_n_i": { "href": "https://media-ys.automobile.it/api/v1/am-ad/images/6d3b2f3af24c1c41b4095edca7347540?rule=ad-140.jpeg", "width": null, "height": null }, "o_r_i_g": { "href": "https://media-ys.automobile.it/api/v1/am-ad/images/6d3b2f3af24c1c41b4095edca7347540?rule=ad-600.jpeg", "width": null, "height": null }, "m_e_d": { "href": "https://media-ys.automobile.it/api/v1/am-ad/images/6d3b2f3af24c1c41b4095edca7347540?rule=ad-372.jpeg", "width": null, "height": null }, "x_l": { "href": "https://media-ys.automobile.it/api/v1/am-ad/images/6d3b2f3af24c1c41b4095edca7347540?rule=ad-1280.jpeg", "width": null, "height": null }, "t_h_u_m_b_n_a_i_l": { "href": "https://media-ys.automobile.it/api/v1/am-ad/images/6d3b2f3af24c1c41b4095edca7347540?rule=ad-118.jpeg", "width": null, "height": null } } } ], "title": "Lancia Ypsilon 1.3 Multijet 16V Platino", "formatted_price": "€ 2.000", "location": "Dorzano (BI)", "url": "/dorzano-lancia-ypsilon-1-3-multijet-16v-platino/180207089", "rental": false, "has_scarcity_tag": false, "short_description": "Autovettura in buone condizioni. Adatta ai neopatentati. ", "seller_type": "DEALER", "make_id": "585544", "channel": "Usato", "total_number_of_pictures": 6, "dealer_name": "EMMAUTO SRLS", "diogene_enabled": false, "dekra_allowed": false, "carfax_allowed": true, "has_quality_seal": false, "has_general_warranty": true, "vip_pictures": [], "image_urls": [ "https://media-ys.automobile.it/api/v1/am-ad/images/90e1e3d300061b5bc6ab283cb4e65c08", "https://media-ys.automobile.it/api/v1/am-ad/images/a0ec169f51793db4e06be8323fc3e961", "https://media-ys.automobile.it/api/v1/am-ad/images/3d0d7bdfe3bcecfdd761624f5a146b05", "https://media-ys.automobile.it/api/v1/am-ad/images/14e5e7b497c0a736280fec0522a05932", "https://media-ys.automobile.it/api/v1/am-ad/images/54f84509e3acd5a51ecec9ed6f26e735", "https://media-ys.automobile.it/api/v1/am-ad/images/6d3b2f3af24c1c41b4095edca7347540" ], "image_rules": [ "ad-568.auto", "ad-600.auto", "ad-1280.auto", "ad-140.auto", "ad-372.auto", "ad-80.auto", "ad-118.auto", "ad-568.jpeg", "ad-600.jpeg", "ad-1280.jpeg", "ad-140.jpeg", "ad-372.jpeg", "ad-80.jpeg", "ad-118.jpeg" ], "has_placeholder_picture": false, "rental_packages": [], "details": { "registration": "Luglio 2006", "fuel_emissions": "Diesel - Euro 4", "formatted_km": "215.000 km", "formatted_power": "69 CV (51 KW)", "shift": "Manuale", "formatted_engine_capacity": "1248 cc", "channel_or_channel_used": "Usato", "category": "cars", "channel_value": "1" }, "details_type": "USED", "watchlisted": false, "extended_result": false, "ad_status": "ACTIVE", "price_transparency": "1", "google_rating": { "rating": null, "user_ratings_total": null }, "first_medium_size_image": "https://media-ys.automobile.it/api/v1/am-ad/images/90e1e3d300061b5bc6ab283cb4e65c08?rule=ad-372.jpeg" } ``` Each listing returns a record with 30+ fields: #### Identification & Listing Info | Field | Meaning | |---|---| | `ID` | Unique internal listing identifier on Automobile.it | | `Title` | Full listing title (e.g., "BMW 320d xDrive Touring") | | `URL` | Direct link to the full listing detail page | | `Ad Status` | Current status of the listing (e.g., active, sold) | | `Channel` | Distribution channel or listing source | | `Extended Result` | Whether the listing includes extended data beyond standard fields | #### Pricing | Field | Meaning | |---|---| | `Formatted Price` | Display price as shown to users (e.g., "€ 18.900") | | `Price Transparency` | Indicator of how pricing info is disclosed (e.g., negotiable, fixed) | | `Rental` | Whether the listing is a rental offer rather than a sale | | `Rental Packages` | Available rental plan details if `Rental` is true | #### Location & Seller | Field | Meaning | |---|---| | `Location` | City or region where the vehicle is listed | | `Seller Type` | Indicates private seller vs. professional dealer | | `Dealer Name` | Name of the dealership (if applicable) | | `Google Rating` | Dealer's Google review rating (if available) | | `Make ID` | Internal identifier for the vehicle brand/make | #### Images & Media | Field | Meaning | |---|---| | `Pictures` | Number of pictures associated with the listing | | `Total Number Of Pictures` | Total picture count including non-displayed images | | `VIP Pictures` | Premium/highlighted images for featured listings | | `Image URLs` | Array of all image URLs for the listing | | `Image Rules` | Rules governing image display (e.g., watermarking, ordering) | | `Has Placeholder Picture` | `true` if no real image is available and a placeholder is shown | | `First Medium Size Image` | URL of the primary medium-resolution thumbnail | #### Vehicle Details | Field | Meaning | |---|---| | `Short Description` | Brief summary of key specs (e.g., fuel type, km, year) | | `Details` | Structured vehicle attribute object (make, model, year, mileage, etc.) | | `Details Type` | Format or schema type of the `Details` object | #### Trust & Quality Signals | Field | Meaning | |---|---| | `Has Quality Seal` | Whether the listing carries a quality certification badge | | `Has General Warranty` | Whether a warranty is included with the vehicle | | `Dekra Allowed` | Whether a Dekra inspection report is available or permitted | | `Carfax Allowed` | Whether a Carfax vehicle history report is accessible | | `Has Scarcity Tag` | `true` if the listing is flagged as a rare/limited availability vehicle | | `Diogene Enabled` | Internal platform feature flag (relates to listing visibility rules) | #### User Interaction | Field | Meaning | |---|---| | `Watchlisted` | Whether the listing has been saved/watchlisted by users | *** ### How to Use 1. **Find target URLs** — Apply your desired filters on Automobile.it (brand, price, region, seller rating) and copy the results page URL. 2. **Configure input** — Paste URLs into the `urls` array. Adjust `max_items_per_url` based on how many listings per page you need. 3. **Set failure handling** — Keep `ignore_url_failures: true` for multi-URL runs. 4. **Run and export** — Download results as JSON, CSV, or Excel. **Common issues:** - Only use **search/listing page URLs**, not individual car detail pages. - If results seem truncated, increase `max_items_per_url` to match the page's actual listing count (typically 20–30 per page). *** ### Use Cases & Business Value - **Price intelligence:** Track average asking prices by make, model, or region across the Italian market - **Inventory monitoring:** Watch competitor dealer stock changes over time - **Listing aggregators:** Feed structured data into custom automotive comparison tools - **Academic research:** Study used car market dynamics and depreciation patterns in Italy *** ### Conclusion The **Automobile.it Car Search Scraper** turns Italy's largest automotive marketplace into a structured data source. With 30+ fields per listing — covering price, location, images, dealer trust signals, and vehicle details — it eliminates manual data collection and powers reliable automotive market intelligence. Start a run with any Automobile.it search URL and export your dataset in minutes. # 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://www.automobile.it/annunci/page-2?valutazione_del_venditore=tutti" ], "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://www.automobile.it/annunci/page-2?valutazione_del_venditore=tutti" ], "ignore_url_failures": true, "max_items_per_url": 20 }; // Run the Actor and wait for it to finish const run = await client.actor("stealth_mode/automobile-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://www.automobile.it/annunci/page-2?valutazione_del_venditore=tutti"], "ignore_url_failures": True, "max_items_per_url": 20, } # Run the Actor and wait for it to finish run = client.actor("stealth_mode/automobile-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://www.automobile.it/annunci/page-2?valutazione_del_venditore=tutti" ], "ignore_url_failures": true, "max_items_per_url": 20 }' | apify call stealth_mode/automobile-cars-search-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=stealth_mode/automobile-cars-search-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Automobile Cars Search Scraper", "description": "Scrape car listings from Automobile.it with ease. Collect prices, locations, dealer info, images, and 30+ fields per listing — perfect for automotive analysts, dealers, and price comparison platforms targeting the Italian car market.", "version": "0.0", "x-build-id": "QKvVj86YmLHw11H6D" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/stealth_mode~automobile-cars-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-stealth_mode-automobile-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/stealth_mode~automobile-cars-search-scraper/runs": { "post": { "operationId": "runs-sync-stealth_mode-automobile-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/stealth_mode~automobile-cars-search-scraper/run-sync": { "post": { "operationId": "run-sync-stealth_mode-automobile-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 } } } } } } } } } } ```