{ "openapi": "3.0.1", "info": { "title": "Avito Auto Scraper: Парсер Авито Авто", "description": "Scrape vehicle listings from Avito Auto (avito.ru) - price, mileage, generation, dealer identity, and Avito's own market-price valuation for any city.", "version": "0.2", "x-build-id": "TdJwYFkSYbYlgI8b5" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/getascraper~avito-auto-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-getascraper-avito-auto-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~avito-auto-scraper/runs": { "post": { "operationId": "runs-sync-getascraper-avito-auto-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~avito-auto-scraper/run-sync": { "post": { "operationId": "run-sync-getascraper-avito-auto-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": { "citySlug": { "title": "City / region slug", "type": "string", "description": "Avito city or region URL slug to search within, e.g. 'moskva', 'sankt-peterburg', 'krasnodar'. A nationwide slug like 'rossiya' returns zero listings (confirmed) - always pick a specific city or region. Ignored when a Search URL is provided." }, "searchUrl": { "title": "Search URL (overrides City + source filters)", "type": "string", "description": "Paste a filtered Avito Auto search URL copied from your browser (e.g. https://www.avito.ru/moskva/avtomobili/bmw/x5?pmin=2000000). When set, it is scraped verbatim and overrides City slug, Make, Model, Price and Sort below. This is the most reliable way to reproduce Avito's advanced filters (year, mileage, fuel, transmission, body) at the source, because Avito packs those into an encoded filter code rather than plain parameters." }, "make": { "title": "Make", "type": "string", "description": "Keep only listings of this make, lowercase latin slug as Avito uses it, e.g. 'bmw', 'kia', 'toyota', 'mercedes-benz'. Matched against each listing so only cars of this make are returned (and, under pay-per-result, only matching cars are billed). If you also set a Search URL that already names a make, this is taken from the URL." }, "model": { "title": "Model", "type": "string", "description": "Keep only listings of this model, lowercase latin slug, e.g. 'x5', 'rio', 'camry'. Only applied together with Make." }, "priceMin": { "title": "Min price (RUB)", "minimum": 0, "type": "integer", "description": "Minimum asking price in rubles. Applied at the source via Avito's pmin parameter. Ignored when Search URL is set." }, "priceMax": { "title": "Max price (RUB)", "minimum": 0, "type": "integer", "description": "Maximum asking price in rubles. Applied at the source via Avito's pmax parameter. Ignored when Search URL is set." }, "yearMin": { "title": "Min year", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "Earliest model year to keep (inclusive). Applied to scraped rows." }, "yearMax": { "title": "Max year", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "Latest model year to keep (inclusive). Applied to scraped rows." }, "mileageMin": { "title": "Min mileage (km)", "minimum": 0, "type": "integer", "description": "Minimum odometer reading in kilometres (inclusive). Applied to scraped rows." }, "mileageMax": { "title": "Max mileage (km)", "minimum": 0, "type": "integer", "description": "Maximum odometer reading in kilometres (inclusive). Applied to scraped rows." }, "fuel": { "title": "Fuel type", "enum": [ "petrol", "diesel", "hybrid", "electric", "lpg" ], "type": "string", "description": "Keep only listings with this fuel type. Applied to scraped rows." }, "transmission": { "title": "Transmission", "enum": [ "manual", "automatic", "robot", "variator" ], "type": "string", "description": "Keep only listings with this transmission. Applied to scraped rows." }, "bodyType": { "title": "Body type", "enum": [ "sedan", "hatchback", "suv", "wagon", "coupe", "minivan", "cabriolet", "pickup", "liftback", "van" ], "type": "string", "description": "Keep only listings with this body type. Applied to scraped rows." }, "sort": { "title": "Sort order", "enum": [ "default", "date", "priceAsc", "priceDesc" ], "type": "string", "description": "Order Avito returns results in. Applied at the source via Avito's sort parameter. Ignored when Search URL is set.", "default": "default" }, "maxItems": { "title": "Maximum listings", "minimum": 0, "maximum": 20000, "type": "integer", "description": "Maximum number of vehicle detail pages to scrape. 0 = unlimited (bounded only by Max search pages).", "default": 100 }, "maxPages": { "title": "Maximum search pages", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum number of search-result pages to paginate through (~50 listings/page). Avito caps search results around page 100. Raise this when using strict year/mileage/fuel/transmission/body filters, since non-matching cars are dropped and more pages may be needed to reach your Maximum listings.", "default": 5 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Avito is fronted by QRATOR, a TLS/JA3-fingerprint + IP-reputation gate (not a JS challenge or CAPTCHA). Residential Russian proxy is the validated safe production default; datacenter proxy passed in light testing but is untested at production volume.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "RU" } } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }