# Auto Ria Cars Search Scraper (`stealth_mode/auto-ria-cars-search-scraper`) Actor Scrape detailed automotive listings from Auto.ria.com with precision. Collect vehicle titles, prices, photos, descriptions, publish dates, and seller info from search results — perfect for price monitoring, market analysis, and inventory aggregation. - **URL**: https://apify.com/stealth\_mode/auto-ria-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, 0 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/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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 ## Auto.ria.com Scraper: Extract Vehicle Listings at Scale --- ### What Is Auto.ria.com? Auto.ria.com is Eastern Europe's largest automotive classified platform, hosting hundreds of thousands of used and new vehicle listings. From budget cars to luxury vehicles, it serves millions of buyers and sellers monthly. Manually gathering market data from thousands of listings is impractical — the **Auto.ria.com Scraper** automates this, extracting structured vehicle information from search pages in seconds. --- ### Overview The **Auto.ria.com Automotive Search Scraper** extracts vehicle listings from Auto.ria.com search results pages, transforming unstructured classified data into clean, machine-readable records. Designed for: - **Automotive dealers** tracking competitor pricing and inventory - **Market researchers** analyzing vehicle availability and pricing trends - **Price comparison platforms** building automotive databases - **Data analysts** studying the used car market - **Exporters and buyers** monitoring vehicle supply chains The scraper handles high-volume collection with configurable limits, graceful error handling, and reliable extraction of images, pricing, and vehicle details from competitive search environments. --- ### Input Format The scraper accepts a JSON configuration specifying which search results to scrape: ```json { "urls": [ "https://auto.ria.com/search/?search_type=1&category=1&abroad=0&customs_cleared=1&page=2" ], "ignore_url_failures": true, "max_items_per_url": 200 } ```` | Field | Description | |---|---| | `urls` | Auto.ria.com search results page URLs (including filters, pagination, categories) | | `max_items_per_url` | Maximum vehicle listings scraped per URL (e.g., `200` = all results on the page) | | `ignore_url_failures` | If `true`, continues scraping if some URLs fail; if `false`, stops on first error | **URL Parameters Guide:** - `search_type=1` — Search cars (vs. motorcycles, trucks) - `category=1` — Category filter (1 = used cars) - `abroad=0` — Exclude foreign listings - `customs_cleared=1` — Only customs-cleared vehicles - `page=N` — Results page number > **Tip:** Build your URL on Auto.ria.com using filters (price range, mileage, year), then paste the full URL into the config. *** ### Output Format **Example Output Record:** ```json { "id": 38810182, "photos": [ { "type": "Image", "image_type": "webp", "is_panorama": false, "id": "641352221", "src": "https://cdn1.riastatic.com/photosnew/auto/photo/_eqs__641352221fx.webp", "formats": { "small": "https://cdn1.riastatic.com/photosnew/auto/photo/_eqs__641352221bx.webp", "middle": "https://cdn1.riastatic.com/photosnew/auto/photo/_eqs__641352221fx.webp", "large": "https://cdn1.riastatic.com/photosnew/auto/photo/_eqs__641352221hd.webp" }, "title": "Седан Mercedes-Benz EQS 2023 в Коломые", "alt": "Седан Mercedes-Benz EQS 2023 в Коломые", "width_type": "full", "aspect_ratio": "ratio4x3" } ], "photo_container": { "active": true, "is_notepad": false, "center_badge": false, "notepad_type": 1, "left_top_badge": { "content": "ТОП 200" }, "left_top_badges": [ { "content": "ТОП 200", "style": "strokeLight" } ], "right_top": false, "badges": [ { "id": "Auto38810182BotBadge0", "is_hide": false, "type": "BadgeTemplate", "size_str": "medium", "style": "contrast", "background_color": "contrastPrimary", "elements": [ { "type": "Icon", "style": "ic_16_verifiedcar_fill", "width": 16, "height": 16, "color": "inverse" }, { "type": "Text", "content": "Перевірений VIN", "typography": "badge", "color": "inverse" } ] } ] }, "title": { "content": "Mercedes-Benz EQS 2023" }, "subtitle": "V297 • 450+ 107.8 kWh (333 к.с.) • AMG Line", "description": { "content": "Идеальное состояние\nИз Германии\nДва ключа\nAMG снаружи и внутри\nR21 диски AMG\nПанорамная крыша\nПодогрев сидений перед и зад\nВентиляция сидений спереди и массаж\nПамять передних сидений\nПневмоподвеска, которая поднимается, увеличивает клиренс, и задняя ось подруливает\nМузыка burmester\nКонтурная подсветка\nЭлектропривод багажника\nЧерный потолок\nФрезы вырезают проектируют\nПроекционный дисплей с дополненной реальностью\nБольшая дальность хода 700км\nДвойной стеклопакет\nВсе защиты пешеходов\nКамеры 360\nОхрана салона 360\nВсе развлекательные места в Бронеплівці\nЭлектро фаркоп\nДистанционное открытие гаражных ворот\nКонтроль воздуха в салоне\nБесключевой доступ\nПриходят обновления", "row_count": 1 }, "discount_price": { "u_s_d": 56500 }, "price": { "u_a_h": 2532924, "u_s_d": 56400 }, "basic_info": [ { "icon": { "data": { "style": "ic_16_speedometer", "width": 16, "height": 16 } }, "content": "48 тыс. км" }, { "icon": { "data": { "style": "ic_16_ev_range", "width": 16, "height": 16, "is_color": true } }, "content": "770 км" }, { "icon": { "data": { "style": "ic_16_battery", "width": 16, "height": 16 }, "color": "green" }, "content": "Электро, 107 кВт·час" }, { "icon": { "data": { "style": "ic_16_location", "width": 16, "height": 16 } }, "content": "Коломыя" } ], "labels": [ { "id": "Auto38810182BotBadge0", "is_hide": false, "type": "BadgeTemplate", "size_str": "medium", "style": "accent", "background_color": "accent", "elements": [ { "type": "Text", "content": "Готов к проверкам", "typography": "badge", "color": "contrastPrimary" } ] }, { "id": "Auto38810182BotBadge1", "is_hide": false, "type": "BadgeTemplate", "size_str": "medium", "style": "accent", "background_color": "accent", "elements": [ { "type": "Text", "content": "Доступный кредит", "typography": "badge", "color": "contrastPrimary" } ] }, { "id": "Auto38810182BotBadge2", "is_hide": false, "type": "BadgeTemplate", "size_str": "medium", "style": "accent", "background_color": "accent", "elements": [ { "type": "Text", "content": "Торг", "typography": "badge", "color": "contrastPrimary" } ] }, { "id": "Auto38810182BotBadge3", "is_hide": false, "type": "BadgeTemplate", "size_str": "medium", "style": "accent", "background_color": "accent", "elements": [ { "type": "Text", "content": "Обмен", "typography": "badge", "color": "contrastPrimary" } ] } ], "publish_time": "12 дней назад", "link": "https://auto.ria.com/auto_mercedes-benz_eqs_38810182.html", "bottom": {}, "from_url": "https://auto.ria.com/search/?search_type=1&category=1&abroad=0&customs_cleared=1" } ``` Each vehicle listing returns 13 core fields with comprehensive details: #### Listing Identification & Content | Field | Meaning | Example | |---|---|---| | `ID` | Unique Auto.ria.com listing identifier | `12345678` | | `Title` | Vehicle headline as displayed on the listing | `Toyota Camry 2015` | | `Subtitle` | Secondary descriptor or variant info | `Automatic transmission, 2.5L engine` | | `Description` | Full text description written by the seller | `"Well-maintained sedan, no accidents, full service history..."` | | `Link` | Direct URL to the full listing page | `https://auto.ria.com/12345678` | #### Pricing Information | Field | Meaning | Example | |---|---|---| | `Price` | Current asking price in local currency | `15,500 USD` or `420,000 UAH` | | `Discount Price` | Reduced price if the seller has applied a discount or promotion | `14,200 USD` (or empty if no discount) | **Note:** Use both `Price` and `Discount Price` fields to identify discounted listings and calculate actual market rates. #### Vehicle & Listing Metadata | Field | Meaning | Example | |---|---|---| | `Basic Info` | Structured vehicle specifications — brand, model, year, mileage, fuel type, transmission | `{"brand": "Toyota", "year": 2015, "mileage": 125000, "fuel": "Petrol", "transmission": "Automatic"}` | | `Publish Time` | When the listing was published on Auto.ria.com | `2024-06-15 10:30:00` | | `Labels` | Seller-added tags or vehicle condition flags | `["No accidents", "Serviced", "One owner"]` | #### Media & Visual Content | Field | Meaning | |---|---| | `Photos` | Array of image URLs from the listing (vehicle photos in order) | | `Photo Container` | HTML element or metadata about the photo gallery structure | #### Additional Details | Field | Meaning | |---|---| | `Bottom` | Extra information block at the bottom of the listing (seller location, contact restrictions, premium flags, or additional notes) | *** ### How to Use 1. **Build your search** — Visit Auto.ria.com and apply filters (price, mileage, year, location, fuel type, transmission). 2. **Copy the URL** — From the search results page, copy the full URL including all filter parameters. 3. **Configure the scraper** — Paste the URL into the `urls` array. Adjust `max_items_per_url` if needed (200 = all results per page). 4. **Set error handling** — Enable `ignore_url_failures: true` to continue if a URL has issues. 5. **Run the scraper** — Execute the actor and monitor progress. 6. **Export results** — Download JSON or convert to CSV/Excel for analysis. **Best Practices:** - Scrape one search type at a time to keep datasets focused. - Use `customs_cleared=1` if collecting only legal imports. - For multi-page scraping, include pagination URLs or rely on `max_items_per_url` limits. - Check `Discount Price` vs. `Price` for margin analysis. **Handling Common Issues:** - **Empty results** — Verify the URL returns listings on Auto.ria.com; some filter combinations may have no matches. - **Timeout errors** — Reduce `max_items_per_url` or split large searches into smaller pages. - **Photo loading failures** — Check that photo URLs have not expired; older listings may have stale image links. *** ### Real-World Applications - **Price monitoring** — Track competitor and market pricing by vehicle model and year; identify underpriced deals. - **Inventory analysis** — Analyze supply trends (e.g., which models, years, and conditions dominate the market). - **Exporter operations** — Monitor vehicle availability for export; build purchase leads and sourcing databases. - **Market research** — Study regional pricing variations, demand patterns, and vehicle condition reports. - **Aggregator platforms** — Feed Auto.ria.com listings into multi-source automotive marketplaces. The scraper delivers ready-to-analyze data that eliminates manual browsing and enables data-driven decision-making in vehicle trading, retail, and research. *** ### Conclusion The **Auto.ria.com Automotive Search Scraper** provides reliable, fast access to vehicle listing data from one of Eastern Europe's busiest car markets. With 13 structured fields capturing prices, photos, descriptions, and seller details, it transforms search pages into actionable datasets. Whether you're a dealer, exporter, researcher, or platform builder, this scraper accelerates data collection and unlocks market insights. # 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://auto.ria.com/search/?search_type=1&category=1&abroad=0&customs_cleared=1&page=2" ], "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://auto.ria.com/search/?search_type=1&category=1&abroad=0&customs_cleared=1&page=2" ], "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/auto-ria-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://auto.ria.com/search/?search_type=1&category=1&abroad=0&customs_cleared=1&page=2"], "ignore_url_failures": True, "max_items_per_url": 20, } # Run the Actor and wait for it to finish run = client.actor("stealth_mode/auto-ria-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://auto.ria.com/search/?search_type=1&category=1&abroad=0&customs_cleared=1&page=2" ], "ignore_url_failures": true, "max_items_per_url": 20 }' | apify call stealth_mode/auto-ria-cars-search-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=stealth_mode/auto-ria-cars-search-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Auto Ria Cars Search Scraper", "description": "Scrape detailed automotive listings from Auto.ria.com with precision. Collect vehicle titles, prices, photos, descriptions, publish dates, and seller info from search results — perfect for price monitoring, market analysis, and inventory aggregation.", "version": "0.0", "x-build-id": "KuOx3QJNOMAOq1Jsi" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/stealth_mode~auto-ria-cars-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-stealth_mode-auto-ria-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~auto-ria-cars-search-scraper/runs": { "post": { "operationId": "runs-sync-stealth_mode-auto-ria-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~auto-ria-cars-search-scraper/run-sync": { "post": { "operationId": "run-sync-stealth_mode-auto-ria-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 } } } } } } } } } } ```