# AUTO.RIA Ukraine Car Scraper (`devilscrapes/autoria-ukraine-cars`) Actor Scrape used-car listings from AUTO.RIA (auto.ria.com), Ukraine's #1 car marketplace with ~300k live ads. Get price (USD/UAH), make, model, year, mileage, fuel, transmission, engine, body, color, VIN, location, seller type, photos, and full description — export to JSON or CSV. - **URL**: https://apify.com/devilscrapes/autoria-ukraine-cars.md - **Developed by:** [DevilScrapes](https://apify.com/devilscrapes) (community) - **Categories:** Automation, E-commerce - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing Pay per event This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. 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
Devil Scrapes mark ## AUTO.RIA Ukraine Car Scraper **💰 $0.05 / 1 000 results**  ·  pay only for results  ·  no credit card to try _We do the dirty work so your dataset stays clean._ 😈 Scrape used-car listings from AUTO.RIA (auto.ria.com), Ukraine's #1 car marketplace with ~300k live ads. Get price (USD/UAH), make, model, year, mileage, fuel, transmission, engine, body, color, VIN, location, seller type, photos, and full description — export to JSON or CSV.
--- ### 🎯 What this scrapes AUTO.RIA (auto.ria.com) is Ukraine's largest car marketplace with around 300,000 live used-car ads. This Actor discovers listing IDs through AUTO.RIA's own search backend, then enriches each car from its detail page — pulling the structured `Vehicle` data (make, model, year, mileage, fuel, transmission, body type, color, VIN, price in USD or UAH, and photo gallery) plus the full seller description. Paste a filtered AUTO.RIA search URL or scrape the whole used-car catalogue. Built on `curl-cffi` with browser TLS impersonation and Apify Proxy. ### 🔥 What we handle for you - 🛡️ **Browser fingerprint rotation** — `curl-cffi` impersonates real Chrome / Firefox / Safari TLS handshakes so the target sees a browser, not Python. - 🌐 **Residential proxy rotation** via Apify Proxy — fresh session and exit IP on every block. - 🔁 **Retries with exponential backoff** on `408 / 429 / 5xx` — up to 5 attempts per page, `Retry-After` honoured. - 🧱 **Rate-limit-aware pacing** — when the target pushes back, we slow down instead of getting banned. - 🧊 **Clean, typed dataset rows** — Pydantic-validated, ISO-8601 timestamps, stable IDs, JSON / CSV / Excel export straight from the Apify Console. - 💰 **Pay-Per-Event pricing** — you only pay for results that hit your dataset. No data, no charge. ### 💡 Use cases - **Used-car price intelligence** — track asking prices by make / model / year across Ukraine. - **Dealer inventory monitoring** — diff successive runs to catch new arrivals and price drops. - **Market analytics** — aggregate mileage, fuel-type, and transmission mix for a segment. - **Lead generation** — build a directory of private sellers and dealers by region. - **Import / export sourcing** — find specific models with VINs for cross-border resale. ### ⚙️ How to use it 1. Click **Try for free** at the top of the page. 2. Fill in the input form — most fields have sensible defaults. 3. Click **Start**. Output streams into the run's dataset. 4. Export from **Storage → Dataset** as JSON, CSV, or Excel — or fetch via the API. ### 📥 Input | Field | Type | Required | Default | Notes | |---|---|:--:|---|---| | `searchUrl` | `string` | no | '—' | Optional full AUTO.RIA search/results URL with filters already applied (e.g. https://auto.ria.com/uk/search/?categ | | `categoryId` | `string` | no | '1' | AUTO.RIA vehicle category to scrape when no Search URL is given. Defaults to passenger cars. | | `maxResults` | `integer` | no | 50 | Hard cap on dataset rows. | | `enrichDetails` | `boolean` | no | True | Fetch each car's detail page for full vehicle data (make, model, year, mileage, fuel, transmission, body, color, VIN, ph | | `proxyConfiguration` | `object` | no | {'useApifyProxy': True} | Apify Proxy spec. Datacenter exits work for AUTO.RIA; residential is the safest at scale. | #### Example input ```json { "categoryId": "1", "maxResults": 5, "enrichDetails": true, "proxyConfiguration": { "useApifyProxy": true } } ```` ### 📤 Output Every row is one dataset item. | Field | Type | Notes | |---|---|---| | `listing_id` | `string` | AUTO.RIA numeric listing ID. | | `listing_url` | `string` | Absolute URL to the listing detail page. | | `title` | `string` | Listing title (e.g. Volkswagen Tiguan 2011). | | `make` | `['string', 'null']` | Vehicle make / brand. | | `model` | `['string', 'null']` | Vehicle model. | | `year` | `['integer', 'null']` | Production / model year. | | `price` | `['integer', 'null']` | Asking price as an integer in the listing's own currency. | | `currency` | `['string', 'null']` | ISO-4217 currency code for price (USD, EUR, or UAH). | | `price_uah` | `['integer', 'null']` | Asking price in Ukrainian hryvnia when shown on the page. | | `mileage_km` | `['integer', 'null']` | Odometer reading in kilometres. | | `fuel_type` | `['string', 'null']` | Fuel type (e.g. Бензин, Дизель, Газ, Електро, Гібрид). | | `transmission` | `['string', 'null']` | Gearbox type (e.g. Автомат, Ручна / механіка). | | `engine_size_cc` | `['integer', 'null']` | Engine displacement in cubic centimetres (derived from litres). | | `engine_power_hp` | `['integer', 'null']` | Engine power in horsepower (к.с.) when published. | | `body_type` | `['string', 'null']` | Body type / vehicle class (e.g. Легкові, Позашляховик / Кросовер). | | `color` | `['string', 'null']` | Exterior colour. | | `vin` | `['string', 'null']` | Vehicle Identification Number when published. | | `doors` | `['integer', 'null']` | Number of doors. | | `location` | `['string', 'null']` | Seller city / locality. | | `region` | `['string', 'null']` | Seller oblast / region. | | `seller_type` | `['string', 'null']` | dealer or private. | | `seller_name` | `['string', 'null']` | Seller display name. | | `photo_urls` | `array` | List of photo URLs from the gallery. | | `description` | `['string', 'null']` | Full seller description (plain text). | | `first_registration` | `['string', 'null']` | First-registration / last-operation note when published. | | `posted_date` | `['string', 'null']` | Date the listing was posted or last checked, when published. | | `scraped_at` | `string` | ISO-8601 UTC timestamp when this row was recorded. | #### Example output ```json { "listing_id": "39954693", "listing_url": "https://auto.ria.com/uk/auto_volkswagen_tiguan_39954693.html", "title": "Volkswagen Tiguan 2011", "make": "Volkswagen", "model": "Tiguan", "year": 2011, "price": 12800, "currency": "USD", "price_uah": 565760, "mileage_km": 270000, "fuel_type": "\u0414\u0438\u0437\u0435\u043b\u044c", "transmission": "\u0410\u0432\u0442\u043e\u043c\u0430\u0442", "engine_size_cc": 1970, "body_type": "\u041f\u043e\u0437\u0430\u0448\u043b\u044f\u0445\u043e\u0432\u0438\u043a / \u041a\u0440\u043e\u0441\u043e\u0432\u0435\u0440", "color": "\u0411\u0456\u043b\u0438\u0439", "vin": "WVGZZZ5NZBW559888", "doors": 5, "location": "\u0406\u0432\u0430\u043d\u043e-\u0424\u0440\u0430\u043d\u043a\u0456\u0432\u0441\u044c\u043a", "seller_type": "private", "seller_name": "\u041d\u0430\u0434\u044e\u0448\u0430", "photo_urls": [ "https://cdn0.riastatic.com/photosnew/auto/photo/volkswagen_tiguan__644750158s.webp" ], "scraped_at": "2026-06-02T00:30:00+00:00" } ``` ### 💰 Pricing Pay-Per-Event — you pay only when these events fire: | Event | USD | What it is | |---|---:|---| | `actor-start` | $0.05 | One-off warm-up charge per run | | `result-row` | $0.002 | PPE event | Example: 1 000 results at the rates above ≈ **$0.05**. No subscription, no minimum, no card to start — Apify gives every new account $5 of free credit. ### 🚧 Limitations Some fields (engine power, VIN, exact posting date) are only present on a subset of listings and come back null when AUTO.RIA omits them. Prices are quoted by sellers and may be negotiable. AUTO.RIA's search backend paginates the catalogue; very deep pagination beyond a few thousand results can repeat or thin out, so target queries with a Search URL when you need a specific slice. ### ❓ FAQ **What currency is the price in?** AUTO.RIA quotes most cars in US dollars; currency reflects what the listing uses (USD, EUR, or UAH). When the page also shows a hryvnia figure we surface it in price\_uah. **Can I scrape a filtered search?** Yes. Paste any AUTO.RIA results URL into searchUrl — its filters (brand, model, price, region, year) are forwarded to AUTO.RIA's search backend so you only get matching cars. **Can I disable detail enrichment?** Yes — set enrichDetails to false to return just the listing IDs and URLs, halving the request count. Enable it for the full vehicle record. **Is this an official AUTO.RIA API?** No. AUTO.RIA offers a separate keyed developer API; this Actor scrapes the public website politely. See the ToS note in the README. **How many cars can I get?** AUTO.RIA lists around 300,000 used cars. The Actor paginates through the catalogue up to your maxResults cap (max 1000 per run). ### 💬 Your feedback Spotted a bug, hit a weird edge case, or need a new field? Open an issue on the Actor's **Issues** tab on Apify Console — we ship fixes weekly and we read every report. ***
Built by **[Devil Scrapes](https://apify.com/DevilScrapes)** 😈 — a small fleet of opinionated public-data Actors. Honest pricing, real engineering, zero fine print.
# Actor input Schema ## `searchUrl` (type: `string`): Optional full AUTO.RIA search/results URL with filters already applied (e.g. https://auto.ria.com/uk/search/?categories.main.id=1\&brand.id\[0]=84). Its query parameters are forwarded to AUTO.RIA's search backend. Leave empty to scrape the whole used-car catalogue. ## `categoryId` (type: `string`): AUTO.RIA vehicle category to scrape when no Search URL is given. Defaults to passenger cars. ## `maxResults` (type: `integer`): Hard cap on dataset rows. ## `enrichDetails` (type: `boolean`): Fetch each car's detail page for full vehicle data (make, model, year, mileage, fuel, transmission, body, color, VIN, photos, description). Disable to return IDs and listing URLs only and halve the request count. ## `proxyConfiguration` (type: `object`): Apify Proxy spec. Datacenter exits work for AUTO.RIA; residential is the safest at scale. ## Actor input object example ```json { "categoryId": "1", "maxResults": 50, "enrichDetails": true, "proxyConfiguration": { "useApifyProxy": true } } ``` # Actor output Schema ## `datasetItems` (type: `string`): All dataset items as JSON. ## `datasetItemsCsv` (type: `string`): Same data exported to CSV. ## `datasetView` (type: `string`): Open the run dataset in the Console. # 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 = { "proxyConfiguration": { "useApifyProxy": true } }; // Run the Actor and wait for it to finish const run = await client.actor("devilscrapes/autoria-ukraine-cars").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 = { "proxyConfiguration": { "useApifyProxy": True } } # Run the Actor and wait for it to finish run = client.actor("devilscrapes/autoria-ukraine-cars").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 '{ "proxyConfiguration": { "useApifyProxy": true } }' | apify call devilscrapes/autoria-ukraine-cars --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=devilscrapes/autoria-ukraine-cars", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "AUTO.RIA Ukraine Car Scraper", "description": "Scrape used-car listings from AUTO.RIA (auto.ria.com), Ukraine's #1 car marketplace with ~300k live ads. Get price (USD/UAH), make, model, year, mileage, fuel, transmission, engine, body, color, VIN, location, seller type, photos, and full description — export to JSON or CSV.", "version": "0.1", "x-build-id": "3jdLvLxbVazjDgEge" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/devilscrapes~autoria-ukraine-cars/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-devilscrapes-autoria-ukraine-cars", "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/devilscrapes~autoria-ukraine-cars/runs": { "post": { "operationId": "runs-sync-devilscrapes-autoria-ukraine-cars", "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/devilscrapes~autoria-ukraine-cars/run-sync": { "post": { "operationId": "run-sync-devilscrapes-autoria-ukraine-cars", "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": { "searchUrl": { "title": "Search URL", "type": "string", "description": "Optional full AUTO.RIA search/results URL with filters already applied (e.g. https://auto.ria.com/uk/search/?categories.main.id=1&brand.id[0]=84). Its query parameters are forwarded to AUTO.RIA's search backend. Leave empty to scrape the whole used-car catalogue." }, "categoryId": { "title": "Vehicle category", "enum": [ "1", "2", "4", "7", "8" ], "type": "string", "description": "AUTO.RIA vehicle category to scrape when no Search URL is given. Defaults to passenger cars.", "default": "1" }, "maxResults": { "title": "Max results", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Hard cap on dataset rows.", "default": 50 }, "enrichDetails": { "title": "Enrich from detail page", "type": "boolean", "description": "Fetch each car's detail page for full vehicle data (make, model, year, mileage, fuel, transmission, body, color, VIN, photos, description). Disable to return IDs and listing URLs only and halve the request count.", "default": true }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify Proxy spec. Datacenter exits work for AUTO.RIA; residential is the safest at scale.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } } ```