{ "openapi": "3.0.1", "info": { "title": "Avito Seller Profile Scraper: Профили продавцов Авито", "description": "Scrape Avito.ru seller profile pages - rating, review count, exact member-since date, verification badges, and a snapshot of active listings for any seller.", "version": "0.3", "x-build-id": "AIV6E0qkZAI0EYASg" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/getascraper~avito-seller-profile-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-getascraper-avito-seller-profile-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/getascraper~avito-seller-profile-scraper/runs": { "post": { "operationId": "runs-sync-getascraper-avito-seller-profile-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/getascraper~avito-seller-profile-scraper/run-sync": { "post": { "operationId": "run-sync-getascraper-avito-seller-profile-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 URLs or slugs", "type": "array", "description": "Avito seller profiles to scrape. Paste full profile links (e.g. 'https://www.avito.ru/brands/greats') or just the bare slug/id (e.g. 'greats'). Find the link on any listing by clicking through to the seller's storefront, which uses this same '/brands/' shape for both shops and individual sellers.", "default": [ "https://www.avito.ru/brands/greats" ], "items": { "type": "string" } }, "includeReviews": { "title": "Include buyer reviews", "type": "boolean", "description": "Add the seller's buyer reviews to the output, each with the reviewer name, star score, review date, the listing it refers to, the review text and any photos. Leave off for a fast profile snapshot; turn on when you need the full review history.", "default": false }, "maxReviews": { "title": "Max reviews per seller", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Upper limit on how many reviews to collect per seller when reviews are included. The first 25 come with the profile; higher values fetch extra review pages.", "default": 25 }, "maxActiveListings": { "title": "Max active listings per seller", "minimum": 0, "maximum": 200, "type": "integer", "description": "How many of the seller's active listings to include in the per-seller snapshot (id, title, price, url, location). Keep it low for a quick trust check, or raise it to collect a store's full active inventory, which fetches extra listing pages.", "default": 20 }, "maxItems": { "title": "Maximum sellers", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Maximum number of seller profiles to scrape from the provided list. Set 0 to process every URL you provided.", "default": 10 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Residential proxies are the default because Avito blocks datacenter exits on this site. You can switch to datacenter proxies to cut proxy cost, but expect some sellers to be skipped.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }, "includeRawData": { "title": "Include raw debug data", "type": "boolean", "description": "Attach a small raw-data debug object to each output item. Useful for troubleshooting, not needed for normal use.", "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 } } } } } } } } } }