{ "openapi": "3.0.1", "info": { "title": "Avito Scraper - Avito.ru Listings, Prices, Sellers & Rentals", "description": "Avito scraper for avito.ru: search by keyword, city, category or URL and get every ad as a row with title, price in roubles, private or business seller, location, coordinates and photos. For price research, dealer monitoring and rental tracking across Russia. No login or API key.", "version": "0.2", "x-build-id": "Sh4bfesUnlbZ4b9VW" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/s-r~avito-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-s-r-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/s-r~avito-scraper/runs": { "post": { "operationId": "runs-sync-s-r-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/s-r~avito-scraper/run-sync": { "post": { "operationId": "run-sync-s-r-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": "Query", "type": "string", "description": "What to search for on Avito, in Russian or in Latin letters. Combined with the city and category below into one search. Leave empty if you are pasting your own search URLs instead." }, "location": { "title": "Location", "type": "string", "description": "The city or region slug exactly as it appears in an Avito URL, for example 'moskva', 'sankt-peterburg' or 'kaliningrad'. Use 'all' to search the whole of Russia.", "default": "all" }, "category": { "title": "Category", "type": "string", "description": "The category slug from an Avito URL, for example 'telefony' for phones, 'kvartiry' for flats or 'avtomobili' for cars. Leave empty to search every category." }, "searchUrls": { "title": "Searchurls", "type": "array", "description": "Full Avito search or category URLs to read, pasted straight from the browser. Anything here is used instead of the search term, city and category above, so your own filters are kept exactly as you set them.", "items": { "type": "string" } }, "listingUrls": { "title": "Listingurls", "type": "array", "description": "Individual Avito listing URLs to read one by one. Use this when you already know which adverts you want rather than searching for them.", "items": { "type": "string" } }, "priceMin": { "title": "Pricemin", "minimum": 0, "type": "integer", "description": "Lowest price to include, in roubles. Applies to the search term path, not to search URLs you paste yourself." }, "priceMax": { "title": "Pricemax", "minimum": 0, "type": "integer", "description": "Highest price to include, in roubles. Applies to the search term path, not to search URLs you paste yourself." }, "sort": { "title": "Sort", "enum": [ "relevance", "date", "price_asc", "price_desc" ], "type": "string", "description": "How Avito should order the results before we read them. Newest first is the one to use for monitoring a category over time.", "default": "relevance" }, "sellerType": { "title": "Sellertype", "enum": [ "any", "private", "company" ], "type": "string", "description": "Restrict the search to private adverts or to business adverts. Useful for separating genuine second-hand supply from dealer inventory.", "default": "any" }, "onlyWithPhoto": { "title": "Onlywithphoto", "type": "boolean", "description": "Skip adverts that carry no photograph. Photoless adverts on classifieds sites are disproportionately stale or placeholder listings.", "default": false }, "maxItems": { "title": "Maxitems", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Stop after this many listings. Avito returns 50 per page, so 200 is four pages. Free-plan runs are capped at 10 rows regardless of this number.", "default": 50 }, "cursor": { "title": "Cursor", "type": "string", "description": "Opaque continuation token returned as next_cursor. Keep all other input fields unchanged." } } }, "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 } } } } } } } } } }