{ "openapi": "3.0.1", "info": { "title": "Noon.com Multi-Market Product Search by Discount", "description": "Search Noon.com's UAE, Saudi Arabia, and Egypt storefronts by keyword, category, or URL, and get price, discount, rating, brand, and promotional labels for each product in that market's own currency.", "version": "1.1", "x-build-id": "vuTAH34zheN5JkmKP" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dataspryva~noon-com-multi-market-product-search-by-discount/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dataspryva-noon-com-multi-market-product-search-by-discount", "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/dataspryva~noon-com-multi-market-product-search-by-discount/runs": { "post": { "operationId": "runs-sync-dataspryva-noon-com-multi-market-product-search-by-discount", "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/dataspryva~noon-com-multi-market-product-search-by-discount/run-sync": { "post": { "operationId": "run-sync-dataspryva-noon-com-multi-market-product-search-by-discount", "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", "required": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "search", "byCategory", "byProduct", "byUrl" ], "type": "string", "description": "Choose what to fetch. Search needs `searchQueries`; category needs `categoryPaths`; product needs `productInputs`; URL needs `startUrls`.", "default": "search" }, "searchQueries": { "title": "Search queries", "type": "array", "description": "Keywords to search for (mode=search). One query per line, e.g. `laptop`.", "default": [], "items": { "type": "string" } }, "categoryPaths": { "title": "Category paths or URLs", "type": "array", "description": "noon category paths or URLs (mode=byCategory), e.g. `electronics-and-mobiles/computers-and-accessories/computers-new/laptops`.", "default": [], "items": { "type": "string" } }, "productInputs": { "title": "Product SKUs or URLs", "type": "array", "description": "noon SKUs or product URLs (mode=byProduct), e.g. `N70367827V`.", "default": [], "items": { "type": "string" } }, "startUrls": { "title": "Start URLs", "type": "array", "description": "noon search, category, or product URLs (mode=byUrl). The market in each URL overrides the Market field.", "default": [], "items": { "type": "string" } }, "market": { "title": "Market", "enum": [ "uae", "saudi", "egypt", "bahrain", "qatar", "kuwait", "oman" ], "type": "string", "description": "noon storefront and currency. Product and URL inputs can override it from the URL.", "default": "uae" }, "language": { "title": "Language", "enum": [ "en", "ar" ], "type": "string", "description": "Product titles and descriptions language used by the storefront.", "default": "en" }, "sortBy": { "title": "Sort results by", "enum": [ "popularity", "price_asc", "price_desc", "best_rating", "new_arrivals" ], "type": "string", "description": "Ordering for search and category results.", "default": "popularity" }, "minPrice": { "title": "Minimum price", "minimum": 0, "maximum": 1000000000, "type": "number", "description": "Only emit products at or above this price, in the selected market's currency." }, "maxPrice": { "title": "Maximum price", "minimum": 0, "maximum": 1000000000, "type": "number", "description": "Only emit products at or below this price, in the selected market's currency." }, "minRating": { "title": "Minimum rating", "minimum": 0, "maximum": 5, "type": "number", "description": "Only emit rated products at or above this star rating (0-5). Unrated products are excluded when this is set." }, "minDiscountPercent": { "title": "Minimum discount (%)", "minimum": 0, "maximum": 100, "type": "number", "description": "Only emit products discounted by at least this percentage. Products without a list price have no discount and are excluded." }, "maxDiscountPercent": { "title": "Maximum discount (%)", "minimum": 0, "maximum": 100, "type": "number", "description": "Only emit products discounted by at most this percentage. Set 0 to require no discount." }, "brand": { "title": "Brand", "type": "string", "description": "Optional brand name or brand code, e.g. `HP` or `hp`. Matched against noon's brand filter." }, "seller": { "title": "Seller", "type": "string", "description": "Optional seller name or seller code, e.g. `noon` or `p_9404`." }, "dealOnly": { "title": "Deals only", "type": "boolean", "description": "Only emit products carrying a noon deal tag.", "default": false }, "includeDetails": { "title": "Fetch product details", "type": "boolean", "description": "Add description, specifications, stock, warranty, delivery, and all seller offers. Adds one request per product.", "default": false }, "includeReviews": { "title": "Fetch recent reviews", "type": "boolean", "description": "Add up to five latest review snippets per product. Adds one request per product.", "default": false }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Hard cap on emitted products across the whole run.", "default": 50 } } }, "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 } } } } } } } } } }