{ "openapi": "3.0.1", "info": { "title": "Trendyol Scraper - Products, Prices, Sellers, Reviews & Q&A", "description": "Scrape Trendyol products and prices from search, category, brand, store or product links in 35 storefronts: price, discount, rating, favourites, seller, shipping, badges. Add product pages, 30-day price history, reviews, answered questions and seller profiles. Price monitor mode. No login.", "version": "0.1", "x-build-id": "QhDExGsa97LWt9ngx" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapersdelight~trendyol-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapersdelight-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/scrapersdelight~trendyol-scraper/runs": { "post": { "operationId": "runs-sync-scrapersdelight-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/scrapersdelight~trendyol-scraper/run-sync": { "post": { "operationId": "run-sync-scrapersdelight-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 terms", "type": "array", "description": "Words you would type in Trendyol's search box, one per line, e.g. \"telefon\", \"airpods pro\", \"kadın elbise\". Each term is searched in every storefront you pick.", "items": { "type": "string" } }, "startUrls": { "title": "Trendyol links", "type": "array", "description": "Search (/sr?q=…), category (…-x-c103498), brand (…-x-b794), store (/magaza/…-m-968), campaign (/butik/liste/…) or product links (…-p-881465224). A product's /yorumlar or /saticiya-sor link also returns its reviews or answered questions.", "items": { "type": "string" } }, "productIds": { "title": "Product ids", "type": "array", "description": "Trendyol content ids (the number after -p- in a product link), e.g. 881465224. Each id is looked up in every storefront you pick, so one id gives a price comparison across countries.", "items": { "type": "string" } }, "sellerIds": { "title": "Seller ids", "type": "array", "description": "Seller (merchant) ids or store links, e.g. 968 or https://www.trendyol.com/magaza/trendyol-m-968. Lists that seller's products.", "items": { "type": "string" } }, "storefronts": { "title": "Storefronts", "type": "array", "description": "Which Trendyol countries to read. Each has its own catalogue, prices and currency (Turkey TRY, Germany EUR, UAE AED …). Default: Turkey.", "items": { "type": "string", "enum": [ "TR", "AZ", "AT", "BH", "BE", "BG", "HR", "CZ", "DK", "EE", "FI", "FR", "DE", "GR", "HU", "IT", "KW", "LV", "LT", "LU", "MD", "NL", "OM", "PL", "PT", "QA", "RO", "SA", "RS", "SK", "SI", "ES", "SE", "UA", "AE" ], "enumTitles": [ "Turkey (TRY)", "Azerbaijan (AZN)", "Austria (EUR)", "Bahrain (BHD)", "Belgium (EUR)", "Bulgaria (EUR)", "Croatia (EUR)", "Czechia (CZK)", "Denmark (EUR)", "Estonia (EUR)", "Finland (EUR)", "France (EUR)", "Germany (EUR)", "Greece (EUR)", "Hungary (HUF)", "Italy (EUR)", "Kuwait (KWD)", "Latvia (EUR)", "Lithuania (EUR)", "Luxembourg (EUR)", "Moldova (MDL)", "Netherlands (EUR)", "Oman (OMR)", "Poland (PLN)", "Portugal (EUR)", "Qatar (QAR)", "Romania (RON)", "Saudi Arabia (SAR)", "Serbia (RSD)", "Slovakia (EUR)", "Slovenia (EUR)", "Spain (EUR)", "Sweden (EUR)", "Ukraine (UAH)", "United Arab Emirates (AED)" ] }, "default": [ "TR" ] }, "sort": { "title": "Sort by", "enum": [ "relevance", "newest", "priceAsc", "priceDesc", "bestSeller", "mostFavourite", "mostRated" ], "type": "string", "description": "Order of search and category results (Trendyol's own sort).", "default": "relevance" }, "minPrice": { "title": "Minimum price", "minimum": 0, "type": "integer", "description": "Lowest price in the storefront's currency, e.g. 1000 (TRY on Turkey). Empty = no minimum." }, "maxPrice": { "title": "Maximum price", "minimum": 0, "type": "integer", "description": "Highest price in the storefront's currency, e.g. 5000. Empty = no maximum." }, "minRating": { "title": "Minimum rating", "enum": [ "", "1", "2", "3", "4", "4.5" ], "type": "string", "description": "Only products rated at least this many stars.", "default": "" }, "freeShippingOnly": { "title": "Free shipping only", "type": "boolean", "description": "Only products with free shipping (Kargo Bedava).", "default": false }, "fastDeliveryOnly": { "title": "Fast delivery only", "type": "boolean", "description": "Only products Trendyol marks for fast delivery (Hızlı Teslimat).", "default": false }, "sameDayShippingOnly": { "title": "Ships today only", "type": "boolean", "description": "Only products that ship the same day (Bugün Kargoda).", "default": false }, "couponOnly": { "title": "With a coupon only", "type": "boolean", "description": "Only products with a collectable coupon (Kuponlu Ürünler).", "default": false }, "dealsOnly": { "title": "Deals only", "type": "boolean", "description": "Only Trendyol's deal products (Fırsatlı Ürünler).", "default": false }, "flashSaleOnly": { "title": "Flash sale only", "type": "boolean", "description": "Only flash-sale products (Flaş Ürünler).", "default": false }, "newReleaseOnly": { "title": "New products only", "type": "boolean", "description": "Only products Trendyol marks as new (Yeni Ürünler).", "default": false }, "influencerOnly": { "title": "Influencer picks only", "type": "boolean", "description": "Only products picked by influencers (Fenomenlerin Seçtikleri).", "default": false }, "topSellersOnly": { "title": "Sellers rated 9+ only", "type": "boolean", "description": "Only products from sellers scoring 9 or more (9 Puan Üzeri Satıcılar).", "default": false }, "lowestPriceDays": { "title": "Lowest price in the last…", "enum": [ "", "10", "14", "30" ], "type": "string", "description": "Only products at their lowest price of the last 10, 14 or 30 days (Fiyat Geçmişi).", "default": "" }, "maxRating": { "title": "Maximum rating", "minimum": 0, "maximum": 5, "type": "number", "description": "Only products rated at most this many stars, e.g. 3 to find weak products. Empty = no maximum." }, "minRatingCount": { "title": "Minimum number of ratings", "minimum": 0, "type": "integer", "description": "Only products with at least this many ratings, e.g. 50." }, "minDiscountPercent": { "title": "Minimum discount %", "minimum": 0, "maximum": 100, "type": "integer", "description": "Only products whose shown price is at least this % below the struck-through price, e.g. 20." }, "discountedOnly": { "title": "Discounted only", "type": "boolean", "description": "Only products showing a struck-through (earlier or list) price.", "default": false }, "inStockOnly": { "title": "In stock only", "type": "boolean", "description": "Skip products shown as sold out.", "default": false }, "officialSellerOnly": { "title": "Official sellers only", "type": "boolean", "description": "Only products sold by a brand's authorised (official) seller.", "default": false }, "brandMatchOnly": { "title": "Brand must match the search term", "type": "boolean", "description": "For search terms: keep only products whose brand appears in the term, e.g. \"apple iphone\" keeps Apple and drops case makers.", "default": false }, "includeSponsored": { "title": "Include sponsored results", "type": "boolean", "description": "Trendyol mixes sponsored products into results (about 1 in 4). Turn off to keep organic results only. Every row has isSponsored and position.", "default": true }, "includeKeywords": { "title": "Name must contain", "type": "array", "description": "Keep products whose name contains any of these words (case and Turkish accents ignored), e.g. \"128 GB\".", "items": { "type": "string" } }, "excludeKeywords": { "title": "Name must not contain", "type": "array", "description": "Drop products whose name contains any of these words, e.g. \"kılıf\" (case).", "items": { "type": "string" } }, "includeDetails": { "title": "Product page details", "type": "boolean", "description": "Open each product's page: seller name, score and legal details, other sellers' offers, all attributes, sizes with stock and price, description, exact favourite count, AI review summary and topic sentiment. Charged as a product-details add-on.", "default": false }, "includePriceHistory": { "title": "Price history (last 30 days)", "type": "boolean", "description": "Trendyol's own daily price series for each product (when the site keeps one) with the 30-day low and high. No extra charge.", "default": false }, "includeReviews": { "title": "Reviews", "type": "boolean", "description": "Customer reviews of each product as separate rows (charged per review).", "default": false }, "maxReviewsPerProduct": { "title": "Reviews per product", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Most reviews saved per product. 0 = all Trendyol shows.", "default": 20 }, "reviewSort": { "title": "Review order", "enum": [ "recommended", "newest", "oldest", "ratingDesc", "ratingAsc" ], "type": "string", "description": "Order reviews are read in, before the per-product limit.", "default": "recommended" }, "reviewsSince": { "title": "Reviews since", "type": "string", "description": "Only reviews written on or after this date, e.g. 2026-09-01. With \"Newest first\" reading stops at the first older review." }, "reviewRatings": { "title": "Review star ratings", "type": "array", "description": "Only reviews with these star ratings, e.g. 1 and 2 for complaints. Empty = all.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5" ], "enumTitles": [ "1 star", "2 stars", "3 stars", "4 stars", "5 stars" ] } }, "reviewsWithPhotosOnly": { "title": "Reviews with photos only", "type": "boolean", "description": "Only reviews that include customer photos or videos.", "default": false }, "reviewKeyword": { "title": "Review contains", "type": "string", "description": "Only reviews whose text contains this word, e.g. \"kargo\"." }, "includeQuestions": { "title": "Answered questions", "type": "boolean", "description": "Buyer questions with the seller's answer, as separate rows (charged per question).", "default": false }, "maxQuestionsPerProduct": { "title": "Questions per product", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Most answered questions saved per product. 0 = all.", "default": 20 }, "includeSellerProfiles": { "title": "Seller profiles", "type": "boolean", "description": "One row per seller found: score, followers, product count, time on Trendyol, location, shipping and answer times, official name, tax and registration numbers, address. Charged per seller row.", "default": false }, "monitorMode": { "title": "Monitor mode", "enum": [ "off", "newAndChanged", "newOnly" ], "type": "string", "description": "Off: every matching product. New and changed: only products not delivered before, or whose price or stock changed (with previous price and change %). New only: products never delivered before. Reviews and questions: only new ones.", "default": "off" }, "minPriceChangePercent": { "title": "Minimum price change %", "minimum": 0, "maximum": 100, "type": "number", "description": "In \"New and changed\" mode, ignore price moves smaller than this, e.g. 5.", "default": 0 }, "monitorStoreName": { "title": "Monitor memory name", "type": "string", "description": "Key-value store that remembers delivered rows between runs (letters, digits, dashes). One name per watch list. Default: trendyol-monitor." }, "maxResults": { "title": "Maximum products", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Stop after this many products in total. Trendyol search shows 138 pages per query (about 3,700-5,000 products) unless \"Search past the 5,000-result limit\" is on. 0 = no limit.", "default": 100 }, "maxResultsPerSource": { "title": "Maximum products per source", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Cap for each search term, link or seller (and storefront). 0 = only the total cap applies.", "default": 0 }, "deepSearch": { "title": "Search past the 5,000-result limit", "type": "boolean", "description": "Trendyol's search stops after 138 pages (about 3,700-5,000 products). With this on, a bigger search is split into price bands that each fit, so a broad term or category returns far more of its catalogue.", "default": false }, "compact": { "title": "Compact output", "type": "boolean", "description": "Core fields only — smaller rows for AI / MCP pipelines.", "default": false }, "includeRawData": { "title": "Include raw data", "type": "boolean", "description": "Add Trendyol's original search card and product JSON to each product row (large).", "default": false }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Leave empty: the actor picks the cheapest working route itself. Your own proxy URLs are used first; an Apify residential country you pick is used only when Trendyol refuses the direct route." }, "maxConcurrency": { "title": "Parallel requests", "minimum": 1, "maximum": 20, "type": "integer", "description": "Product pages, reviews and questions read at once.", "default": 8 } } }, "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 } } } } } } } } } }