{ "openapi": "3.0.1", "info": { "title": "Yandex Market Reviews Scraper", "description": "Collect customer reviews for any Yandex Market product as a clean table: star rating, review text, what buyers liked and disliked as separate columns, author, date, helpful votes and photo counts. Order by newest, lowest rated or most helpful, and filter by stars.", "version": "0.0", "x-build-id": "bUBqdaowKkJPdErcH" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/apt_marble~yandex-market-reviews-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-apt_marble-yandex-market-reviews-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-reviews-scraper/runs": { "post": { "operationId": "runs-sync-apt_marble-yandex-market-reviews-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-reviews-scraper/run-sync": { "post": { "operationId": "run-sync-apt_marble-yandex-market-reviews-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": { "productUrls": { "title": "Product links", "type": "array", "description": "Product pages on Yandex Market whose customer reviews you want. Open a product on the marketplace and copy the address of that page. Use this, the product numbers field below, or both.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "productIds": { "title": "Product numbers", "type": "array", "description": "The numbers that identify products on Yandex Market, if you already have them — for example from an earlier run. One per line.", "items": { "type": "string" } }, "maxReviewsPerProduct": { "title": "Reviews per product", "minimum": 1, "maximum": 510, "type": "integer", "description": "How many reviews to collect for each product. The source serves at most 510 reviews for any one product, however many it says the product has, so 510 is the highest this can be set to. A product simply returns everything it has if that is fewer.", "default": 50 }, "sortBy": { "title": "Order reviews by", "enum": [ "useful", "newest", "highestRating", "lowestRating" ], "type": "string", "description": "Which reviews you want first. This decides what you get when you collect fewer reviews than a product has: newest first for monitoring what buyers are saying now, lowest rated first for complaint analysis, most helpful first for a balanced read.", "default": "useful" }, "minRating": { "title": "Lowest star rating to keep", "minimum": 1, "maximum": 5, "type": "integer", "description": "Only keep reviews rated at least this many stars. Leave at 1 to keep every rating.", "default": 1 }, "maxRating": { "title": "Highest star rating to keep", "minimum": 1, "maximum": 5, "type": "integer", "description": "Only keep reviews rated at most this many stars. Set both fields to 1 to collect one-star reviews only.", "default": 5 }, "market": { "title": "Market", "enum": [ "ru" ], "type": "string", "description": "The market whose reviews you get. This marketplace publishes one pool of product reviews to the public, so this is fixed — it is shown here so what you receive is never in doubt. Every row is also stamped with the market the answer actually came back for.", "default": "ru" }, "productsAtOnce": { "title": "Products handled at the same time", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many products the run works through side by side. Higher finishes a long list sooner; lower is gentler and steadier. Leave it at 3 unless you have a large list.", "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 } } } } } } } } } }