{ "openapi": "3.0.1", "info": { "title": "Noon.com Seller & Buy Box Monitor", "description": "Every seller of a noon.com product with their price and stock, who is winning the sale right now, and how much more the winner charges than the cheapest offer. One row per seller, ready to sort and pivot.", "version": "0.1", "x-build-id": "JdAZZWylBZ62bsXGt" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/drramerets~noon-sellers/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-drramerets-noon-sellers", "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/drramerets~noon-sellers/runs": { "post": { "operationId": "runs-sync-drramerets-noon-sellers", "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/drramerets~noon-sellers/run-sync": { "post": { "operationId": "run-sync-drramerets-noon-sellers", "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": { "productUrls": { "title": "Products", "type": "array", "description": "The products to check, one per line. Paste the link from your browser or the product code from the end of it — both work, and you can mix them. Links to a category, a brand or a search page are not products; they are skipped and named at the end of the run.", "items": { "type": "string" } }, "queries": { "title": "Search keywords", "type": "array", "description": "Instead of naming products, find them by keyword — exactly what you would type into noon's search box, e.g. air fryer. Every product found is then opened one by one, so a keyword run takes longer and uses more of your quota than the same number of products given directly.", "items": { "type": "string" } }, "categories": { "title": "Category links", "type": "array", "description": "Paste the address of a noon category page, e.g. https://www.noon.com/uae-en/electronics-and-mobiles/ — copied straight from your browser.", "items": { "type": "string" } }, "country": { "title": "Marketplace", "enum": [ "ae", "sa", "eg" ], "type": "string", "description": "Which noon marketplace to read. Prices, sellers and availability differ between them.", "default": "ae" }, "language": { "title": "Language", "enum": [ "en", "ar" ], "type": "string", "description": "Arabic returns product names and specifications in Arabic. Prices, seller names and product codes are the same in both, so Arabic and English runs can be compared side by side.", "default": "en" }, "outputFormat": { "title": "Result layout", "enum": [ "flat", "nested" ], "type": "string", "description": "One row per seller keeps the file the same width whatever happens, so you can sort by price and build a pivot of who wins the Buy Box. Choose one row per product only if you feed the result into your own code.", "default": "flat" }, "maxItems": { "title": "Maximum products", "minimum": 1, "maximum": 100000, "type": "integer", "description": "How many products to check at most. With one row per seller, expect several rows per product.", "default": 100 }, "maxPagesPerQuery": { "title": "Depth per keyword", "minimum": 1, "maximum": 10, "type": "integer", "description": "Leave as is. Lower it only if you want a quick look at the top results of each keyword.", "default": 10 }, "useApifyProxy": { "title": "Use Apify Residential proxy", "type": "boolean", "description": "Leave switched on. Without it noon will not serve data for the marketplace you selected and the run comes back empty.", "default": true }, "customProxyUrl": { "title": "Custom proxy URL", "type": "string", "description": "Optional. Use your own proxy instead of Apify's." } } }, "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 } } }, "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 } } } } } } } } } }