{ "openapi": "3.0.1", "info": { "title": "Avito Scraper - Listings, Prices, Real Estate & Sellers", "description": "Scrape Avito.ru listings by search term, category, city or URL: price, address, coordinates, date, photos, seller name, type and rating. Real estate filters: rooms, area, floor. Optional details: full description, parameters, views. Monitor mode. $2.60 per 1,000 listings, no login.", "version": "0.1", "x-build-id": "EFdmZhL7u4WtcPCFW" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/topapi~avito-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-topapi-avito-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/topapi~avito-scraper/runs": { "post": { "operationId": "runs-sync-topapi-avito-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/topapi~avito-scraper/run-sync": { "post": { "operationId": "run-sync-topapi-avito-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": { "queries": { "title": "Search terms", "type": "array", "description": "What you would type in Avito's search box, one per line, e.g. \"iphone 15\", \"диван угловой\", \"велосипед\". Each term runs in every location below.", "items": { "type": "string" } }, "startUrls": { "title": "Avito URLs", "type": "array", "description": "Avito search or category URLs (every filter you set in the browser is kept), or listing URLs. You can also link a text file of URLs.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "itemIds": { "title": "Listing ids", "type": "array", "description": "Avito listing ids (the number at the end of a listing URL), e.g. \"8279423619\". Each becomes one row.", "items": { "type": "string" } }, "location": { "title": "Locations", "type": "array", "description": "City or region, by name or Avito slug, e.g. \"Москва\", \"Saint Petersburg\", \"kazan\", \"Татарстан\". Empty = the whole of Russia.", "items": { "type": "string" } }, "category": { "title": "Category", "enum": [ "all", "transport", "cars", "motorcycles", "trucks", "boats", "parts", "realty", "apartments", "rooms", "houses", "land", "garages", "commercial", "realty_abroad", "jobs", "resumes", "services", "personal", "clothing", "kids_clothing", "kids_goods", "watches_jewelry", "beauty_health", "home_garden", "appliances", "furniture", "kitchenware", "food", "repair_building", "plants", "electronics", "phones", "audio_video", "computer_goods", "games_consoles", "laptops", "desktops", "cameras", "tablets", "office_equipment", "hobby", "tickets_travel", "bicycles", "books", "collectibles", "music_instruments", "hunting_fishing", "sport", "animals", "dogs", "cats", "pet_goods", "business", "ready_business", "business_equipment" ], "type": "string", "description": "Avito category to search in. Works with or without search terms.", "default": "all" }, "categoryPath": { "title": "Category path (advanced)", "type": "string", "description": "Any Avito category path instead of the list above, as it appears in Avito URLs, e.g. \"telefony/mobilnye_telefony/apple\"." }, "dealType": { "title": "Deal type (real estate)", "enum": [ "any", "sale", "resale", "new", "rent", "daily", "buy", "rent_wanted" ], "type": "string", "description": "For apartments, rooms, houses, land, garages and commercial real estate.", "default": "any" }, "priceMin": { "title": "Minimum price, ₽", "minimum": 0, "type": "integer", "description": "Lowest price in roubles, e.g. 10000." }, "priceMax": { "title": "Maximum price, ₽", "minimum": 0, "type": "integer", "description": "Highest price in roubles, e.g. 50000." }, "sort": { "title": "Sort by", "enum": [ "relevance", "newest", "cheapest", "expensive" ], "type": "string", "description": "Avito's own sort order. \"Newest first\" pairs with monitor mode.", "default": "relevance" }, "sellerType": { "title": "Seller type", "enum": [ "any", "private", "company" ], "type": "string", "description": "Private sellers or companies only.", "default": "any" }, "withDeliveryOnly": { "title": "With Avito Delivery only", "type": "boolean", "description": "Only listings that can be shipped with Avito Delivery.", "default": false }, "localOnly": { "title": "Prefer the chosen location", "type": "boolean", "description": "Avito's \"localPriority\" switch: on = listings from the chosen location first; off = Avito's default mix." }, "rooms": { "title": "Rooms (real estate)", "type": "array", "description": "Apartments and rooms: number of rooms, several allowed.", "items": { "type": "string", "enum": [ "studio", "1", "2", "3", "4", "5", "6", "free_layout" ], "enumTitles": [ "Studio", "1 room", "2 rooms", "3 rooms", "4 rooms", "5 rooms", "6 rooms", "Free layout" ] } }, "areaMin": { "title": "Area from, m²", "minimum": 0, "type": "integer", "description": "Real estate: total area from, m² (house area for houses)." }, "areaMax": { "title": "Area to, m²", "minimum": 0, "type": "integer", "description": "Real estate: total area up to, m²." }, "floorMin": { "title": "Floor from", "minimum": 0, "type": "integer", "description": "Apartments and rooms: floor from." }, "floorMax": { "title": "Floor to", "minimum": 0, "type": "integer", "description": "Apartments and rooms: floor up to." }, "houseType": { "title": "House type (real estate)", "type": "array", "description": "Wall material of the building, several allowed.", "items": { "type": "string", "enum": [ "brick", "panel", "block", "monolith", "monolith_brick", "wood" ], "enumTitles": [ "Brick", "Panel", "Block", "Monolith", "Monolith-brick", "Wood" ] } }, "renovation": { "title": "Renovation (real estate)", "type": "array", "description": "Renovation state, several allowed. Sale listings offer renovated / needs repair; rentals also cosmetic, euro and designer.", "items": { "type": "string", "enum": [ "renovated", "needs_repair", "cosmetic", "euro", "designer" ], "enumTitles": [ "Renovated", "Needs repair", "Cosmetic", "Euro", "Designer" ] } }, "landAreaMin": { "title": "Land area from, sotka", "minimum": 0, "type": "integer", "description": "Houses and land plots: plot area from, in sotka (100 m²)." }, "landAreaMax": { "title": "Land area to, sotka", "minimum": 0, "type": "integer", "description": "Houses and land plots: plot area up to, in sotka." }, "realtySellerType": { "title": "Real estate seller", "type": "array", "description": "Owners, developers or agencies (Avito's own real estate seller filter).", "items": { "type": "string", "enum": [ "owner", "developer", "agency" ], "enumTitles": [ "Private owners", "Developers", "Agencies" ] } }, "metroWalkMinutes": { "title": "Walk to metro, minutes", "enum": [ "5", "10", "15", "20", "30" ], "type": "string", "description": "Real estate in metro cities: at most this many minutes on foot to the metro." }, "filters": { "title": "Other Avito filters (advanced)", "type": "object", "description": "Any Avito filter by its own parameter id: values as a list, ranges as {\"from\",\"to\"}, e.g. {\"121749\": [\"1069839\"], \"2952\": {\"from\": 5}}. Easier: set filters on avito.ru and paste the URL." }, "includeKeywords": { "title": "Must contain", "type": "array", "description": "Keep a listing only if its title or description contains at least one of these words, e.g. \"оригинал\".", "items": { "type": "string" } }, "excludeKeywords": { "title": "Must not contain", "type": "array", "description": "Drop a listing if its title or description contains any of these words, e.g. \"копия\", \"на запчасти\".", "items": { "type": "string" } }, "descriptionKeywords": { "title": "Words in description (all)", "type": "array", "description": "Keep a listing only if its text contains every one of these words, e.g. \"балкон\". With details on, the full description is checked.", "items": { "type": "string" } }, "withPhotoOnly": { "title": "With photos only", "type": "boolean", "description": "Drop listings without photos.", "default": false }, "minSellerRating": { "title": "Minimum seller rating", "minimum": 0, "maximum": 5, "type": "number", "description": "Keep listings whose seller rating is at least this (0-5), e.g. 4.5. Sellers with no rating are dropped." }, "notFirstFloor": { "title": "Not the first floor", "type": "boolean", "description": "Apartments and rooms: drop first-floor listings.", "default": false }, "notLastFloor": { "title": "Not the top floor", "type": "boolean", "description": "Apartments and rooms: drop top-floor listings.", "default": false }, "postedWithinDays": { "title": "Posted within, days", "minimum": 1, "maximum": 365, "type": "integer", "description": "Only listings posted or raised in the last N days, e.g. 1. Pairs with \"Newest first\"." }, "sinceDate": { "title": "Posted since", "type": "string", "description": "Only listings posted or raised on or after this date." }, "flagUnderpriced": { "title": "Flag underpriced listings", "type": "boolean", "description": "Adds \"underpriced\" (price below 80% of the median on the same results page) and \"pageMedianPrice\". Avito's own market badge is always in \"marketPriceBadge\".", "default": false }, "includeDetails": { "title": "Listing details", "type": "boolean", "description": "Full description, every parameter, views (total and today), breadcrumbs, exact address, all photos, seller registration date, building and rent terms for real estate. $0.0081 per listing.", "default": false }, "monitorMode": { "title": "Monitor mode", "type": "boolean", "description": "Deliver only listings not delivered by earlier runs of this monitor (and re-priced ones, see below). Use with \"Newest first\".", "default": false }, "monitorPriceChanges": { "title": "Also deliver price changes", "type": "boolean", "description": "In monitor mode, also deliver a known listing again when its price changed (with \"previousPrice\").", "default": true }, "monitorStoreName": { "title": "Monitor name", "type": "string", "description": "Name of the key-value store that remembers delivered listings. Use one name per monitored search, e.g. \"moscow-iphone\".", "default": "avito-monitor" }, "maxResults": { "title": "Max listings", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Total listings to deliver in this run. Avito serves 50 per page and 30 pages per search; past that the run splits the search by price. 0 = no limit.", "default": 100 }, "maxResultsPerSearch": { "title": "Max listings per search", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Cap for each search term × location (or URL). 0 = no per-search cap." }, "maxPagesPerSearch": { "title": "Max pages per search", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Pages of 50 listings to read per search (and per price band when splitting).", "default": 100 }, "splitByPrice": { "title": "Split big searches by price", "type": "boolean", "description": "When a search has more listings than Avito serves (1,500 per search), run it again in price bands to collect the rest.", "default": true }, "compact": { "title": "Compact output", "type": "boolean", "description": "Core fields only (id, URL, title, price, location, coordinates, seller, date) - small rows for AI/MCP pipelines and spreadsheets.", "default": false }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Leave as is: the run starts on Apify's datacenter proxy and moves to residential when Avito blocks it. Add your own proxy URLs to use them first.", "default": { "useApifyProxy": true } }, "residentialCountry": { "title": "Residential proxy country", "enum": [ "RU", "KZ", "US" ], "type": "string", "description": "Country of the residential connection used after datacenter IPs are blocked.", "default": "RU" }, "maxConcurrency": { "title": "Parallel requests", "minimum": 1, "maximum": 8, "type": "integer", "description": "Listing pages opened in parallel (details). Higher is faster; Avito blocks fast bursts.", "default": 3 } } }, "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 } } } } } } } } } }