{ "openapi": "3.0.1", "info": { "title": "Avito Scraper — Russia Classifieds & Prices (avito.ru)", "description": "Scrape Avito.ru search results without login or API key: price, parameters, seller name & rating, address, GPS coordinates, metro, photos and dates. Keyword, category, city, sort and price filters; tens of thousands of listings per run. Export to CSV, Excel or JSON.", "version": "1.0", "x-build-id": "g41gZ3QE10uuT8p8o" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/logiover~avito-ru-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-logiover-avito-ru-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/logiover~avito-ru-scraper/runs": { "post": { "operationId": "runs-sync-logiover-avito-ru-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/logiover~avito-ru-scraper/run-sync": { "post": { "operationId": "run-sync-logiover-avito-ru-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": { "searchQueries": { "title": "Search queries", "type": "array", "description": "Keywords to search on Avito.ru, exactly as you would type them in the Avito search box — e.g. 'iphone 15', 'bmw x5', 'квартира у метро', 'диван'. Each keyword is a separate search. Leave EMPTY to browse a category and/or location without a keyword.", "items": { "type": "string" } }, "categoryId": { "title": "Category", "type": "string", "description": "Optional Avito category. Pick one from the list or type any numeric Avito category ID. Works with or without a keyword. Leave empty for all categories." }, "locationId": { "title": "Location (city / region)", "type": "string", "description": "Optional Avito location. Pick a city from the list or type any numeric Avito location ID. Leave empty to search all of Russia. For a city that is not in the list, use 'Location by name' below." }, "locationName": { "title": "Location by name", "type": "string", "description": "Optional. Any Russian city, town or region by name — e.g. 'Казань', 'Тверь', 'Краснодарский край' (Russian names work best). The Actor looks up Avito's location ID for you. Ignored when 'Location (city / region)' is set." }, "sort": { "title": "Sort order", "enum": [ "default", "newest", "price_asc", "price_desc" ], "type": "string", "description": "Order of results, as on avito.ru. 'Default' is Avito's relevance order, which lists at most 1,500 results per search — when you ask for more, the Actor switches to newest first, which goes up to 5,000 per search (and beyond with automatic price bands).", "default": "default" }, "minPrice": { "title": "Minimum price (₽)", "minimum": 0, "type": "integer", "description": "Optional lower price limit in Russian roubles." }, "maxPrice": { "title": "Maximum price (₽)", "minimum": 0, "type": "integer", "description": "Optional upper price limit in Russian roubles." }, "maxItemsPerQuery": { "title": "Max listings per search", "minimum": 1, "type": "integer", "description": "How many listings to collect for each keyword (or for the browse search). Avito pages hold 50 listings. Above 5,000 the search is split into price bands automatically, so tens of thousands are possible for big categories.", "default": 1000 }, "maxResults": { "title": "Max listings in total", "minimum": 0, "type": "integer", "description": "Overall cap on listings saved by the run across all searches. 0 = no overall cap (each search is still limited by 'Max listings per search').", "default": 100 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Optional. The Actor connects directly first and moves on to Apify Proxy (datacenter, then residential) only when Avito rate-limits an address, solving Avito's browser check on the way. The default works as is; residential proxies are used automatically when needed.", "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 }, "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 } } } } } } } } } }