{ "openapi": "3.0.1", "info": { "title": "Avito Scraper | Listings, Prices and Sellers", "description": "Avito scraper that turns avito.ru listings into structured JSON: prices, descriptions, photos, coordinates, seller ratings, and the nearest metro station with walking time. Search by keyword and city, paste a URL, or use listing ids. Detail mode adds vehicle valuation and real estate checks.", "version": "1.0", "x-build-id": "Vrmivzt4amaccqzzR" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/silentflow~avito-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-silentflow-avito-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/silentflow~avito-scraper/runs": { "post": { "operationId": "runs-sync-silentflow-avito-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/silentflow~avito-scraper/run-sync": { "post": { "operationId": "run-sync-silentflow-avito-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": { "query": { "title": "Search query", "type": "string", "description": "Keyword to search for, for example 'iphone 15'." }, "location": { "title": "City", "type": "string", "description": "City to search in, for example 'Moscow' or 'moskva', from 15 supported Russian cities. Setting a city that has an operating metro system (Moscow, Saint Petersburg, Novosibirsk, Yekaterinburg, Kazan, Nizhny Novgorod, Samara) is what makes nearby metro stations, distance and walking time appear on the results. Clear this field for a nationwide search, or pick a supported city with no metro system, and metro data will not be included. An unrecognised city stops the run and lists every supported city.", "default": "moskva" }, "category": { "title": "Category", "enum": [ "phones", "cars", "apartments" ], "type": "string", "description": "Narrow the search to one category. Leave empty to search every category." }, "priceMin": { "title": "Minimum price (RUB)", "minimum": 0, "type": "integer", "description": "Only return listings priced at or above this amount, in Russian rubles." }, "priceMax": { "title": "Maximum price (RUB)", "minimum": 0, "type": "integer", "description": "Only return listings priced at or below this amount, in Russian rubles." }, "sort": { "title": "Sort results", "enum": [ "relevance", "newest", "cheapest", "expensive" ], "type": "string", "description": "Sort order for search results.", "default": "relevance" }, "searchUrl": { "title": "Avito search URL", "type": "string", "description": "A full Avito.ru search URL, for example https://www.avito.ru/moskva/telefony?q=iphone. Leave empty to use the search fields above instead.", "default": "" }, "listingUrls": { "title": "Listing URLs or ids", "type": "array", "description": "Full Avito listing URLs or bare listing ids, one per line. When this list is not empty, it replaces search entirely: only these listings are fetched, each one's own page always visited for full detail and billed individually. A few fields that only come from a search result (address id, image alt text, condition label, contact methods) are not present this way.", "items": { "type": "string" } }, "maxResults": { "title": "Maximum results", "minimum": 1, "type": "integer", "description": "Maximum number of listings to collect. No fixed limit, set this to what you need.", "default": 100 }, "includeDetails": { "title": "Visit each listing page", "type": "boolean", "description": "Visit each listing's own page for full details: description, seller info, view counts, and category-specific data such as vehicle valuation or real estate registry checks. Disable for faster search-only scraping.", "default": true }, "includeReviews": { "title": "Include model reviews", "type": "boolean", "description": "Include the reviews summary for the listing's product model, when Avito has one for that model. Turning this on visits each listing's own page to read it, the same page fetch 'Visit each listing page' uses, even if that setting is off.", "default": false }, "debugMode": { "title": "Debug mode", "type": "boolean", "description": "Enable verbose logging for troubleshooting.", "default": false } } }, "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 } } } } } } } } } }