{ "openapi": "3.0.1", "info": { "title": "Trendyol Scraper: Products, Prices, Reviews", "description": "Scrape Trendyol searches, categories, brands, seller shops or product links in Turkey and 34 more storefronts, no login. Get price, crossed out price, discount, rating, favourites, seller and badges, plus details, reviews, answered questions and sellers. JSON, CSV or Excel; pay per row.", "version": "0.1", "x-build-id": "T7Mz9hWmJTgWvKCqC" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/automation_craft~trendyol-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-automation_craft-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/automation_craft~trendyol-scraper/runs": { "post": { "operationId": "runs-sync-automation_craft-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/automation_craft~trendyol-scraper/run-sync": { "post": { "operationId": "run-sync-automation_craft-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 words", "type": "array", "description": "Words to search on Trendyol, one search per entry (laptop, spor ayakkabı, kahve makinesi). Each search delivers products in the storefront set below, up to Max products. A word Trendyol does not know and answers with another search delivers nothing (see Take rewritten searches). With no search, link, product id or seller id at all, the run reads a sample: the first 10 products of \"laptop\" (billed as products).", "items": { "type": "string" } }, "startUrls": { "title": "Trendyol links", "type": "array", "description": "Links copied from Trendyol: a search page (https://www.trendyol.com/sr?q=laptop&wb=102323), a category, brand or attribute page (https://www.trendyol.com/laptop-x-c103108), a seller shop (https://www.trendyol.com/magaza/ebebek-m-392) or a product page (https://www.trendyol.com/msi/cyborg-15-p-1136094055, with merchantId for one seller's offer). The filters and order Trendyol put in the link are read too. A link of another storefront needs that storefront set below. Through the API, give each link as a text (an object {\"url\": \"...\"} is read too).", "items": { "type": "string" } }, "productIds": { "title": "Product ids", "type": "array", "description": "Trendyol product ids: the number after -p- in a product link (1136094055). Each is read through the product's details; an id Trendyol does not have gets a free status row.", "items": { "type": "string" } }, "sellerIds": { "title": "Seller ids", "type": "array", "description": "Seller (shop) ids: the number after -m- in a shop link (392 for https://www.trendyol.com/magaza/ebebek-m-392). Each delivers the products of that seller's shop, and with Seller rows on the seller itself.", "items": { "type": "string" } }, "storefronts": { "title": "Storefronts", "type": "array", "description": "The Trendyol storefronts to read, each in its own currency and language (default Turkey). Search words, product ids and seller ids are read in every storefront listed; a link is read in the storefront it belongs to. Max products counts them all together; prices you set are in each storefront's own currency.", "items": { "type": "string", "enum": [ "TR", "AZ", "DE", "AE", "SA", "QA", "KW", "OM", "BH", "AT", "BE", "BG", "HR", "CZ", "DK", "EE", "FI", "FR", "GR", "HU", "IT", "LV", "LT", "LU", "NL", "PL", "PT", "RO", "SK", "SI", "ES", "SE", "RS", "UA", "MD" ], "enumTitles": [ "Turkey (TRY)", "Azerbaijan (AZN)", "Germany (EUR)", "United Arab Emirates (AED)", "Saudi Arabia (SAR)", "Qatar (QAR)", "Kuwait (KWD)", "Oman (OMR)", "Bahrain (BHD)", "Austria (EUR)", "Belgium (EUR)", "Bulgaria (EUR)", "Croatia (EUR)", "Czechia (CZK)", "Denmark (EUR)", "Estonia (EUR)", "Finland (EUR)", "France (EUR)", "Greece (EUR)", "Hungary (HUF)", "Italy (EUR)", "Latvia (EUR)", "Lithuania (EUR)", "Luxembourg (EUR)", "Netherlands (EUR)", "Poland (PLN)", "Portugal (EUR)", "Romania (RON)", "Slovakia (EUR)", "Slovenia (EUR)", "Spain (EUR)", "Sweden (EUR)", "Serbia (RSD)", "Ukraine (UAH)", "Moldova (MDL)" ] }, "default": [ "TR" ] }, "maxItems": { "title": "Max products", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "The most products this run delivers over every input together (left out: 100). Reviews, questions and sellers are capped by their own settings." }, "maxItemsPerSearch": { "title": "Max products per search", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "The most products one search, listing or shop delivers (left out: no cap per search, only Max products). Trendyol serves at most 4,968 products of one search, filter set and order; turn on Split large searches to go past that." }, "maxPagesPerSearch": { "title": "Max pages per search", "minimum": 1, "maximum": 138, "type": "integer", "description": "The most result pages (36 products each) read per search, listing or shop. Useful for a monitor that only watches the first pages." }, "splitLargeSearches": { "title": "Split large searches", "type": "boolean", "description": "When a search, listing or shop lists more than 4,968 products (Trendyol's cap per search, filter set and order), read it in price bands, each under the cap, from the cheapest up; every product is delivered once." }, "sort": { "title": "Order", "enum": [ "relevance", "price_low_to_high", "price_high_to_low", "newest", "best_selling", "most_favourited", "most_reviewed" ], "type": "string", "description": "The order of the results. Only Relevance shows sponsored products; each distinct product is delivered once, with its sponsored flag and position." }, "minPrice": { "title": "Lowest price", "minimum": 0, "maximum": 100000000, "type": "integer", "description": "Only products at or above this price, in the storefront's currency (whole number), checked on the price the buyer pays." }, "maxPrice": { "title": "Highest price", "minimum": 0, "maximum": 100000000, "type": "integer", "description": "Only products at or below this price, in the storefront's currency (whole number), checked on the price the buyer pays." }, "minRating": { "title": "Lowest rating", "enum": [ "1", "2", "3", "4", "4.5" ], "type": "string", "description": "Only products rated at least this many stars (unrated products are left out)." }, "maxRating": { "title": "Highest rating", "minimum": 1, "maximum": 5, "type": "number", "description": "Only products whose shown average rating is at or below this (1 to 5), checked on every row; products without a rating are left out. Trendyol has no such filter, so pages of higher rated products are read and skipped free." }, "brands": { "title": "Brands", "type": "array", "description": "Brand names or brand ids as Trendyol lists them for the search (Lenovo, Asus, 102323). A name Trendyol does not list there is left out with a note.", "items": { "type": "string" } }, "categories": { "title": "Categories", "type": "array", "description": "Category names or ids as Trendyol lists them for the search (Laptop, 103108).", "items": { "type": "string" } }, "genders": { "title": "Gender", "type": "array", "description": "Gender names or ids as Trendyol lists them (Kadın or 1 for women, Erkek or 2 for men, Çocuk or 3 for children, in Turkey).", "items": { "type": "string" } }, "sizes": { "title": "Sizes", "type": "array", "description": "Size names as Trendyol lists them for the search (S, M, 38, 42).", "items": { "type": "string" } }, "attributeFilters": { "title": "Other filters", "type": "array", "description": "Any other filter Trendyol lists for the search, written \"filter name: value\" with the names Trendyol shows (\"İşlemci Tipi: AMD Ryzen 5\", \"Renk: Siyah\"). The same filter name twice means either value.", "items": { "type": "string" } }, "sellerBadges": { "title": "Seller types", "type": "array", "description": "Seller types as Trendyol lists them (Onaylanmış Satıcı, Başarılı Satıcı, or their ids kurumsal_satici, basarili_satici).", "items": { "type": "string" } }, "campaignBadges": { "title": "Campaign badges", "type": "array", "description": "Campaign badges as Trendyol lists them (Süper Avantajlı Ürün, Çok Avantajlı Ürün, or their ids kirmizi_kampanya_urunu, turuncu_kampanya_urunu).", "items": { "type": "string" } }, "lowestPriceInDays": { "title": "Lowest price in", "enum": [ "10", "14", "30" ], "type": "string", "description": "Only products Trendyol marks as at their lowest price of the last 10, 14 or 30 days." }, "onlyWith": { "title": "Only products with", "type": "array", "description": "Trendyol's own switches: free shipping, fast delivery, shipped today, coupon, flash sale, new products, influencer picks, campaign products, take more pay less, bulk sales, corporate invoice, reviews with photos, video, sellers rated above 9, Trendyol Plus, gift box, buy together, deals. Each must be one Trendyol offers for the search.", "items": { "type": "string", "enum": [ "free_shipping", "fast_delivery", "same_day_shipping", "coupon", "flash_sale", "new_product", "influencer_pick", "campaign_product", "take_more_pay_less", "bulk_sale", "corporate_invoice", "photo_reviews", "video", "top_rated_seller", "trendyol_plus", "gift_box", "cross_promotion", "deals" ], "enumTitles": [ "Free shipping", "Fast delivery", "Shipped today", "Collectable coupon", "Flash sale", "New products", "Picked by influencers", "Campaign products", "Take more, pay less", "Bulk sales", "Corporate invoice", "Reviews with photos", "Products with video", "Sellers rated above 9", "Trendyol Plus", "Gift box", "Buy together promotion", "Deals" ] } }, "discountedOnly": { "title": "Discounted only", "type": "boolean", "description": "Only products whose price is below the crossed out price Trendyol shows." }, "inStockOnly": { "title": "In stock only", "type": "boolean", "description": "Leave out products Trendyol marks as sold out." }, "includeSponsored": { "title": "Sponsored products", "type": "boolean", "description": "Deliver sponsored (paid) placements with their sponsored flag, on plain searches and seller shops. On category, brand and filtered lists Trendyol also places sponsored products of other categories, so there they are always skipped, free. Off: skipped everywhere, free. Each distinct product is delivered once either way.", "default": true }, "allowRewrittenSearches": { "title": "Take rewritten searches", "type": "boolean", "description": "Trendyol answers a word it does not know with another search of its own. Off (default): such a search delivers nothing and gets a free status row. On: Trendyol's replacement is delivered." }, "productRows": { "title": "Product rows", "type": "boolean", "description": "Deliver a row (and a Product charge) for each product found. Turn off to get only the reviews, answered questions or sellers of the products found.", "default": true }, "includeDetails": { "title": "Product details", "type": "boolean", "description": "Read each delivered product's details and nest them in its row (charged as Product details): barcode, variants with stock, attributes, description, every seller's offer, the winning seller, promotions, the lowest price window, the review summary with Trendyol's AI summary and the delivery estimate." }, "includeReviews": { "title": "Reviews", "type": "boolean", "description": "Deliver the reviews of each product found, one row each (charged as Review)." }, "maxReviewsPerProduct": { "title": "Max reviews per product", "minimum": 1, "maximum": 20000, "type": "integer", "description": "Left out: 100. Trendyol serves 5,050 reviews per order and star filter; above that, the run also reads the other date order and each star, every review once." }, "reviewSort": { "title": "Review order", "enum": [ "most_relevant", "newest", "oldest", "lowest_rated", "highest_rated" ], "type": "string", "description": "The order reviews are read in. Left out: most relevant; newest first when a start of the window is set (Reviews from, or the last N days); oldest first when only Reviews until is set." }, "reviewStars": { "title": "Review stars", "type": "array", "description": "Only reviews with these stars (Trendyol's own filter).", "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 carry photos." }, "reviewsFromDate": { "title": "Reviews from", "type": "string", "description": "Only reviews written on or after this day (YYYY-MM-DD, a UTC day). With the order left out, reviews are read newest first, which stops at the first older review." }, "reviewsToDate": { "title": "Reviews until", "type": "string", "description": "Only reviews written on or before this day (YYYY-MM-DD, a UTC day). With only this date and the order left out, reviews are read oldest first, which stops at the first newer review." }, "reviewsMaxAgeDays": { "title": "Reviews of the last days", "minimum": 1, "maximum": 3650, "type": "integer", "description": "Only reviews of the last N days before the run started (for a scheduled run; not together with Reviews from). With the order left out, reviews are read newest first." }, "includeQuestions": { "title": "Answered questions", "type": "boolean", "description": "Deliver the answered questions of each product found, every seller's, one row each (charged as Answered question)." }, "maxQuestionsPerProduct": { "title": "Max questions per product", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Left out: 100." }, "questionSort": { "title": "Question order", "enum": [ "newest", "oldest" ], "type": "string", "description": "The order answered questions are read in." }, "includeSellers": { "title": "Seller rows", "type": "boolean", "description": "Deliver a row for each distinct seller of the products found (charged as Seller, once per seller per run): shop name, official company name, score, product count, followers, location, time on Trendyol, shipping and answer times." }, "includePersonalData": { "title": "Include personal data", "type": "boolean", "description": "Off by default. On: adds the seller's legal registration that Trendyol shows on product pages (tax number, tax office, KEP e-mail address, street address, registration number) to product details and seller rows, and the reviewer's and asker's full name where Trendyol shows it unmasked. You are responsible for a lawful use of this data, GDPR and the Turkish KVKK included.", "default": false }, "monitorName": { "title": "Monitor name", "type": "string", "description": "A name for a scheduled watch (\"laptops under 20000\"). With it, the run remembers the products it delivered under this name (a memory of this Actor in your account)." }, "monitorMode": { "title": "Monitor mode", "enum": [ "new_only", "changes" ], "type": "string", "description": "New products only: a product delivered before under the monitor name is skipped, free. Every product, with changes: each product is delivered with changeType new, changed or unchanged and its previous price (unchanged ones can be left out, see Include unchanged products); a product listed by the last complete walk and missing now gets a free product_removed row." }, "includeUnchanged": { "title": "Changes monitor: include unchanged products", "type": "boolean", "description": "With the changes monitor, deliver (and bill) every product read, unchanged ones included (default). Off: only new and changed products are delivered and unchanged ones are left out, free; since a left out product earns nothing, the checking it needs is unpaid work, so a run in which little changed stops after a bounded amount of it (about 120 product ids, about 5 products with Product details, more on searches) with a free row naming what was not checked. Left out products count toward Max products.", "default": true }, "changeFields": { "title": "Changes monitor: fields that count as a change", "type": "array", "description": "With the changes monitor, the fields that make a product \"changed\": price (the price paid), originalPrice (the crossed out price), soldOut, seller (the winning seller). Left out: all four.", "items": { "type": "string", "enum": [ "price", "originalPrice", "soldOut", "seller" ], "enumTitles": [ "Price", "Crossed out price", "Sold out", "Winning seller" ] } }, "resetMonitor": { "title": "Reset the monitor", "type": "boolean", "description": "Forget what the monitor name remembers before this run." }, "resumeFromDatasetId": { "title": "Skip rows of a dataset", "type": "string", "description": "The id of a dataset of your account (an earlier run of this Actor that stopped): every product, review, question and seller already in it is skipped, free." }, "maxConcurrency": { "title": "Parallel requests", "minimum": 1, "maximum": 5, "type": "integer", "description": "How many requests run at once (left out: 3)." }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Left out: the Actor reads Trendyol through Apify datacenter sessions, which Trendyol answers (this needs no setting). You can give your own proxy links (http://user:password@host:port), or turn the proxy off to use the run's own address. Apify proxy groups named here are not used: residential traffic would cost more than a details row earns." } } }, "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 } } } } } } } } } }