{ "openapi": "3.0.1", "info": { "title": "Auto.RIA Cars Scraper: Used Cars Ukraine", "description": "Scrape Auto.RIA.com used-car listings by price, year, and mileage. Get make, model, VIN, mileage, fuel, transmission, seller, and images as JSON, CSV, or Excel. Export to Sheets, Make, Zapier. Skip manual copy-paste.", "version": "0.1", "x-build-id": "WveZ7axeBsUgsPRIO" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/getascraper~auto-ria-cars-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-getascraper-auto-ria-cars-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/getascraper~auto-ria-cars-scraper/runs": { "post": { "operationId": "runs-sync-getascraper-auto-ria-cars-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/getascraper~auto-ria-cars-scraper/run-sync": { "post": { "operationId": "run-sync-getascraper-auto-ria-cars-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": { "startUrls": { "title": "Start URLs (advanced override)", "type": "array", "description": "Optional. Paste one or more Auto.RIA search or listing URLs to scrape exactly that page instead of building a URL from the filters below. Use this for filters not covered below, such as make or model, by copying a pre-filtered search URL straight from auto.ria.com. When set, this takes priority and the filter fields below are ignored.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "priceFromUsd": { "title": "Price from (USD)", "minimum": 0, "type": "integer", "description": "Minimum asking price in US dollars, Auto.RIA's default listing currency." }, "priceToUsd": { "title": "Price to (USD)", "minimum": 0, "type": "integer", "description": "Maximum asking price in US dollars." }, "yearFrom": { "title": "Year from", "minimum": 1950, "maximum": 2100, "type": "integer", "description": "Earliest production year." }, "yearTo": { "title": "Year to", "minimum": 1950, "maximum": 2100, "type": "integer", "description": "Latest production year." }, "mileageFromKm": { "title": "Mileage from (km)", "minimum": 0, "type": "integer", "description": "Minimum odometer reading in kilometers." }, "mileageToKm": { "title": "Mileage to (km)", "minimum": 0, "type": "integer", "description": "Maximum odometer reading in kilometers." }, "scrapeDetails": { "title": "Open each listing for full details", "type": "boolean", "description": "When on, the scraper opens every listing page to collect the full spec sheet (VIN, exact year, color, doors, seller name, description, all photos). When off, only the quicker summary shown on the search results page is collected (price, approximate mileage, transmission, fuel, location).", "default": true }, "maxDetailPages": { "title": "Maximum listing pages to open", "minimum": 0, "maximum": 1000, "type": "integer", "description": "Caps how many individual listing pages are opened for full details, even when 'Open each listing for full details' is on. Extra listings beyond this cap still appear in the results using only the summary data from the search page.", "default": 25 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional proxy settings. Auto.RIA works with a direct connection by default.", "default": { "useApifyProxy": false } }, "maxItems": { "title": "Maximum listings", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of unique car listings to return.", "default": 25 }, "maxPages": { "title": "Maximum search pages", "minimum": 1, "maximum": 20, "type": "integer", "description": "Maximum number of search-result pages to visit.", "default": 5 } } }, "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 } } } } } } } } } }