{ "openapi": "3.0.1", "info": { "title": "Avito Listings Scraper: Prices, Details and New Ads", "description": "Scrape public Avito listings by search words or links into clean rows with prices, locations, seller type, photos and full details. Add model reviews, price comparison and only-new monitoring. No phone numbers.", "version": "0.1", "x-build-id": "IurrqvZrFhb4pJpz6" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/cliqtomedia~avito-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-cliqtomedia-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/cliqtomedia~avito-scraper/runs": { "post": { "operationId": "runs-sync-cliqtomedia-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/cliqtomedia~avito-scraper/run-sync": { "post": { "operationId": "run-sync-cliqtomedia-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": { "query": { "title": "Search words", "type": "string", "description": "Words to find in public Avito listings. Used when no search links or listing links are given." }, "region": { "title": "Region", "type": "string", "description": "Region path from an Avito search link, such as moskva or sankt-peterburg. Use rossiya for Russia.", "default": "moskva" }, "searchUrls": { "title": "Search links", "type": "array", "description": "Public Avito search links. Their category and filters are kept. Search words are used only when this list is empty.", "items": { "type": "string" }, "default": [] }, "queries": { "title": "More search phrases", "type": "array", "description": "Run several phrases in the selected region. Used instead of Search words when no links are given.", "items": { "type": "string" }, "default": [] }, "listingUrls": { "title": "Listing links", "type": "array", "description": "Public Avito listing links or numeric listing IDs. No phone numbers or personal email addresses are returned.", "items": { "type": "string" }, "default": [] }, "categoryPath": { "title": "Category path", "type": "string", "description": "Optional path after the region, such as velosipedy or kvartiry/prodam. Copy it from an Avito search link." }, "maxItems": { "title": "Maximum listings", "minimum": 1, "maximum": 20000, "type": "integer", "description": "Maximum number of listings saved across all inputs. Duplicate listing IDs are saved once.", "default": 10 }, "includeDetails": { "title": "Read full listing details", "type": "boolean", "description": "Add descriptions, photos, parameters, coordinates and publication times. For supported secondary homes for sale, also read Avito’s price estimate. Slower than search results alone.", "default": false }, "includeReviews": { "title": "Read model reviews", "type": "boolean", "description": "For supported products, add public reviews about the model. Names and contacts of review authors are excluded. Full details are also read.", "default": false }, "includeComparables": { "title": "Compare model prices", "type": "boolean", "description": "For supported products, add price statistics from up to 35 matching offers, or up to 10 when Avito limits the direct route. Avito chooses the region of these offers, so check modelComparables.region. Full details are also read.", "default": false }, "maxReviews": { "title": "Maximum reviews per listing", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum public model reviews to save for each listing. Used only when model reviews are enabled.", "default": 1000 }, "minPrice": { "title": "Minimum price (RUB)", "minimum": 0, "type": "integer", "description": "Only listings at or above this price." }, "maxPrice": { "title": "Maximum price (RUB)", "minimum": 0, "type": "integer", "description": "Only listings at or below this price." }, "sort": { "title": "Sort order", "enum": [ "relevance", "newest", "cheapest", "expensive" ], "type": "string", "description": "Avito search order. A sort in a pasted search link takes priority.", "default": "relevance" }, "sellerType": { "title": "Seller type", "enum": [ "any", "private", "company" ], "type": "string", "description": "Choose all sellers, private sellers or businesses.", "default": "any" }, "localOnly": { "title": "Prefer the selected region", "type": "boolean", "description": "Ask Avito to prioritize results from the selected region.", "default": false }, "onlyNew": { "title": "Only new listings", "type": "boolean", "description": "Remember delivered IDs and skip them in later runs with the same searches. The latest 50,000 delivered IDs are kept.", "default": false }, "trackChanges": { "title": "Track changed listings", "type": "boolean", "description": "Return new listings and changes to their title, price, publication time or category. View counts, model statistics and the amount of optional detail data do not count as changes. Unseen records stay in the history.", "default": false }, "stateName": { "title": "History name", "type": "string", "description": "Optional name for a shared listing history in your private Actor storage. Leave empty to use a history for these searches." }, "excludeListingIds": { "title": "Skip listing IDs", "type": "array", "description": "Do not return these listing IDs.", "items": { "type": "string" }, "default": [] }, "skipNegotiablePrice": { "title": "Skip listings without a numeric price", "type": "boolean", "description": "Exclude listings that do not show a numeric price.", "default": false }, "flagUnderpriced": { "title": "Flag low prices in search results", "type": "boolean", "description": "Compare each ad with other priced ads from the same source page and category. At least 10 prices with the same price unit are needed. Flag ads priced 20% or more below the median. Model comparisons are not required.", "default": false }, "maxPagesPerSearch": { "title": "Maximum pages per search", "minimum": 1, "maximum": 100, "type": "integer", "description": "Stop a search after this many source pages. A source page cap is recorded in the run summary.", "default": 100 }, "deliveryConnector": { "title": "Send results to (optional)", "type": "string", "description": "Your Slack, Notion or other MCP connector. After the run the Actor posts a short summary there. Connect services once in Apify Console → MCP connectors." }, "deliveryTarget": { "title": "Notion page or channel (optional)", "type": "string", "description": "Where to post the summary: a Notion page link (each run is added on top of that page) or a Slack channel ID. Leave empty to let the connector decide." }, "checkIn": { "title": "Check-in date", "type": "string", "description": "For daily rentals, the first night in YYYY-MM-DD format. Also set Check-out date and leave the search phrase empty." }, "checkOut": { "title": "Check-out date", "type": "string", "description": "For daily rentals, the departure date in YYYY-MM-DD format. It must be after Check-in date." }, "guests": { "title": "Adult guests", "minimum": 1, "maximum": 50, "type": "integer", "description": "Number of adults for daily rentals. Leave the search phrase empty. Children are added separately." }, "childAges": { "title": "Children ages", "type": "array", "description": "Ages of children staying in a daily rental, from 0 to 17. The source must confirm these filters before results are saved.", "items": { "type": "integer", "minimum": 0, "maximum": 17 }, "default": [] } } }, "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 } } } } } } } } } }