{ "openapi": "3.0.1", "info": { "title": "Trendyol Scraper: Products, Prices, Reviews & Sellers", "description": "Scrape Trendyol (Türkiye) products, prices, reviews, Q&A and sellers. Search by keyword or link with 13 filters, see every seller's offer, get only new reviews and Trendyol's review insights. Export to Excel, CSV or JSON.", "version": "0.0", "x-build-id": "gDIGNKEbZ43nBh47s" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sourabhbgp~trendyol-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sourabhbgp-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/sourabhbgp~trendyol-scraper/runs": { "post": { "operationId": "runs-sync-sourabhbgp-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/sourabhbgp~trendyol-scraper/run-sync": { "post": { "operationId": "run-sync-sourabhbgp-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": { "mode": { "title": "What to scrape", "enum": [ "search", "product", "reviews", "seller" ], "type": "string", "description": "Pick what to scrape, then fill the section with the same name below. Other sections are ignored.", "default": "search" }, "searchQueries": { "title": "Search keywords", "type": "array", "description": "One search per line, in Turkish or English, for example kulaklık or iphone 15 kılıf.", "items": { "type": "string" } }, "searchUrls": { "title": "Trendyol links", "type": "array", "description": "Search, category or brand pages from trendyol.com, for example https://www.trendyol.com/sr?q=playstation or https://www.trendyol.com/apple-x-b101470. Filters already in the link are kept.", "items": { "type": "string", "pattern": "^\\s*https?://((www|m)\\.)?trendyol\\.com/\\S+\\s*$" } }, "maxResults": { "title": "Max products per keyword or link", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Stop after this many products for each keyword or link. Trendyol shows at most about 4,968 products for one search.", "default": 100 }, "sort": { "title": "Sort by", "enum": [ "SCORE", "PRICE_BY_ASC", "PRICE_BY_DESC", "BEST_SELLER", "MOST_FAVOURITE", "MOST_RATED", "MOST_RECENT" ], "type": "string", "description": "Order of the results. Recommended is Trendyol's own order.", "default": "SCORE" }, "includeSponsored": { "title": "Include sponsored products", "type": "boolean", "description": "Recommended order mixes sponsored products into the results. Off: only regular results. On: sponsored products are kept and marked with isSponsored.", "default": false }, "includeDetails": { "title": "Add full product details", "type": "boolean", "description": "Also open each product and add stock, barcode, all sellers offering it and their prices, sizes, attributes, review insights and seller details. One extra request per product.", "default": false }, "includeQuestions": { "title": "Add questions and answers", "type": "boolean", "description": "Add answered customer questions to each product. One extra request per product.", "default": false }, "maxQuestions": { "title": "Max questions per product", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Answered questions to add per product when questions are on.", "default": 20 }, "minPrice": { "title": "Min price (TL)", "minimum": 0, "type": "integer", "description": "Only products at or above this price in Turkish lira." }, "maxPrice": { "title": "Max price (TL)", "minimum": 1, "type": "integer", "description": "Only products at or below this price in Turkish lira." }, "minRating": { "title": "Min star rating", "enum": [ "3", "3.5", "4", "4.5" ], "type": "string", "description": "Only products rated at least this many stars." }, "minDiscountPercent": { "title": "Min discount (%)", "minimum": 1, "maximum": 99, "type": "integer", "description": "Only products discounted by at least this percentage." }, "lowestPriceDays": { "title": "Lowest price in the last", "enum": [ "10", "14", "30" ], "type": "string", "description": "Only products Trendyol marks as being at their lowest price for this many days." }, "freeShippingOnly": { "title": "Free shipping only", "type": "boolean", "description": "Only products with free shipping.", "default": false }, "fastDeliveryOnly": { "title": "Fast delivery only", "type": "boolean", "description": "Only products with Trendyol's fast delivery.", "default": false }, "couponOnly": { "title": "Has a coupon", "type": "boolean", "description": "Only products with a collectable coupon.", "default": false }, "campaignOnly": { "title": "In a campaign", "type": "boolean", "description": "Only products in a Trendyol campaign.", "default": false }, "flashSaleOnly": { "title": "Flash sale only", "type": "boolean", "description": "Only products in a flash sale.", "default": false }, "newProductsOnly": { "title": "New products only", "type": "boolean", "description": "Only products Trendyol marks as new.", "default": false }, "influencerPicksOnly": { "title": "Influencer picks only", "type": "boolean", "description": "Only products picked by influencers.", "default": false }, "topSellersOnly": { "title": "Top-rated sellers only", "type": "boolean", "description": "Only products sold by sellers with a score of 9 or higher.", "default": false }, "productUrls": { "title": "Product links or IDs", "type": "array", "description": "One Trendyol product link or product ID per line, for example https://www.trendyol.com/apple/iphone-15-128-gb-siyah-p-762254878 or 762254878. A link opened from one seller's offer (with merchantId in it) returns that seller's price.", "items": { "type": "string", "pattern": "^\\s*(https?://((www|m)\\.)?trendyol\\.com/\\S*-p-\\d{4,12}\\S*|\\d{4,12})\\s*$" } }, "productIncludeQuestions": { "title": "Add questions and answers", "type": "boolean", "description": "Add answered customer questions to each product. One extra request per product.", "default": false }, "productMaxQuestions": { "title": "Max questions per product", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Answered questions to add per product when questions are on.", "default": 20 }, "reviewProductUrls": { "title": "Product links or IDs", "type": "array", "description": "One Trendyol product link or product ID per line, for example https://www.trendyol.com/apple/iphone-15-128-gb-siyah-p-762254878 or 762254878.", "items": { "type": "string", "pattern": "^\\s*(https?://((www|m)\\.)?trendyol\\.com/\\S*-p-\\d{4,12}\\S*|\\d{4,12})\\s*$" } }, "maxReviews": { "title": "Max reviews per product", "minimum": 1, "maximum": 5050, "type": "integer", "description": "Stop after this many reviews for each product. Trendyol serves at most about 5,050 reviews per product in one order.", "default": 100 }, "reviewsSort": { "title": "Review order", "enum": [ "NEWEST", "OLDEST", "RELEVANT", "LOWEST_RATED", "HIGHEST_RATED" ], "type": "string", "description": "Newest first, oldest first, Trendyol's most relevant order, or by star rating.", "default": "NEWEST" }, "reviewsSince": { "title": "Only reviews since", "pattern": "^\\d{4}-\\d{2}-\\d{2}(T.*)?$", "type": "string", "description": "Only reviews written on or after this date. Newest first and Oldest first return them in that order; the other orders return them newest first." }, "onlyNewReviews": { "title": "Only new reviews since the last run", "type": "boolean", "description": "Return only reviews written since your previous run of this scraper for the same product. The first run returns up to Max reviews per product, newest first, and remembers the newest one; later runs return every review written since (up to about 5,050). Remembered separately for each combination of star, photo and keyword filters.", "default": false }, "reviewRatings": { "title": "Star ratings", "type": "array", "description": "Only reviews with these star ratings. Leave empty for all.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5" ], "enumTitles": [ "1 star", "2 stars", "3 stars", "4 stars", "5 stars" ] } }, "withPhotosOnly": { "title": "Only reviews with photos", "type": "boolean", "description": "Only reviews that include customer photos.", "default": false }, "reviewKeyword": { "title": "Reviews containing", "type": "string", "description": "Only reviews that mention this word, using Trendyol's own review search, for example kargo or kalite." }, "sellerUrls": { "title": "Store links or seller IDs", "type": "array", "description": "One Trendyol store link or seller ID per line, for example https://www.trendyol.com/magaza/mediamarkt-m-275331 or 275331.", "items": { "type": "string", "pattern": "^\\s*(https?://((www|m)\\.)?trendyol\\.com/\\S+|\\d{1,10})\\s*$" } }, "sellerMaxProducts": { "title": "Max products per seller", "minimum": 0, "maximum": 5000, "type": "integer", "description": "Stop after this many of the seller's products. Use 0 to get only the seller profile. Trendyol lists at most about 4,968 products per store.", "default": 100 }, "sellerSort": { "title": "Sort by", "enum": [ "SCORE", "PRICE_BY_ASC", "PRICE_BY_DESC", "BEST_SELLER", "MOST_FAVOURITE", "MOST_RATED", "MOST_RECENT" ], "type": "string", "description": "Order of the seller's products. Recommended lists the store newest first, because Trendyol's recommended order reshuffles between pages on store lists and would skip products.", "default": "SCORE" }, "sellerIncludeDetails": { "title": "Add full product details", "type": "boolean", "description": "Also open each product and add stock, barcode, all sellers offering it, sizes, attributes and review insights. One extra request per product.", "default": false }, "includeSellerReviews": { "title": "Add store reviews", "type": "boolean", "description": "Add the store's own reviews: buyers rating the seller and the delivery.", "default": false }, "maxSellerReviews": { "title": "Max store reviews per seller", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Store reviews to add per seller when store reviews are on.", "default": 100 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Usually not needed. The scraper starts without a proxy and switches to Apify Proxy by itself if Trendyol blocks it.", "default": { "useApifyProxy": 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 } } } } } } } } } }