{ "openapi": "3.0.1", "info": { "title": "Yandex Market Scraper - Prices, Discounts & Price Monitor", "description": "For marketplace sellers and price monitoring: Yandex Market (Яндекс Маркет) search results with price in RUB, old price and discount, rating, purchases, seller, stock and delivery date. Monitor mode returns only price changes and new products. No login. Export as JSON, CSV or Excel. Unofficial.", "version": "0.1", "x-build-id": "fTwLHIbgQPlthJu43" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/neverempty~yandex-market-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-neverempty-yandex-market-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/neverempty~yandex-market-scraper/runs": { "post": { "operationId": "runs-sync-neverempty-yandex-market-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/neverempty~yandex-market-scraper/run-sync": { "post": { "operationId": "run-sync-neverempty-yandex-market-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": { "searchQueries": { "title": "Search terms", "type": "array", "description": "What you would type into the Yandex Market search box, in Russian or English, for example iphone 15, пылесос, кроссовки nike, lego technic. Leave Search terms and Search URLs both empty to run the example search iphone 15.", "items": { "type": "string" } }, "searchUrls": { "title": "Search URLs", "type": "array", "description": "Optional. Yandex Market search or category pages copied from your browser, for example https://market.yandex.ru/search?text=пылесос&how=aprice or https://market.yandex.ru/catalog--pylesosy/16302535/list. The search text, category, sort order and price range in the URL are kept; tracking parameters are dropped. Filter parameters (glfilter) are not allowed by Yandex Market's robots.txt: such a URL comes back as a free row.", "items": { "type": "string" } }, "sort": { "title": "Sort order", "enum": [ "relevance", "price-asc", "price-desc", "rating", "reviews", "discount" ], "type": "string", "description": "Sort order for the search terms (a pasted URL keeps its own). With Relevance, Yandex Market fills the first page with advertising placements (marked sponsored). Price: low to high is the steadiest list for monitoring. Empty = relevance." }, "minPrice": { "title": "Min price (RUB)", "minimum": 0, "type": "number", "description": "Optional. Yandex Market's own price filter (pricefrom), in rubles." }, "maxPrice": { "title": "Max price (RUB)", "minimum": 0, "type": "number", "description": "Optional. Yandex Market's own price filter (priceto), in rubles." }, "maxPages": { "title": "Pages per search", "minimum": 1, "maximum": 5, "type": "integer", "description": "How many results pages to read for each search (1 to 5). Each page carries only its first part in the page itself: about 8 products on page 1 and about 16 on each later page (the rest is loaded from Yandex Market's /api/, which robots.txt does not allow). Empty = 3 (about 30 to 40 products)." }, "maxResultsPerSearch": { "title": "Max products per search", "minimum": 1, "maximum": 100, "type": "integer", "description": "Most products returned for one search. Empty = 50. In monitor mode it limits the products returned per search in one run; the rest come in the next run." }, "includeSponsored": { "title": "Include advertising placements", "type": "boolean", "description": "On (default): return advertising placements too, marked sponsored true. Off: leave them out (with Relevance sort the first page is often all advertising).", "default": true }, "onlyNew": { "title": "Monitor mode: only price changes and products new in the results", "type": "boolean", "description": "On: every run reads the same pages of each search and returns only products whose price changed since the previous check (changeType price-change, with previousPrice and priceChange) and products that appear in these results for the first time (changeType new-in-results). The first run returns up to Max products per search (changeType first-check) and remembers them as the starting point. Each run that reads the list is charged the run start fee even when nothing changed; runs where nothing changed return a free row saying so." }, "includePriceChanges": { "title": "Monitor mode: return price changes", "type": "boolean", "description": "On (default): in monitor mode, also return products whose price is different from the previous check (up or down). Off: only products new in the results.", "default": true }, "watchName": { "title": "Watch name", "type": "string", "description": "Optional. Keeps separate memories for monitor mode, for example one per client (letters, digits, dot, dash, underscore; up to 40). Runs with the same watch name and the same search share what has already been returned." }, "resetMonitoringState": { "title": "Start the watch again", "type": "boolean", "description": "On: forget what this watch has seen for these searches before running, so this run is a first check again." } } }, "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 } } } } } } } } } }