{ "openapi": "3.0.1", "info": { "title": "Trendyol [$0.5💰] Products · Prices · Reviews · Seller Emails", "description": "Scrape Trendyol in Turkey and 33 more countries (Germany, Bulgaria, Greece, Romania, Poland, UAE, Saudi Arabia and more): products, prices, specs, reviews, and every seller's contact details (email, address, tax ID) for the main and all other sellers. Goes past the 5,000-result limit.", "version": "0.0", "x-build-id": "NWTic7k78ETEiti1A" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/memo23~trendyol-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-memo23-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/memo23~trendyol-scraper/runs": { "post": { "operationId": "runs-sync-memo23-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/memo23~trendyol-scraper/run-sync": { "post": { "operationId": "run-sync-memo23-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": { "countries": { "title": "Countries", "type": "array", "description": "Which Trendyol marketplaces to search. Pick one or more, e.g. Germany, Bulgaria, Greece. Empty = Turkey.", "items": { "type": "string", "enum": [ "TR", "DE", "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", "QA", "KW", "OM", "BH", "AE", "SA" ], "enumTitles": [ "Turkey (trendyol.com)", "Germany", "Austria", "Belgium", "Bulgaria", "Croatia", "Czechia", "Denmark", "Estonia", "Finland", "France", "Greece", "Hungary", "Italy", "Latvia", "Lithuania", "Luxembourg", "Netherlands", "Poland", "Portugal", "Romania", "Slovakia", "Slovenia", "Spain", "Sweden", "Serbia", "Ukraine", "Moldova", "Qatar", "Kuwait", "Oman", "Bahrain", "United Arab Emirates (trendyol.ae)", "Saudi Arabia (trendyol.sa)" ] } }, "keywords": { "title": "Brands or keywords", "type": "array", "description": "One per line, e.g. Essence, Maybelline, L'Oreal. Each is searched in every selected country. Leave empty to crawl a whole category instead (see Advanced).", "items": { "type": "string" } }, "brandMatchOnly": { "title": "Only products from these brands", "type": "boolean", "description": "Turn on when the list above is brand names: products of other brands that show up in the search are skipped (and not charged).", "default": false }, "startUrls": { "title": "Trendyol URLs (optional)", "type": "array", "description": "Instead of countries + keywords you can paste Trendyol links: a search, category, product or reviews page, from any marketplace. A marketplace homepage such as https://www.trendyol.com/de counts as choosing that country.", "items": { "type": "string" } }, "scrapeProductDetails": { "title": "Product details and main seller contact", "type": "boolean", "description": "Full price, stock, specs, images, rating, and the main seller's company name, email, address, tax and registration number.", "default": true }, "includeOtherSellers": { "title": "All sellers of each product", "type": "boolean", "description": "Adds one row per seller of each product (main seller and every other seller) with their price and contact details.", "default": false }, "scrapeReviews": { "title": "Reviews", "type": "boolean", "description": "Each product's customer reviews.", "default": false }, "maxReviewsPerProduct": { "title": "Max reviews per product", "minimum": 1, "type": "integer", "description": "Only used when Reviews is on.", "default": 100 }, "maxItems": { "title": "Maximum products (whole run)", "minimum": 1, "type": "integer", "description": "Total cap across all countries and keywords. Controls cost.", "default": 1000 }, "maxItemsPerStartUrl": { "title": "Maximum products per keyword per country", "minimum": 0, "type": "integer", "description": "Optional. E.g. 300 = at most 300 products for each brand in each country. Empty = no per-keyword cap." }, "monitoringMode": { "title": "Only new products (monitoring)", "type": "boolean", "description": "On scheduled runs, return only products you have not received before.", "default": false }, "resetMonitoringState": { "title": "Reset monitoring (one-shot)", "type": "boolean", "description": "Forget which products were already delivered, and start a new baseline.", "default": false }, "storefrontRootCategory": { "title": "Category to crawl when there are no keywords", "type": "string", "description": "Category path from a Trendyol category link. Default `beauty-x-c89` (Beauty).", "default": "beauty-x-c89" }, "splitByPrice": { "title": "Go past Trendyol's ~5,000-result limit", "type": "boolean", "description": "Trendyol shows about 5,000 products per search; larger ones are split by price range automatically.", "default": true }, "enrichEmails": { "title": "Find seller emails on the web (experimental)", "type": "boolean", "description": "Searches the web for a seller email. Rarely needed: the seller's email already comes with Product details on most marketplaces.", "default": false }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "type": "integer", "description": "Product pages processed in parallel.", "default": 10 }, "maxRequestRetries": { "title": "Max retries per page", "minimum": 0, "maximum": 20, "type": "integer", "description": "How many times a blocked or empty page is retried on a fresh IP before it is skipped.", "default": 7 }, "proxy": { "title": "Proxy configuration (optional override)", "type": "object", "description": "Leave empty — the actor already routes all traffic through its own built-in residential proxy at no extra cost to you. Only set this if you want to use your own proxies." } } }, "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 } } } } } } } } } }