{ "openapi": "3.0.1", "info": { "title": "Ozon Scraper: Ozon Product Prices and Reviews | Парсер Озон", "description": "Ozon scraper for Russia's largest marketplace. Search ozon.ru by keyword for title, price in roubles, pre-sale price, discount, rating, review count and link, or give product links to get customer reviews (отзывы) with stars, text and photos. No login. $2.50 per 1,000 products.", "version": "0.1", "x-build-id": "7mAZueWEIsQc1aZQ6" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/themineworks~ozon-product-search/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-themineworks-ozon-product-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/themineworks~ozon-product-search/runs": { "post": { "operationId": "runs-sync-themineworks-ozon-product-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/themineworks~ozon-product-search/run-sync": { "post": { "operationId": "run-sync-themineworks-ozon-product-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": { "queries": { "title": "Search terms (поисковые запросы)", "type": "array", "description": "Product keywords. Russian returns far more results, e.g. \"ноутбук\" rather than \"laptop\".", "items": { "type": "string" } }, "startUrls": { "title": "Ozon links (ссылки Озон)", "type": "array", "description": "Category, brand or seller links (https://www.ozon.ru/category/smartfony-15502/) and search links. Filters and sorting you set on Ozon inside the link are kept. Product page links are switched off for now; use the review and question inputs for single products. Only ozon.ru is read.", "items": { "type": "string" } }, "maxItems": { "title": "Max products", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Most product rows to return across all keywords and links. Default 50, maximum 2000. A listing request returns 8 products.", "default": 50 }, "sort": { "title": "Sort order", "enum": [ "score", "price", "price_desc", "new", "rating", "discount" ], "type": "string", "description": "How Ozon should order the results (keywords and category, brand or seller links).", "default": "score" }, "minPrice": { "title": "Min price, RUB", "minimum": 1, "type": "integer", "description": "Keep products at or above this price in roubles. Leave empty for no limit." }, "maxPrice": { "title": "Max price, RUB", "minimum": 1, "type": "integer", "description": "Keep products at or below this price in roubles. Leave empty for no limit." }, "reviewProductUrls": { "title": "Reviews: product links (отзывы)", "type": "array", "description": "Ozon product links (https://www.ozon.ru/product/...) or product IDs whose customer reviews you want: one row per review with stars, text, pros and cons, photos and videos, date, helpful votes and the product's star breakdown. Up to 50 products per run.", "items": { "type": "string" } }, "maxReviewsPerProduct": { "title": "Max reviews per product", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Upper limit of reviews per product. Ozon shows 30 per page.", "default": 100 }, "reviewSort": { "title": "Review order", "enum": [ "usefulness_desc", "score_desc", "score_asc" ], "type": "string", "description": "Ozon's own review orders: newest and most useful first, highest rated first, or lowest rated first.", "default": "usefulness_desc" }, "questionProductUrls": { "title": "Questions and answers: product links (вопросы)", "type": "array", "description": "Ozon product links or product IDs whose buyer questions you want: one row per question with every answer under it (Ozon staff, sellers and buyers). Up to 50 products per run.", "items": { "type": "string" } }, "maxQuestionsPerProduct": { "title": "Max questions per product", "minimum": 1, "maximum": 500, "type": "integer", "description": "Upper limit of questions per product.", "default": 50 }, "monitorMode": { "title": "Monitor mode (only new rows)", "type": "boolean", "description": "Run on a schedule and get ONLY products, reviews and questions not delivered in a previous run. Keep the input the same across runs.", "default": false }, "maxConcurrency": { "title": "Parallel requests", "minimum": 1, "maximum": 8, "type": "integer", "description": "How many Ozon pages are read at the same time (1 to 8). Ozon answers slowly through the unblocker and refuses about half of the requests, so each page is tried again with a fresh route until it loads (up to 8 tries). More pages at once finish sooner but cost more refused requests. Default 3.", "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 }, "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 } } } } } } } } } }