{ "openapi": "3.0.1", "info": { "title": "noon Seller & Price Monitor - UAE & Saudi Buy Box Tracker", "description": "Every seller on a noon.com product in the UAE or Saudi Arabia: Buy Box winner, price, was-price, stock, delivery date, noon fulfilment, seller rating, per size or color. Monitor mode returns only changes: Buy Box won or lost, price up or down, new seller, seller gone.", "version": "0.1", "x-build-id": "a9AorjpaxR5Lw0S8H" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/neverempty~noon-seller-price-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-neverempty-noon-seller-price-monitor", "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~noon-seller-price-monitor/runs": { "post": { "operationId": "runs-sync-neverempty-noon-seller-price-monitor", "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~noon-seller-price-monitor/run-sync": { "post": { "operationId": "run-sync-neverempty-noon-seller-price-monitor", "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": { "products": { "title": "noon SKUs or product URLs", "type": "array", "description": "noon products to check: a SKU (N70211553V), a SKU with a size or color number to check only that one (ZA133E7D109B839C34173Z-3), or a product URL (https://www.noon.com/uae-en/.../N70211553V/p/; a URL with ?o=-N checks only that size or color). Up to 100 per run. The same product written several ways is read and charged once. Leave empty to run the example product N70211553V (a free row says so).", "items": { "type": "string" } }, "country": { "title": "noon country", "enum": [ "uae", "saudi" ], "type": "string", "description": "Which noon store to read. Sellers, prices, stock and the Buy Box differ by country. Product URLs must be for the same country.", "default": "uae" }, "maxOffersPerProduct": { "title": "Max offer rows per product", "minimum": 1, "maximum": 200, "type": "integer", "description": "How many offer rows to return per product (one row per seller per size or color). noon returns every seller in one answer, so this only caps the rows. Rows beyond this number are not charged.", "default": 50 }, "onlyChanges": { "title": "Only changes since the last run (monitor mode)", "type": "boolean", "description": "On: after the first run, return only offers that changed for the same watch: a new seller, the Buy Box moving to or from a seller, a price going up or down, or a seller that left. Unchanged offers are not returned and not charged; a free no-change row says so. Off: every offer is returned, each with its changeType.", "default": false }, "minPriceChangePercent": { "title": "Ignore price moves smaller than (%)", "minimum": 0, "maximum": 50, "type": "number", "description": "In monitor mode, a price move smaller than this percentage is not reported as price-up or price-down. 0 reports every change.", "default": 0 }, "watchName": { "title": "Watch name", "type": "string", "description": "Optional. Names the memory of monitor mode: with a name, the memory belongs to the name and the country, so adding or removing products keeps it. Without a name, each exact list of products has its own memory. Letters, digits, dot, dash and underscore, up to 40." }, "resetMonitoringState": { "title": "Forget the last run (start this watch again)", "type": "boolean", "description": "On: forget what this watch remembered, so this run is a first check again.", "default": false } } }, "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 } } } } } } } } } }