{ "openapi": "3.0.1", "info": { "title": "Trendyol Price & Stock Monitor", "description": "Watch Trendyol products and get told when something actually changes: a price moves, stock\nflips, the seller on the listing changes, or a new product appears in a category you follow.", "version": "0.0", "x-build-id": "JejChFYsFFCncEdtc" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/eaukkesh~trendyol-price-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-eaukkesh-trendyol-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/eaukkesh~trendyol-price-monitor/runs": { "post": { "operationId": "runs-sync-eaukkesh-trendyol-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/eaukkesh~trendyol-price-monitor/run-sync": { "post": { "operationId": "run-sync-eaukkesh-trendyol-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", "required": [ "monitorId" ], "properties": { "monitorId": { "title": "Monitor ID", "pattern": "^[a-z0-9][a-z0-9-]{2,49}$", "type": "string", "description": "Names this monitor's history. Keep the same ID across scheduled runs so each run can compare against the previous one. Lowercase letters, digits and hyphens." }, "productUrls": { "title": "Trendyol product URLs", "type": "array", "description": "Up to 100 HTTPS product URLs. Merchant and variant parameters are preserved. Give these, categoryUrls, or both.", "items": { "type": "string" } }, "categoryUrls": { "title": "Trendyol category or brand listing URLs", "type": "array", "description": "Up to 5 listing pages. Each run reads the first page and monitors the top products it shows, so the set follows the listing rather than staying fixed. Search URLs are not accepted.", "items": { "type": "string" } }, "productsPerCategory": { "title": "Products per listing", "minimum": 1, "maximum": 60, "type": "integer", "description": "How many top products to take from each listing page. Total across products and listings may not exceed 200. Twenty-four products take about a minute at the default concurrency.", "default": 12 }, "onlyChanges": { "title": "Only changes", "type": "boolean", "description": "Suppress baseline and unchanged observations; first run may return no rows.", "default": false }, "minimumPriceChangePercent": { "title": "Minimum price change (%)", "minimum": 0, "maximum": 100, "type": "integer", "description": "Compared to the immediately preceding successful observation.", "default": 0 }, "maxConcurrency": { "title": "Concurrent requests", "minimum": 1, "maximum": 5, "type": "integer", "description": "Maximum concurrent requests.", "default": 2 }, "browserFallback": { "title": "Browser fallback", "type": "boolean", "description": "Retry a failed product in Chromium. Off by default: the HTTP path handled every product in testing, and Chromium needs the run's memory raised to 4 GB. Turn it on only if you see repeated extraction failures, and raise memory with it.", "default": false }, "testMode": { "title": "Test mode", "type": "boolean", "description": "Use an isolated test store and do not update historical state.", "default": false }, "historyLength": { "title": "Retained observations per product", "minimum": 2, "maximum": 500, "type": "integer", "description": "How many past observations to keep per URL. Used for the observed minimum and maximum only; it does not change alerting.", "default": 50 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Required on the Apify platform. Trendyol sends visitors from other countries to its country selector instead of the product page, so a Turkish exit IP is needed. Residential proxies in Turkey are known to work.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "TR" } } } }, "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 } } } } } } } } } }