{ "openapi": "3.0.1", "info": { "title": "Yandex Market Search & Price Scraper", "description": "Track prices on Russia's biggest marketplace. Turn search terms, categories and brand pages into one clean table of products with prices, sellers, ratings, delivery promises and stock counts. Watch competitors daily, audit your own listings, export to a spreadsheet.", "version": "0.0", "x-build-id": "6n7vUFnn66jepzI8k" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/apt_marble~yandex-market-search-price-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-apt_marble-yandex-market-search-price-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/apt_marble~yandex-market-search-price-scraper/runs": { "post": { "operationId": "runs-sync-apt_marble-yandex-market-search-price-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/apt_marble~yandex-market-search-price-scraper/run-sync": { "post": { "operationId": "run-sync-apt_marble-yandex-market-search-price-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": { "queries": { "title": "Search terms", "type": "array", "description": "Product searches to run, one per line. Each one is collected on its own and every row tells you which term it came from.", "items": { "type": "string" } }, "categoryUrls": { "title": "Category or brand addresses", "type": "array", "description": "Optional. Paste the address of any category, brand or filtered listing straight from the marketplace and it is collected exactly as you see it, including the filters you set. Single product addresses are rejected with a message.", "items": { "type": "string" } }, "maxResultsPerQuery": { "title": "Maximum products per search", "minimum": 1, "maximum": 50, "type": "integer", "description": "How many products to collect for each search term or address. The marketplace publishes roughly 390 products for any one search, so anything above that simply returns everything it publishes.", "default": 50 }, "sortBy": { "title": "Order results by", "enum": [ "popularity", "priceAsc", "priceDesc", "rating" ], "type": "string", "description": "The order the marketplace should return products in. 'Popularity' is the marketplace's own default order.", "default": "popularity" }, "minPrice": { "title": "Minimum price", "minimum": 0, "maximum": 100000000, "type": "integer", "description": "Optional. Only products at or above this price are returned. Leave blank for no lower bound." }, "maxPrice": { "title": "Maximum price", "minimum": 0, "maximum": 100000000, "type": "integer", "description": "Optional. Only products at or below this price are returned. Leave blank for no upper bound." }, "currency": { "title": "Currency", "enum": [ "RUB" ], "type": "string", "description": "The marketplace publishes every price in Russian roubles and this actor returns them exactly as published, never converted. There is nothing to change here — it is shown so you know what the numbers mean. Every row is also stamped with the market the marketplace served it for: it serves one default market to everybody and will not accept a different one, so there is no city to choose either.", "default": "RUB" }, "maxConcurrency": { "title": "How many searches to run at once", "minimum": 1, "maximum": 10, "type": "integer", "description": "Run several search terms side by side to finish sooner. Lower it if you would rather be gentle on the source.", "default": 3 } } }, "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 } } } } } } } } } }