{ "openapi": "3.0.1", "info": { "title": "Avito RU $1💰 URL | Keyword Filters | Enriched Output", "description": "From $1/1k. Pull structured listing data from avito.ru by region, category, or direct URL. Supports filters and auto-pagination. Returns 25+ fields per listing, including price, full address, metro details, images, posting date, seller type, and verification badges.", "version": "3.8", "x-build-id": "XjB6VYhsb11JyHZl8" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/abotapi~avito-ru-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-abotapi-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/abotapi~avito-ru-scraper/runs": { "post": { "operationId": "runs-sync-abotapi-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/abotapi~avito-ru-scraper/run-sync": { "post": { "operationId": "run-sync-abotapi-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", "required": [ "mode" ], "properties": { "mode": { "title": "🎯 Mode", "enum": [ "search", "url" ], "type": "string", "description": "Pick how you want to find listings. 'Search by filters' resolves a region + category + filters into a search URL automatically. 'Direct URLs' takes one or more avito.ru URLs you have already copy-pasted from your browser.", "default": "search" }, "regions": { "title": "Regions", "type": "array", "description": "Region slugs (Search mode only). Examples: 'moskva', 'sankt-peterburg', 'rossiya' (all of Russia). Multiple regions are scraped sequentially. Default: moskva.", "items": { "type": "string" } }, "category": { "title": "Category", "enum": [ "kvartiry", "doma_dachi_kottedzhi", "komnaty", "garazhi_i_mashinomesta", "kommercheskaya_nedvizhimost", "zemelnye_uchastki", "avtomobili", "mototsikly_i_mototehnika", "gruzoviki_i_spectehnika", "vodnyy_transport", "zapchasti_i_aksessuary", "rabota", "uslugi", "predlozheniya_uslug", "rezyume", "vakansii", "bytovaya_elektronika", "telefony", "noutbuki", "audio_i_video", "dlya_doma_i_dachi", "mebel_i_interer", "hobbi_i_otdyh", "zhivotnye", "lichnye_veschi", "odezhda_obuv_aksessuary", "detskaya_odezhda_i_obuv", "tovary_dlya_detey_i_igrushki", "shops", "gotovyy_biznes_i_oborudovanie" ], "type": "string", "description": "Top-level category. Pick the kind of listings you want.", "default": "kvartiry" }, "dealType": { "title": "Deal type", "enum": [ "any", "prodam", "sdam" ], "type": "string", "description": "Sale or Rent. Only applies to property categories (apartments, houses, rooms, garages, commercial, land). Ignored for other categories. Avito only exposes two top-level deal types per category; the slugs are 'prodam' (sale) and 'sdam' (rent, long-term).", "default": "prodam" }, "query": { "title": "Free text search", "type": "string", "description": "Optional text query (matches titles and descriptions). E.g. 'tesla', 'iPhone 15', 'студия у метро'." }, "minPrice": { "title": "Min price (₽)", "minimum": 0, "type": "integer", "description": "Minimum price in rubles. Leave empty for no minimum." }, "maxPrice": { "title": "Max price (₽)", "minimum": 0, "type": "integer", "description": "Maximum price in rubles. Leave empty for no maximum." }, "sortBy": { "title": "Sort order", "enum": [ "default", "date_desc", "price_asc", "price_desc" ], "type": "string", "description": "How to order results.", "default": "default" }, "ownerOnly": { "title": "Private sellers only", "type": "boolean", "description": "If true, exclude agency / professional sellers, return only private (С/Собственник) postings.", "default": false }, "urls": { "title": "Direct URLs", "type": "array", "description": "Avito.ru search/category URLs to scrape (URL mode only). Multi-URL supported. Filter-mode fields are ignored. Pagination starts at the page in the URL and walks forward.", "items": { "type": "string" } }, "maxPages": { "title": "Max pages per search", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Maximum pages to paginate per region/URL. Avito returns ~50-60 listings per page; Avito caps SERP at page 100 for most categories.", "default": 1000 }, "maxListings": { "title": "Max listings", "minimum": 0, "type": "integer", "description": "Hard global cap on total listings written to the dataset across ALL searches (every region in search mode, every URL in URL mode). The actor stops as soon as this number is reached. Set 0 for unlimited (subject to maxPages).", "default": 20 }, "fetchDetails": { "title": "Fetch detail pages", "type": "boolean", "description": "If true (default), each listing's detail page is fetched to enrich with the 21-key attributes dict (floor, ceilings, balcony type, parking, etc.), full photo gallery, view counts, and seller stats — 38 total fields. Lean mode (false) skips detail fetches and returns 27 of 38 fields from the SERP card alone (including full description, address, metro, photos, badges, rooms, area, floor) and runs ~8x faster. Disable for speed-sensitive or high-volume scrapes.", "default": true }, "proxy": { "title": "Proxy configuration", "type": "object", "description": "Default: Apify Proxy with the datacenter pool — works for most runs and is ~17x cheaper bandwidth than residential. RECOMMENDED: switch to RESIDENTIAL if you hit sustained rejections, run high-volume scrapes, or need maximum reliability. Add 'RESIDENTIAL' to apifyProxyGroups to enable it." } } }, "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 } } } } } } } } } }