{ "openapi": "3.0.1", "info": { "title": "Ozon Buy Box Scraper", "description": "Every seller of an Ozon product — the buy box: price, crossed-out price, delivery, place by price and by delivery, rating at the seller, legal info; in any of 91 cities.", "version": "0.1", "x-build-id": "zsXETghJZhl66SV8J" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/theshark~ozon-buybox-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-theshark-ozon-buybox-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/theshark~ozon-buybox-scraper/runs": { "post": { "operationId": "runs-sync-theshark-ozon-buybox-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/theshark~ozon-buybox-scraper/run-sync": { "post": { "operationId": "run-sync-theshark-ozon-buybox-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": { "urls": { "title": "Ozon product links", "type": "array", "description": "Products whose sellers to collect. Search, category, seller and brand links work too — their first products (Products per query or link).", "default": [], "items": { "type": "string" } }, "queries": { "title": "Search queries", "type": "array", "description": "Words to search on Ozon: sellers of the products found.", "default": [], "items": { "type": "string" } }, "filters": { "title": "Search filters", "type": "object", "description": "Filters for search queries, as on the Ozon search page: sorting (score, new, price, price_desc, rating, discount), price_min, price_max, delivery (today, tomorrow, 3_days, 7_days), weight_min, weight_max, category (\"supermarket-25000\" — Ozon fresh), brands, sellers (ids), high_rating, discounted, new, bestsellers, brand_certified, official_store, premium_sellers, made_in_russia, installment, sale, and any other Ozon filter by its key in \"other\".", "default": {} }, "categories": { "title": "Category tree (market slice)", "type": "array", "description": "Category links: the actor walks the subcategory tree and takes the first products of every lowest category — a price slice of a whole market.", "default": [], "items": { "type": "string" } }, "category_depth": { "title": "Category tree depth", "minimum": 0, "type": "integer", "description": "How many subcategory levels to walk down.", "default": 1 }, "category_products": { "title": "Products per lowest category", "minimum": 1, "type": "integer", "description": "How many first products (as Ozon sorts them) to take from every lowest category.", "default": 10 }, "max_results": { "title": "Products per query or link", "minimum": 0, "type": "integer", "description": "0 — all. Also limited by your max total charge for the run.", "default": 5 }, "storefronts": { "title": "Storefronts", "type": "array", "description": "ozon.ru, ozon.by, ozon.kz — all in one run, side by side (sheet «Storefronts» compares prices).", "items": { "type": "string", "enum": [ "ru", "by", "kz" ], "enumTitles": [ "ozon.ru", "ozon.by", "ozon.kz" ] }, "default": [ "ru" ] }, "cities": { "title": "Delivery cities", "type": "array", "description": "Prices and delivery depend on the city. One list for all storefronts: 76 Russian cities («Москва», «Санкт-Петербург», «Казань»…), 6 in Belarus («Минск», «Гомель»…), 9 in Kazakhstan («Астана», «Алматы»…) — names in Russian, as on Ozon. A storefront without its own city here uses its capital. One row per product per city.", "default": [ "Москва" ], "items": { "type": "string" } }, "currency": { "title": "Currency", "enum": [ "RUB", "USD", "BYN", "KZT", "ILS", "AMD", "UZS", "KGS", "AZN", "GEL", "MNT", "AUD", "DKK", "JPY", "CAD", "CNY", "MDL", "NOK", "PLN", "SGD", "TRY", "UAH", "GBP", "CZK", "SEK", "CHF" ], "type": "string", "description": "One for all storefronts. Use one currency (e.g. RUB) to compare storefronts; BYN / KZT — local prices of ozon.by / ozon.kz.", "default": "RUB" }, "track_prices": { "title": "Seller history and changes", "type": "boolean", "description": "Remember sellers between runs: who joined, who left, new cheapest seller, card seller changed — in OUTPUT and Excel.", "default": true }, "save_results": { "title": "Excel workbook", "type": "boolean", "description": "results.xlsx in the run's key-value store: products, changes, dynamics, stock and sales estimate, positions, market, storefronts, cities, categories — with charts.", "default": true }, "output_language": { "title": "Output language", "enum": [ "en", "ru" ], "type": "string", "description": "Language of the Excel workbook, CSV, change details, run status and log. Ozon's own data (product names, characteristics, reviews) comes in the site language (the Language field).", "default": "en" }, "sessions": { "title": "Sessions per storefront", "minimum": 1, "maximum": 32, "type": "integer", "description": "Anonymous Ozon buyers working at the same time on each storefront, each with its own proxy session: 2 — about twice as fast as 1. Sessions are kept in the history store, so a browser opens for a new one only once.", "default": 8 }, "browsers": { "title": "Browsers at once", "minimum": 1, "maximum": 8, "type": "integer", "description": "A browser (~320 MB) opens only to get a new Ozon session (they are kept in the history store, so mostly on the first run). Several at once — the first run starts faster. Capped by run memory: 1 GB — 1, 2 GB — 3, 4 GB — 7.", "default": 3 }, "history_store": { "title": "History store", "type": "string", "description": "Name of the key-value store in your account that keeps price history between runs. Different names — separate histories. Runs with the same store don't overlap: a second one waits up to 10 minutes for the first to finish.", "default": "ozon-buybox-history" }, "proxy_ru": { "title": "Your proxy for ozon.ru", "type": "string", "description": "user:pass@host:port, residential, Russia — one per line: every Ozon session gets its own (one line — all sessions share it). Empty — the actor's built-in proxies of this country (included in the price)." }, "proxy_by": { "title": "Your proxy for ozon.by", "type": "string", "description": "Belarus, one per line. ozon.by lets in only Belarusian IPs. Empty — the actor's built-in proxies of this country (included in the price)." }, "proxy_kz": { "title": "Your proxy for ozon.kz", "type": "string", "description": "Kazakhstan, one per line. Empty — the actor's built-in proxies of this country (included in the price)." } } }, "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 } } } } } } } } } }