{ "openapi": "3.0.1", "info": { "title": "Avito.ru Listings Scraper", "description": "Scrape Avito.ru classifieds by keyword, city, category or search URL: price, GPS, metro, seller type and rating, date, photos, promotions. Filter private / company sellers and dates; only new listings. Export to JSON, CSV or Excel.", "version": "0.0", "x-build-id": "gmP266a1Y0lrVyAT6" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/nice_dev~avito-listings-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-nice_dev-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/nice_dev~avito-listings-scraper/runs": { "post": { "operationId": "runs-sync-nice_dev-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/nice_dev~avito-listings-scraper/run-sync": { "post": { "operationId": "run-sync-nice_dev-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": { "startUrls": { "title": "Start URLs", "maxItems": 1000, "type": "array", "description": "Avito.ru search-result URLs (all filters set on the site are kept, pagination is automatic), e.g. `https://www.avito.ru/moskva/telefony?q=iphone`, or single listing URLs (`https://www.avito.ru/moskva/telefony/iphone_12_mini_128_gb_2_sim_8378800507`). When this list is not empty, the search fields below (keywords, locations, category, sort) and the price and delivery filters are ignored: set them on the site before copying the URL. **Seller type** and **Searched place only** still apply, checked on each listing, as do the Filters section, the caps and monitoring. A listing URL is always read as a listing page, whatever 'Extract details' says: its row is complete and charged at the details price (see the Pricing tab). Max 1 000 URLs.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "query": { "title": "Search keyword", "maxLength": 200, "type": "string", "description": "Free-text search, exactly as typed on the site (e.g. `iphone`). Give a keyword, a category or start URLs: Avito shows no listings for a place alone, so a run with none of them is refused." }, "searchQueries": { "title": "More search keywords", "maxItems": 100, "uniqueItems": true, "type": "array", "description": "Several keywords in one run: one search per keyword (times each location below). Added to **Search keyword**; listings found by several searches are saved once.", "default": [], "items": { "type": "string" } }, "location": { "title": "Location", "maxLength": 200, "type": "string", "description": "City or region: the Avito slug (`moskva`, `sankt-peterburg`, `kazan`, `all` = the whole of Russia) or a known name in Russian or English (`Москва`, `Moscow`). Empty = the whole of Russia. A name this Actor does not know and that is not written as a slug (lower-case letters, digits, hyphens and underscores, such as `nizhniy_novgorod`) is refused at the start, with a clear message; a slug Avito does not know fails its search at once, named in the log." }, "locations": { "title": "More locations", "maxItems": 100, "uniqueItems": true, "type": "array", "description": "Several locations in one run: every keyword is searched in every location (3 keywords × 4 locations = 12 searches, max 500). Added to **Location**.", "default": [], "items": { "type": "string" } }, "category": { "title": "Category", "enum": [ "", "transport", "avtomobili", "mototsikly_i_mototehnika", "gruzoviki_i_spetstehnika", "vodnyy_transport", "zapchasti_i_aksessuary", "nedvizhimost", "kvartiry/prodam", "kvartiry/sdam", "doma_dachi_kottedzhi/prodam", "doma_dachi_kottedzhi/sdam", "kommercheskaya_nedvizhimost", "zemelnye_uchastki", "rabota", "vakansii", "rezume", "predlozheniya_uslug", "lichnye_veschi", "odezhda_obuv_aksessuary", "detskaya_odezhda_i_obuv", "tovary_dlya_detey_i_igrushki", "krasota_i_zdorove", "chasy_i_ukrasheniya", "dlya_doma_i_dachi", "remont_i_stroitelstvo", "mebel_i_interer", "bytovaya_tehnika", "produkty_pitaniya", "rasteniya", "posuda_i_tovary_dlya_kuhni", "bytovaya_elektronika", "telefony", "audio_i_video", "tovary_dlya_kompyutera", "igry_pristavki_i_programmy", "noutbuki", "nastolnye_kompyutery", "fototehnika", "planshety_i_elektronnye_knigi", "orgtehnika_i_rashodniki", "hobbi_i_otdyh", "bilety_i_puteshestviya", "velosipedy", "knigi_i_zhurnaly", "kollektsionirovanie", "muzykalnye_instrumenty", "ohota_i_rybalka", "sport_i_otdyh", "zhivotnye", "sobaki", "koshki", "ptitsy", "akvarium", "drugie_zhivotnye", "tovary_dlya_zhivotnyh", "poteryannye_i_naidennye_zhivotnye", "dlya_biznesa", "oborudovanie_dlya_biznesa", "gotoviy_biznes" ], "type": "string", "description": "Avito category, as in the site address after the city (`telefony` = `avito.ru/moskva/telefony`). Empty = all categories. A category not in this list: paste its search URL in **Start URLs**.", "default": "" }, "maxItems": { "title": "Max listings", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Maximum number of listings to save for the whole run (after deduplication and filters). 0 = no limit. Avito serves at most about 1 500 listings per search in a city or region (about 5 000 for the whole of Russia): to get more, split it (**More locations**, a price range, a category).", "default": 100 }, "maxItemsPerQuery": { "title": "Max listings per search", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Cap for EACH search (keyword × location, or search URL), so that the first search cannot use up the whole **Max listings** budget. 0 = no per-search cap.", "default": 0 }, "sort": { "title": "Sort by", "enum": [ "relevance", "newest", "cheapest", "expensive", "discount" ], "type": "string", "description": "Order of the results on the site. With **Posted after** or **Only new listings**, the site's default order is replaced by `Newest first` so that the Actor can stop paging early (a pasted search URL keeps its own order: sort it by date on Avito before copying it); **Only new listings** works best with `Newest first`.", "default": "relevance" }, "extractDetails": { "title": "Extract details", "type": "boolean", "description": "Open each listing page for the full description (text and HTML), all the characteristics of the item, all photos, views, seller details (shop, company), publication status and end date. A listing read this way is charged as `result-with-details` instead of `result` (see the Pricing tab). Unticked (default) = the search-result fields only (title, price, address, photo, seller, date, short description), much faster and cheaper.", "default": false }, "includeMarketPrice": { "title": "Include market price", "type": "boolean", "description": "Add Avito's market price estimate (some cars and real estate), read on the listing page; billed per listing that has one, on top of its price (see the Pricing tab). Needs Extract details, or a listing URL in Start URLs: otherwise it is ignored.", "default": false }, "priceMin": { "title": "Min price (RUB)", "minimum": 0, "maximum": 1000000000000, "type": "integer", "description": "Lowest price, in Russian roubles." }, "priceMax": { "title": "Max price (RUB)", "minimum": 0, "maximum": 1000000000000, "type": "integer", "description": "Highest price, in Russian roubles." }, "sellerType": { "title": "Seller type", "enum": [ "any", "private", "company" ], "type": "string", "description": "Private sellers only, or companies and shops only. Checked on each listing card, so the result holds even for a page the site did not filter.", "default": "any" }, "withDeliveryOnly": { "title": "With Avito delivery only", "type": "boolean", "description": "Only listings that can be delivered through Avito Delivery.", "default": false }, "localOnly": { "title": "Searched place only", "type": "boolean", "description": "Avito mixes listings from other cities into a search (a few per page, a whole page for a small town with few matches). Tick to keep only the listings located in the place searched (**Location**); the others are not saved and do not count in **Max listings**. Applies to a city: a region (`moskovskaya_oblast`) keeps all its listings.", "default": false }, "postedAfter": { "title": "Posted after", "type": "string", "description": "Only listings published on or after this date: `2026-09-01`, or a period before now such as `7 days`, `2 weeks`, `1 month` (API: `24 hours` and full ISO date-times work too). The date read is the publication date shown by Avito, which is moved forward when the seller republishes or renews the listing. Listings without a publication date are dropped." }, "postedBefore": { "title": "Posted before", "type": "string", "description": "Only listings published on or before this date (the whole day is included), or older than a period such as `30 days`. Same date as **Posted after**: the (re)publication date shown by Avito." }, "excludeKeywords": { "title": "Exclude keywords", "maxItems": 50, "uniqueItems": true, "type": "array", "description": "Drop the listings whose title or description contains one of these words (case and accents ignored), e.g. `case`, `broken`.", "default": [], "items": { "type": "string" } }, "verifiedOnly": { "title": "Verified sellers only", "type": "boolean", "description": "Only listings whose seller Avito has verified (the verified-listing mark of the search result).", "default": false }, "withPhotosOnly": { "title": "Listings with photos only", "type": "boolean", "description": "Only listings whose search result shows at least one photo. Listings without a photo are dropped.", "default": false }, "minRating": { "title": "Min seller rating", "minimum": 0, "maximum": 5, "type": "number", "description": "Only sellers rated at least this (0-5 stars). Sellers without any rating are dropped.", "default": 0 }, "onlyNew": { "title": "Only new listings", "type": "boolean", "description": "Skip the listings that a previous run (same **Memory key**) already delivered: they are not saved and not charged, and their page is not even opened. First run = everything is new.", "default": false }, "stateKey": { "title": "Memory key", "pattern": "^[a-zA-Z0-9_-]{1,64}$", "maxLength": 64, "type": "string", "description": "Name of the memory used by **Only new listings**. Give each schedule / task its own key (e.g. `moscow-iphones`) so that they do not share their memory. Letters, digits, `-` and `_`.", "default": "default" }, "resetState": { "title": "Reset the memory", "type": "boolean", "description": "Forget everything remembered under this **Memory key** before the run: this run returns (and charges) every listing again. Untick it afterwards.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration (included proxy: paying users only)", "type": "object", "description": "Avito.ru only opens to Russian IP addresses: keep **Apify Proxy** and the Actor uses Russian residential IPs, included in the price (the proxy group, the country and **No proxy** chosen here are ignored). Your own proxies (`proxyUrls`) must be Russian. On the Apify free plan the included proxy is not available: add your own proxy URLs, or the run stops at once with a message.", "default": { "useApifyProxy": true } }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 50, "type": "integer", "description": "Maximum number of requests processed in parallel.", "default": 3 }, "maxRequestsPerMinute": { "title": "Max requests per minute", "minimum": 10, "maximum": 2000, "type": "integer", "description": "Most requests to the site in any 60 seconds. Counted: results pages and listing pages. Not counted: the site's access check when a new connection starts, a page asked again when the site says to wait, and redirects (they belong to the page that needs them). A budget, not an even pace: up to this many can leave at once when the minute starts (spread them with the minimum delay below). Lower it if the site answers HTTP 429 / 403 in the log.", "default": 36 }, "minRequestIntervalMs": { "title": "Min delay between requests", "minimum": 0, "maximum": 60000, "type": "integer", "description": "Smallest gap between two requests, in milliseconds, counting the same requests as above: results pages and listing pages. Unlike the per-minute rate, this spreads the requests evenly instead of letting them go out in a burst. 0 = no gap.", "default": 1700 }, "maxRequestRetries": { "title": "Max request retries", "minimum": 0, "maximum": 20, "type": "integer", "description": "Retries per request before it is marked as failed. A request the site turns away is also retried on a new Russian IP up to 10 times without using up these retries.", "default": 5 }, "debugLog": { "title": "Debug log", "type": "boolean", "description": "Include debug messages in the run log.", "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 }, "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 } } } } } } } } } }