{ "openapi": "3.0.1", "info": { "title": "Avito Seller Scraper - Profile, Listings & Ratings", "description": "Avito seller scraper for up to 10 seller profile links: each seller's active listings as rows, with title, price, category, city, photos and link, and the seller's name, private or business, member-since date, rating, reviews and subscribers on every row. $0.30 per 1,000 listings.", "version": "0.1", "x-build-id": "fF0W51gf862IF36Op" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dami_studio~avito-seller-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dami_studio-avito-seller-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/dami_studio~avito-seller-scraper/runs": { "post": { "operationId": "runs-sync-dami_studio-avito-seller-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/dami_studio~avito-seller-scraper/run-sync": { "post": { "operationId": "run-sync-dami_studio-avito-seller-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", "required": [ "sellerUrls" ], "properties": { "sellerUrls": { "title": "Seller profile links", "minItems": 1, "maxItems": 10, "type": "array", "description": "Links to Avito seller profiles, up to 10 per run. Any form Avito uses works: www.avito.ru/brands/{shop name}, www.avito.ru/brands/{id} or www.avito.ru/user/{id}/profile, and so do m.avito.ru links or links with /all or ?src=... on the end. A link to one of a seller's listings works too: the run finds that listing's seller and returns the seller's listings. If the listing is closed, paste the profile link instead.", "items": { "type": "string", "pattern": "^\\s*(?:[Hh][Tt][Tt][Pp][Ss]?:\\/\\/|\\/\\/)?(?:[A-Za-z0-9-]+\\.)*[Aa][Vv][Ii][Tt][Oo]\\.[Rr][Uu]\\/+(?:brands\\/+[^\\/?#\\s]+|user\\/+[^\\/?#\\s]+|(?:[^?#\\s]*\\/)?[^\\/?#\\s]*_\\d{6,}\\/?(?=[?#]|\\s*$))(?:[\\/?#]\\S*)?\\s*$" } }, "maxItems": { "title": "Maximum listings", "minimum": 1, "maximum": 15000, "type": "integer", "description": "Total listings for the whole run, across every seller. Each listing returned is charged. Avito stops showing a seller's listings after page 100, which is 1,200 or 1,500 listings depending on the seller, so a bigger seller ends there whatever this says.", "default": 1000 }, "sortBy": { "title": "Order", "enum": [ "default", "price_asc", "price_desc" ], "type": "string", "description": "The order each seller's listings come back in. Avito sorts the seller's grid itself. If Avito will not sort a seller that way, that seller is skipped and nothing is charged for it.", "default": "default" }, "skipNegotiablePrice": { "title": "Leave out listings with no price", "type": "boolean", "description": "Off by default. Some ads show no number for the price, only \"Цена договорная\" (price by agreement). They come back with price empty (null), Avito's text in priceText and priceNegotiable true. Turn this on to leave them out: they are not returned, not charged and do not count toward Maximum listings.", "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 } } } } } } } } } }