{ "openapi": "3.0.1", "info": { "title": "Avito (Авито) Scraper - Russian Classifieds Listings + Prices", "description": "Collect public Avito listings from any category, filter or keyword page: title, price in RUB, place, category, specs, photos, publish time and the listing URL. No login, no cookies. Rows are deduplicated; empty and partial inputs are reported separately and never charged.", "version": "0.0", "x-build-id": "JeTCdTICON0vBVyLC" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/lanternlab318~avito/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-lanternlab318-avito", "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/lanternlab318~avito/runs": { "post": { "operationId": "runs-sync-lanternlab318-avito", "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/lanternlab318~avito/run-sync": { "post": { "operationId": "run-sync-lanternlab318-avito", "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": "Keywords", "type": "array", "description": "One Avito search keyword per line, in Russian (iphone 13, диван, коляска детская). Each keyword is searched separately, in the region set below, and its listings are labelled with it. A listing that matches several keywords is returned once and charged once. Leave empty if you give listing page URLs instead.", "items": { "type": "string" } }, "searchUrls": { "title": "Listing page URLs", "type": "array", "description": "Avito result-list URLs, one per line - open the category, the filter or the search you want on avito.ru and copy the address bar: https://www.avito.ru/moskva/noutbuki, https://www.avito.ru/sankt-peterburg/avtomobili, https://www.avito.ru/moskva/kvartiry/prodam-ASgBAgICAUSSA8YQ. Every filter in the URL is kept. A URL copied from page 3 starts collecting at page 3.", "items": { "type": "string" } }, "city": { "title": "Region", "type": "string", "description": "Avito region slug, as it appears in the site's own URL: moskva, sankt-peterburg, ekaterinburg, novosibirsk. It is the region your keywords are searched in, and it also replaces the region of any listing page URL above, so one URL can be run across several cities. Leave empty to search all of Russia." }, "maxListings": { "title": "Max listings", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Upper bound on the listing rows this run writes in total. One Avito result page carries up to 50 listings, so this also decides how many pages per input the run may walk. The input that hits the bound is marked partial with reason \"listing_limit_reached\".", "default": 100 }, "maxListingsPerInput": { "title": "Max listings per keyword or URL", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Optional share of the run budget for one keyword or URL. Leave it empty and the first input may spend the whole of maxListings, which is what a run with a single input wants; set it when you give several inputs and want each of them collected. An input that reaches its share is marked partial with reason \"listing_limit_reached\" and the next input still gets its own." }, "maxUpstreamRequests": { "title": "Max Avito requests", "minimum": 1, "maximum": 300, "type": "integer", "description": "Hard ceiling on the HTTP requests this run sends to Avito, counting every result page, every retry and every firewall exchange. Left empty, the Actor works a ceiling out from your inputs and maxListings. At the ceiling collection stops - the inputs not reached are written with partialReason \"upstream_request_cap\" and the run then ends normally." }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "The proxy the requests to Avito go through. The default (Apify Proxy, datacenter) is the cheapest and is what this Actor is measured on: Avito answers it with a public proof-of-work challenge, which the Actor solves in-process without a login or a browser. Switch to residential only if your runs start reporting partialReason \"blocked\".", "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 } } } } } } } } } }