{ "openapi": "3.0.1", "info": { "title": "Avito Scraper - Listings, Prices, Sellers, Russia", "description": "Scrape Avito listings by search term, category, city or URL and get title, price in roubles, seller type, location, coordinates and photos as clean rows. Covers classifieds and rentals across the whole of Russia.", "version": "0.1", "x-build-id": "xgkQM28RRLBbNNTe7" }, "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": "Search term", "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": "City or region slug", "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 slug", "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": "Search URLs", "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": "Listing URLs", "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": "Minimum price", "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": "Maximum price", "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 order", "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": "Seller type", "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": "Only listings with photos", "type": "boolean", "description": "Skip adverts that carry no photograph. Photoless adverts on classifieds sites are disproportionately stale or placeholder listings.", "default": false }, "maxItems": { "title": "Maximum listings", "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 } } }, "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 } } } } } } } } } }