{ "openapi": "3.0.1", "info": { "title": "Avito Listings Scraper API", "description": "Scrape Avito.ru listings by keyword, category, city or a search URL you paste. Each row has id, title, price, city, seller name and type, publish date and photos. Coordinates come only if the seller added them. If not, that field is empty. $0.30 per 1,000 ads.", "version": "0.1", "x-build-id": "3DLp3pgFLVfb6i35F" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dami_studio~avito-listings-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dami_studio-avito-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/dami_studio~avito-listings-scraper/runs": { "post": { "operationId": "runs-sync-dami_studio-avito-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/dami_studio~avito-listings-scraper/run-sync": { "post": { "operationId": "run-sync-dami_studio-avito-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": { "query": { "title": "Search terms", "type": "string", "description": "What to search for, in Russian — for example \"iphone 15\", \"диван\", \"велосипед\". Leave empty to browse a whole category." }, "searchUrls": { "title": "Avito search URLs", "type": "array", "description": "Optional. Paste Avito search or category URLs instead of filling in the fields above, e.g. https://www.avito.ru/moskva/avtomobili?cd=1&pmin=500000. The region, category, search text, price range, seller type and sort order in the URL are all read.", "items": { "type": "string" } }, "sellerType": { "title": "Seller type", "enum": [ "any", "private", "company" ], "type": "string", "description": "Return only private sellers or only businesses (shops, dealers, agencies). Avito ignores its own seller filter in some categories, so the actor also checks every row and drops the ones that do not match — dropped rows are never charged." }, "localOnly": { "title": "Stay inside the chosen region", "type": "boolean", "description": "On by default. Avito treats a region as a relevance boost rather than a filter: on page 50 of a Moscow search, most listings are actually from Kaluga, Tver and Smolensk. This sends Avito's own localPriority flag so only the chosen region comes back. Turn it off to get Avito's default mixed results." }, "region": { "title": "Region or city", "type": "array", "description": "Avito region, by English name (\"Moscow\", \"Saint Petersburg\", \"Kazan\"), Russian name (\"Москва\"), or the slug from an Avito URL (\"moskva\", \"sankt-peterburg\", \"moskovskaya_oblast\"). Leave empty for the whole of Russia. Add several to run one search per region.", "items": { "type": "string" } }, "category": { "title": "Category", "type": "array", "description": "Avito category by English name (\"cars\", \"phones\", \"flats\", \"jobs\", \"furniture\"), Russian name (\"автомобили\"), or the slug from an Avito URL (\"avtomobili\", \"kvartiry/prodam\"). Leave empty to search every category.", "items": { "type": "string" } }, "sort": { "title": "Sort order", "enum": [ "default", "newest", "cheapest", "expensive" ], "type": "string", "description": "Avito's own ordering. \"Default\" is its relevance ranking, which puts promoted listings first." }, "minPrice": { "title": "Minimum price (RUB)", "minimum": 0, "type": "integer", "description": "Optional lower price bound, in roubles." }, "maxItems": { "title": "Maximum listings", "minimum": 1, "maximum": 50000, "type": "integer", "description": "How many listings to return in total across all searches. Each returned listing is one charged result. Avito caps any single search at 5,000 listings (100 pages of 50) — add regions, price bands or sub-categories to go past that." }, "maxPrice": { "title": "Maximum price (RUB)", "minimum": 0, "type": "integer", "description": "Optional upper price bound, in roubles." }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Optional. The actor works without a proxy — it uses the Apify container address and falls back to Apify datacentre sessions on its own. Supply your own proxy URLs here if you have Russian addresses you would rather use; they are used exactly as given. Metered Apify groups (RESIDENTIAL, GOOGLE_SERP) are not offered and are replaced with rotating datacentre addresses." } } }, "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 } } } } } } } } } }