{ "openapi": "3.0.1", "info": { "title": "Trendyol Product Search Scraper", "description": "The Trendyol Product Search Scraper extracts detailed product data from Trendyol, including name, price, brand, etc., using search query URLs. It's perfect for market research, trend analysis, lead generation, and campaign planning.", "version": "0.0", "x-build-id": "YatJVwhWVna6RJz8i" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/ecomscrape~trendyol-product-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-ecomscrape-trendyol-product-search-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/ecomscrape~trendyol-product-search-scraper/runs": { "post": { "operationId": "runs-sync-ecomscrape-trendyol-product-search-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/ecomscrape~trendyol-product-search-scraper/run-sync": { "post": { "operationId": "run-sync-ecomscrape-trendyol-product-search-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": { "urls": { "title": "URLs of the product list by query and country code (optional) to scrape", "type": "array", "description": "Add the URLs of the product list by query and country code (optional) you want to scrape. The URL may or may not include a language code. If url include language code and you do not enter the country code please select Auto select country code. You can paste URLs one by one, or use the Bulk edit section to add a prepared list." }, "ignore_url_failures": { "title": "Ignore URL failures", "type": "boolean", "description": "If true, the scraper will continue running even if some URLs fail to be scraped after the maximum number of retries is reached." }, "keyword": { "title": "Keyword to search", "type": "string", "description": "Enter the keyword to search for items" }, "country_code": { "title": "Country", "enum": [ "tr", "de", "ae", "sa", "qa", "kw", "om", "bh", "ua", "md", "at", "be", "bg", "hr", "cz", "dk", "ee", "fi", "fr", "gr", "hu", "ie", "it", "lv", "lt", "nl", "pl", "pt", "ro", "sk", "si", "es", "se", "az", "us", "lu", "ge", "kz", "kg", "jo", "iq", "lb" ], "type": "string", "description": "Search Items in the selected country code" }, "language_code": { "title": "Language", "enum": [ "de", "en", "ar", "bg", "cs", "el", "hu", "pl", "ro", "sk" ], "type": "string", "description": "Search Items in the selected language code" }, "sort_by": { "title": "Sort Items by", "enum": [ "", "PRICE_BY_ASC", "PRICE_BY_DESC", "MOST_RECENT", "BEST_SELLER", "MOST_FAVOURITE", "MOST_RATED" ], "type": "string", "description": "Sort Items by (e.g., price-ascending, price-descending, title-ascending, title-descending, relevance)" }, "discount": { "title": "Discount", "type": "boolean", "description": "Show items with discount" }, "availability": { "title": "Availability", "type": "boolean", "description": "Show items with availability" }, "page": { "title": "Page start", "type": "integer", "description": "Specify the page number to start scraping from" }, "max_items_per_url": { "title": "Limit the number of items per URL or search filters", "type": "integer", "description": "Limit the number of items per URL or search filters you want to scrape" }, "auto_select_country_code_if_missing": { "title": "Auto select country code if missing", "type": "boolean", "description": "If you do not enter the country code in the Urls, to ensure you get the desired results, use Auto select country code." }, "max_retries_per_url": { "title": "Limit the number of retries", "type": "integer", "description": "Limit the number of retries for each URL or search filters if the scrape is detected as a bot or the page fails to load" }, "proxy": { "title": "Proxy configuration", "type": "object", "description": "Select proxies to be used by your scraper." } } }, "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 } } } } } } } } } }