{ "openapi": "3.0.1", "info": { "title": "Avito Cars Scraper - Vehicle Listings, Prices & Specs", "description": "Scrape Avito transport: used and new car listings with year, mileage, price, the site's own make facet (186 makes), seller type and the full vehicle attribute table on detail reads. City search or paste links. Resume, incremental updates and MCP export included.", "version": "1.0", "x-build-id": "y6EPR7YvgKDV3QIFb" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/abotapi~avito-auto-listings-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-abotapi-avito-auto-listings-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/abotapi~avito-auto-listings-scraper/runs": { "post": { "operationId": "runs-sync-abotapi-avito-auto-listings-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/abotapi~avito-auto-listings-scraper/run-sync": { "post": { "operationId": "run-sync-abotapi-avito-auto-listings-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": { "mode": { "title": "Mode", "enum": [ "search", "url" ], "type": "string", "description": "search builds tokenized car searches from your filters. url scrapes exactly the avito search/category links you paste (tokenized links from the site work as-is).", "default": "search" }, "regions": { "title": "Cities (search mode)", "type": "array", "description": "City names (Москва / Moscow) or avito slugs (moskva). Every search is city-scoped on avito.", "default": [ "Moscow" ], "items": { "type": "string" } }, "dealType": { "title": "Deal type", "enum": [ "s_probegom", "novyy" ], "type": "string", "description": "s_probegom = used cars, novyy = new cars. Motorcycles, trucks, parts and other transport categories work in url mode - paste a link from the site.", "default": "s_probegom" }, "make": { "title": "Make", "type": "string", "description": "Car make slug (the site's own facet; 186 makes available - BMW, Toyota, Lada/Vaz_lada, Kia, ...). Use the site's slug form (e.g. vaz_lada, land_rover, mercedes).", "default": "" }, "minPrice": { "title": "Min price (RUB)", "type": "integer", "description": "Minimum listing price in rubles." }, "maxPrice": { "title": "Max price (RUB)", "type": "integer", "description": "Maximum listing price in rubles." }, "query": { "title": "Keyword", "type": "string", "description": "Free-text search keyword (e.g. a model name).", "default": "" }, "sortBy": { "title": "Sort", "enum": [ "default", "date_desc", "price_asc", "price_desc" ], "type": "string", "description": "default = relevance, date_desc = newest, price_asc / price_desc.", "default": "default" }, "ownerOnly": { "title": "Private owners only", "type": "boolean", "description": "Exclude dealers (the site's own owner filter).", "default": false }, "urls": { "title": "Links (url mode)", "type": "array", "description": "Paste Avito transport search or category links copied from the site, including their filter tokens. Use the example links as a guide.", "default": [ { "url": "https://www.avito.ru/moskva/avtomobili/s_probegom-ASgBAgICAUSGFMjmAQ" }, { "url": "https://www.avito.ru/moskva/avtomobili/bmw-ASgBAgICAUTgtg3klyg" }, { "url": "https://www.avito.ru/moskva/avtomobili/bmw-ASgBAgICAUTgtg3klyg?p=2" } ], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxListings": { "title": "Max items", "minimum": 0, "type": "integer", "description": "Maximum number of listings per run (a hard global cap across all searches). 0 means the per-result billing cap applies.", "default": 20 }, "maxPages": { "title": "Max pages per search", "minimum": 0, "type": "integer", "description": "Maximum pages walked per search. 0 means no page cap, so Max items is the only cap that stops a run early.", "default": 0 }, "fetchDetails": { "title": "Fetch detail pages", "type": "boolean", "description": "Read each listing's page for the seller type (private vs dealer), the full vehicle attribute table (engine, gearbox, drive, owners, VIN signals), coordinates and price history.", "default": true }, "proxy": { "title": "Proxy configuration", "type": "object", "description": "Residential proxies are required - the site refuses datacenter IPs for the listing routes. The exit country rotates per session for maximum reliability.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }, "resumeFromRunId": { "title": "Resume from run ID", "type": "string", "description": "Run or dataset ID whose collected listings should be skipped (for continuing after an interrupted run).", "default": "" }, "incrementalMode": { "title": "Incremental mode", "type": "boolean", "description": "Track state between runs and classify every listing as NEW, UPDATED, UNCHANGED or EXPIRED instead of always NEW. Rows already known and unchanged are suppressed.", "default": false }, "stateKey": { "title": "State key", "type": "string", "description": "Named baseline for incremental runs. Leave empty to derive the key from the run scope.", "default": "" }, "emitUnchanged": { "title": "Emit unchanged rows", "type": "boolean", "description": "In incremental mode, also push rows that did not change (changeType UNCHANGED).", "default": false }, "emitExpired": { "title": "Emit expired rows", "type": "boolean", "description": "In incremental mode, emit EXPIRED tombstone rows for listings that disappeared from the walked scope.", "default": false }, "ignoreFieldsForChanges": { "title": "Ignore fields when detecting changes (incremental mode only)", "type": "array", "description": "Extra field names that must never mark a row UPDATED (photo URL churn and view counters are already excluded by default).", "default": [], "items": { "type": "string" } }, "mcpConnectors": { "title": "MCP connectors", "type": "array", "description": "Apify MCP connector IDs that receive pushed records while the run executes.", "default": [], "items": { "type": "string" } }, "notionParentPageUrl": { "title": "Notion parent page URL", "type": "string", "description": "Notion parent page for the Notion MCP connector.", "default": "" }, "maxNotifyListings": { "title": "Max records to connectors", "minimum": 0, "type": "integer", "description": "Cap on records sent to MCP connectors per run.", "default": 50 } } }, "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 } } } } } } } } } }