{ "openapi": "3.0.1", "info": { "title": "RU Marketplace Search: Wildberries + Avito + Yandex Market", "description": "Search Wildberries and Yandex Market by keyword, and scan Avito by category, to get back a single unified product dataset: title, price, rating, reviews, seller, and stock status, tagged by marketplace. Built for cross-marketplace price comparison and catalog research.", "version": "0.4", "x-build-id": "zQaEIMpQoFzM5cIYg" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/getascraper~ru-marketplace-search/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-getascraper-ru-marketplace-search", "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~ru-marketplace-search/runs": { "post": { "operationId": "runs-sync-getascraper-ru-marketplace-search", "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~ru-marketplace-search/run-sync": { "post": { "operationId": "run-sync-getascraper-ru-marketplace-search", "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": { "keywords": { "title": "Search keywords (Wildberries + Yandex Market)", "type": "array", "description": "Product keywords to search, in Russian or English (e.g. \"робот пылесос\", \"iphone 15\"). Each keyword is searched on Wildberries and Yandex Market (whichever you select below). Avito uses category URLs instead - see below.", "default": [ "робот пылесос" ], "items": { "type": "string" } }, "avitoCategoryUrls": { "title": "Avito category URLs", "type": "array", "description": "Avito category browse pages to scan (e.g. \"https://www.avito.ru/moskva/telefony\"). Avito does not support free-text keyword search over a stable connection, so this Actor scans real category listings instead of searching by keyword for this one marketplace - see AGENTS.md.", "default": [], "items": { "type": "string" } }, "marketplaces": { "title": "Marketplaces", "type": "array", "description": "Which marketplaces to search. Ozon is not offered (CAPTCHA-walled, out of scope).", "items": { "type": "string", "enum": [ "wildberries", "yandex_market", "avito" ], "enumTitles": [ "Wildberries", "Yandex Market", "Avito (category URLs only)" ] }, "default": [ "wildberries", "yandex_market", "avito" ] }, "maxItemsPerMarketplace": { "title": "Max products per marketplace", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum products per marketplace for the whole run, counted across all keywords and categories combined. Set 20 and each marketplace returns at most 20 rows total, no matter how many keywords you search.", "default": 50 }, "region": { "title": "Wildberries warehouse region", "enum": [ "MOSCOW", "KRASNODAR", "NOVOSIBIRSK", "EKATERINBURGO", "KAZAHSTAN", "ST_PETERSBURG" ], "type": "string", "description": "Regional warehouse used for Wildberries pricing/availability. Does not affect Yandex Market or Avito.", "default": "MOSCOW" }, "debugLogging": { "title": "Verbose debug logs", "type": "boolean", "description": "Print extra per-keyword/category tracing to the run log.", "default": false }, "proxyConfiguration": { "title": "Avito proxy configuration", "type": "object", "description": "Proxy used only for the Avito leg. RU residential (the default) is required to clear Avito's anti-bot gate. Wildberries and Yandex Market manage their own proxy tiers internally.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "RU" } } } }, "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 } } } } } } } } } }