{ "openapi": "3.0.1", "info": { "title": "Trendyol Product Scraper", "description": "This scraper can help you retrieve current and accurate data about products from Trendyol, an online retail platform. This tool can be useful for keeping track of the latest offerings from Trendyol or for gathering information for research or analysis purposes.", "version": "0.1", "x-build-id": "K6VGaFcrZvvO3EF12" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/yeyo~trendyol-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-yeyo-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/yeyo~trendyol-scraper/runs": { "post": { "operationId": "runs-sync-yeyo-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/yeyo~trendyol-scraper/run-sync": { "post": { "operationId": "run-sync-yeyo-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", "required": [ "operation" ], "properties": { "operation": { "title": "Operation", "enum": [ "scrape", "search", "qa", "brand-browse" ], "type": "string", "description": "Which capability to run.", "default": "scrape" }, "url": { "title": "Product URL", "type": "string", "description": "Trendyol product page URL. Required for operations 'scrape' and 'qa'." }, "query": { "title": "Search query", "type": "string", "description": "Keyword to search. Required for operation 'search'. Truncated to 85 characters." }, "brandId": { "title": "Brand ID", "type": "string", "description": "Numeric Trendyol brand ID (the 'wb' parameter). Required for operation 'brand-browse'." }, "sort": { "title": "Brand browse sort", "enum": [ "MOST_RATED", "BEST_SELLER", "MOST_FAVOURITE", "PRICE_BY_ASC", "PRICE_BY_DESC", "NEWEST" ], "type": "string", "description": "Sort order for 'brand-browse'.", "default": "MOST_RATED" }, "page": { "title": "Page", "minimum": 1, "type": "integer", "description": "Page number for 'search' and 'brand-browse'.", "default": 1 }, "brands": { "title": "Brand filter (search)", "type": "array", "description": "Optional brand IDs to filter a search (maps to the 'wb' query param).", "items": { "type": "string" } }, "limit": { "title": "Q&A limit", "minimum": 1, "maximum": 100, "type": "integer", "description": "Max number of Q&A items to fetch (capped at 100).", "default": 100 }, "enrich": { "title": "Enrich product description", "type": "boolean", "description": "For 'scrape': make an extra API call to fetch the full product description.", "default": false }, "raw": { "title": "Raw output", "type": "boolean", "description": "Return the platform's native JSON instead of the unified shape.", "default": false }, "proxy": { "title": "Proxy configuration", "type": "object", "description": "Proxy settings. Trendyol blocks non-Turkish and datacenter IPs, so the default is Apify residential proxy with Turkish exit nodes. Disable only if you run from a Turkish IP.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "TR" } } } }, "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 } } } } } } } } } }