{ "openapi": "3.0.1", "info": { "title": "Trendyol Scraper | All-In-One | $1 / 1k", "description": "Extract structured Trendyol product data including prices, ratings, product reviews, Q&A, seller details, and promotion signals. Built for enterprise-grade ecommerce intelligence, catalog enrichment, competitive analysis, and scalable data pipelines.", "version": "1.1", "x-build-id": "0Z10zzvxEV0hTPcTy" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fatihtahta~trendyol-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fatihtahta-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/fatihtahta~trendyol-scraper/runs": { "post": { "operationId": "runs-sync-fatihtahta-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/fatihtahta~trendyol-scraper/run-sync": { "post": { "operationId": "run-sync-fatihtahta-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": { "startUrls": { "title": "Enter Trendyol URLs to scrape directly (Searches, category pages, merchant store homepages or individual product pages)", "type": "array", "description": "Paste one or more Trendyol URLs to scrape directly. Supported page types include search result pages, category or collection pages, merchant store homepages, merchant all-products pages, and individual product pages. Merchant store homepages are automatically converted to the merchant all-products listing before scraping. Use this when you already know which pages you want to collect from and want precise control over the run.", "items": { "type": "string" } }, "queries": { "title": "Enter earch queries to discover and scrape relevant Trendyol product listings", "type": "array", "description": "Enter one or more product-focused keywords to search on Trendyol, such as a brand, product type, model, or category. Use this when you want the actor to discover relevant product listings for you instead of pasting URLs manually.", "items": { "type": "string" } }, "minPrice": { "title": "Minimum price", "minimum": 0, "type": "integer", "description": "Optional lower price bound for query-based searches. Use it to exclude cheaper items and focus on the price range that matters to your monitoring, analysis, or catalog work." }, "maxPrice": { "title": "Maximum price", "minimum": 0, "type": "integer", "description": "Optional upper price bound for query-based searches. Use it to narrow results to a target budget range or to exclude higher-priced products." }, "minimumStarRating": { "title": "Filter by minimum star rating", "enum": [ "1", "2", "3", "4", "4.5" ], "type": "string", "description": "Optionally require a minimum customer rating in query-based searches. Use it to focus on better-rated products when comparing assortments or building shortlists." }, "lowestPriceDays": { "title": "Only show products at their lowest price in the selected timeframe", "uniqueItems": true, "type": "array", "description": "Optionally keep only products that are currently at their lowest tracked price within the selected time window. Use this to focus on recent price drops and promotion opportunities.", "items": { "type": "string", "enum": [ "10", "14", "30" ], "enumTitles": [ "Currently lowest price in the last 10 Days", "Currently lowest price in the last 14 Days", "Currently lowest price in the last 30 Days" ] }, "default": [] }, "influencerPreferredOnly": { "title": "Only show products labeled as Influencer Preferred", "type": "boolean", "description": "Enable this to keep only products marked as Influencer Preferred in Trendyol search results. Use it when you want to focus on items highlighted with that label.", "default": false }, "couponsOnly": { "title": "Only show products with coupons available", "type": "boolean", "description": "Enable this to keep only products that currently show coupon availability. Use it when monitoring discount activity or coupon-based promotions.", "default": false }, "specialOffersOnly": { "title": "Only show products with special offers available", "type": "boolean", "description": "Enable this to keep only products that currently show a special offer. Use it when tracking promotional inventory and deal coverage.", "default": false }, "newlyReleasedOnly": { "title": "Only show newly released products", "type": "boolean", "description": "Enable this to focus on newly released products. Use it when monitoring fresh assortment and recent launches.", "default": false }, "getReviews": { "title": "Get reviews for each saved product", "type": "boolean", "description": "Enable this to collect customer reviews for each saved product. Reviews are stored as separate dataset records linked back to the product, which is useful for sentiment analysis, quality monitoring, and review dashboards.", "default": false }, "maxReviews": { "title": "Maximum reviews per product", "minimum": 1, "type": "integer", "description": "Optional cap on the number of reviews saved for each product. Use a smaller number for faster sampling, or a larger number when you need deeper review coverage." }, "getQna": { "title": "Get Q&As for each saved product", "type": "boolean", "description": "Enable this to collect answered product questions for each saved product. Q&A items are stored as separate dataset records linked back to the product, which is useful for buyer-intent analysis, support insights, and product research.", "default": false }, "maxQna": { "title": "Maximum Q&A per product", "minimum": 1, "type": "integer", "description": "Optional cap on the number of Q&A items saved for each product. Use a smaller number for quick checks, or raise it when you want broader question coverage per product." }, "limit": { "title": "Maximum listings to save (per query)", "minimum": 10, "type": "integer", "description": "Stop the run after this many product listings have been saved for each query. Choose a smaller number for quick sampling and validation, or a larger number when you need deeper market coverage.", "default": 50000 } } }, "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 } } }, "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 } } } } } } } } } }