{ "openapi": "3.0.1", "info": { "title": "πŸš€ Trendyol Scraper Β· 10,000 Free Products/Month", "description": "Trendyol Scraper gets you Trendyol product data ⚑ fast, 🎯 100% accurate and πŸ” ridiculously detailed β€” prices, stock, ratings, sellers & specs from search, category, brand or store. πŸ’° $0.50 per 1,000 products, no start fee. Scrape your first 10,000 products free every month πŸš€", "version": "0.0", "x-build-id": "EupJeDFcuT6IBbjBV" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/omkar-cloud~trendyol-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-omkar-cloud-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/omkar-cloud~trendyol-scraper/runs": { "post": { "operationId": "runs-sync-omkar-cloud-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/omkar-cloud~trendyol-scraper/run-sync": { "post": { "operationId": "run-sync-omkar-cloud-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 keywords", "type": "array", "description": "Words you would type into Trendyol's search box, one per line. Each keyword is searched separately.", "items": { "type": "string" } }, "startUrls": { "title": "πŸ”— Trendyol links or product IDs", "type": "array", "description": "Trendyol links, one per line: a search page (/sr?q=…), a category (…-x-c103108), a brand (…-x-b44), a store (/magaza/…-m-968) or a product (…-p-905790695). A bare product ID works too. Product links always come back as full rows.", "items": { "type": "string" } }, "maxResults": { "title": "Maximum products per keyword or link", "minimum": 1, "maximum": 4320, "type": "integer", "description": "Stop after this many products for each keyword / link (and each country). Trendyol pages hold 36 products. Keeps your cost predictable.", "default": 100 }, "countries": { "title": "🌍 Countries", "type": "array", "description": "Trendyol storefronts to scrape. Prices come back in each storefront's own currency. Each keyword / link runs once per country.", "items": { "type": "string", "enum": [ "TR", "DE", "AT", "AE", "SA", "QA", "KW", "OM", "BH", "UA", "MD", "BE", "BG", "HR", "CZ", "DK", "EE", "FI", "FR", "GR", "HU", "IT", "LV", "LT", "NL", "PL", "PT", "RO", "SK", "RS", "SI", "ES", "SE", "LU", "AZ" ], "enumTitles": [ "TΓΌrkiye (TRY)", "Germany (EUR)", "Austria (EUR)", "United Arab Emirates (AED)", "Saudi Arabia (SAR)", "Qatar (QAR)", "Kuwait (KWD)", "Oman (OMR)", "Bahrain (BHD)", "Ukraine (UAH)", "Moldova (MDL)", "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)", "Netherlands (EUR)", "Poland (PLN)", "Portugal (EUR)", "Romania (RON)", "Slovakia (EUR)", "Serbia (RSD)", "Slovenia (EUR)", "Spain (EUR)", "Sweden (EUR)", "Luxembourg (EUR)", "Azerbaijan (AZN)" ] }, "default": [ "TR" ] }, "sort": { "title": "Sort by", "enum": [ "relevance", "price_asc", "price_desc", "newest", "best_seller", "most_favourite", "most_rated" ], "type": "string", "description": "Order of the results, as on Trendyol.", "default": "relevance" }, "fullDetails": { "title": "πŸ“¦ Full details", "type": "boolean", "description": "Add the full product page to every row: stock, sizes with barcodes, 30+ specs, description, every other seller's offer, and the seller's legal details (official name, address, tax number, email). Billed as the Full product details add-on.", "default": false }, "minPrice": { "title": "Minimum price", "minimum": 0, "type": "integer", "description": "Only products at or above this price, in the storefront's currency." }, "maxPrice": { "title": "Maximum price", "minimum": 0, "type": "integer", "description": "Only products at or below this price, in the storefront's currency." }, "minRating": { "title": "Minimum rating", "enum": [ "3", "4", "4.5" ], "type": "string", "description": "Only products with at least this average star rating. Leave empty for any rating." }, "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 or same-day delivery badge.", "default": false }, "discountedOnly": { "title": "Discounted only", "type": "boolean", "description": "Only products currently below their original price.", "default": false }, "inStockOnly": { "title": "In stock only", "type": "boolean", "description": "Drop sold-out products.", "default": false }, "couponsOnly": { "title": "Coupons only", "type": "boolean", "description": "Only products that offer a collectable coupon.", "default": false }, "officialSellersOnly": { "title": "Official sellers only", "type": "boolean", "description": "Only products sold by an official brand seller.", "default": false }, "influencerPicksOnly": { "title": "Influencer picks only", "type": "boolean", "description": "Only products picked by a Trendyol influencer.", "default": false }, "skipAds": { "title": "Skip sponsored products", "type": "boolean", "description": "Leave out sponsored (ad) listings.", "default": false }, "onlyNewProducts": { "title": "πŸ”” Only new products", "type": "boolean", "description": "For scheduled runs: return only products you have not received from an earlier run with the same keywords, links and countries. The first run returns everything.", "default": 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 } } } } } } } } } }