{ "openapi": "3.0.1", "info": { "title": "Trendyol Scraper [$0.45/1k💰] | TR/AE/SA Prices | Reviews", "description": "Scrape Trendyol product data from Turkey, UAE and Saudi storefronts: price, discount, rating, favorites, seller and reviews for price monitoring (fiyat takibi) and e-commerce competitor intelligence.", "version": "0.1", "x-build-id": "72uMjdgXtIrcvwCdG" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/ahmed_jasarevic~trendyol-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-ahmed_jasarevic-trendyol-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/ahmed_jasarevic~trendyol-scraper/runs": { "post": { "operationId": "runs-sync-ahmed_jasarevic-trendyol-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/ahmed_jasarevic~trendyol-scraper/run-sync": { "post": { "operationId": "run-sync-ahmed_jasarevic-trendyol-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": { "searchQueries": { "title": "Search queries", "type": "array", "description": "Keywords to search on Trendyol, e.g. telefon, acarhome. Resolved through Trendyol's current SFINT search service (discovery-sfint-search-service, 36 products per page, paginated via offsetParameters).", "default": [ "shirt" ], "items": { "type": "string" } }, "categoryUrls": { "title": "Category / listing URLs", "type": "array", "description": "Public Trendyol category/browse URLs, e.g. https://www.trendyol.com/kadin-ayakkabi-x-g1-c114. Resolved through Trendyol's SFINT listing API (pathModel = category route, 36 products per page). Both www.trendyol.com (TR) and www.trendyol.ae (AE) URLs work.", "items": { "type": "string" } }, "maxProducts": { "title": "Max products", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of products to return. Free users are capped at 10.", "default": 50 }, "includeReviews": { "title": "Include review texts", "type": "boolean", "description": "Collect customer reviews for each product from Trendyol's paginated review-list API into a separate 'reviews' dataset (full review history, 50 per request). Reviews are keyed by product id, so no product page is fetched - search/category runs stay at ~1 request per 36 products plus one review request per 50 reviews. Rating/review counts are always parsed on listing pages regardless of this toggle. Disabled by default.", "default": false }, "maxReviewsPerProduct": { "title": "Max reviews per product", "minimum": 0, "maximum": 2000, "type": "integer", "description": "Maximum review texts to collect per product (0 = no reviews). Reviews are paginated 50 at a time until this many are collected or the product's review list is exhausted.", "default": 10 }, "sort": { "title": "Sort order", "enum": [ "relevance", "bestSeller", "priceAsc", "priceDesc", "newest", "mostRated", "mostFavorited" ], "type": "string", "description": "Sort order for search/category discovery.", "default": "relevance" }, "storefront": { "title": "Storefront", "enum": [ "TR", "AE", "SA" ], "type": "string", "description": "Which Trendyol storefront to scrape. TR = trendyol.com (TRY, Turkish). AE = international UAE storefront trendyol.ae (AED, English). SA = Saudi Arabia storefront trendyol.sa (SAR, Arabic). Uses the matching internal gateway host and storefront/culture context automatically. If a category URL clearly belongs to another storefront (e.g. a trendyol.ae link), the storefront is auto-corrected to match it so prices come back in the right currency.", "default": "TR" }, "maxRequestsPerCrawl": { "title": "Max requests per crawl", "minimum": 0, "maximum": 200000, "type": "integer", "description": "Hard cap on total HTTP requests for the whole run (0 = unlimited, bounded by products).", "default": 0 }, "proxy": { "title": "Proxy configuration", "type": "object", "description": "Recommended for production. Trendyol serves its pages behind an anti-bot TLS gate and Cloudflare that reliably rejects datacenter IPs. Apify residential proxies from the matching country (TR, AE or SA) consistently pass on the cached www surfaces used by this Actor. Running without a proxy may work occasionally but is not reliable." } } }, "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 } } } } } } } } } }