{
  "openapi": "3.0.1",
  "info": {
    "title": "Trendyol Products Scraper",
    "description": "Trendyol Products Scraper SD - Trendyol Products Scraper is a Turkish e-commerce data tool that extracts public Trendyol products from searches, categories, brands, stores and product URLs: price, discount, rating, reviews, seller, badges, stock and images.",
    "version": "1.0",
    "x-build-id": "SxBUwa2XFHPFXYtZp"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/neuro-scraper~trendyol-products-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-neuro-scraper-trendyol-products-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/neuro-scraper~trendyol-products-scraper/runs": {
      "post": {
        "operationId": "runs-sync-neuro-scraper-trendyol-products-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/neuro-scraper~trendyol-products-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-neuro-scraper-trendyol-products-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 terms",
            "type": "array",
            "description": "Keywords searched on trendyol.com, one per line (Turkish works best), e.g. laptop / spor ayakkabı / elbise. Each keyword is one source.",
            "items": {
              "type": "string"
            }
          },
          "startUrls": {
            "title": "Trendyol URLs",
            "type": "array",
            "description": "Pages copied from trendyol.com, one per line: a search result (https://www.trendyol.com/sr?q=laptop&fc=true - its filters are kept), a category (https://www.trendyol.com/laptop-x-c103108), a brand (https://www.trendyol.com/acer-x-b102324), a store (https://www.trendyol.com/magaza/x-m-106740 or https://www.trendyol.com/sr?mid=106740) or a product page (...-p-921524970 - one row with full details).",
            "items": {
              "type": "string"
            }
          },
          "maxProductsPerSource": {
            "title": "Max products per source",
            "minimum": 1,
            "maximum": 100000,
            "type": "integer",
            "description": "How many products to take from each search term or URL. Trendyol pages hold 36 products; the Actor follows Trendyol's own next-page link until this number or the end of the results.",
            "default": 40
          },
          "maxItems": {
            "title": "Max products in total",
            "minimum": 0,
            "maximum": 1000000,
            "type": "integer",
            "description": "Stop the whole run after this many products (all sources together). 0 = no total limit.",
            "default": 200
          },
          "maxPages": {
            "title": "Max pages per source",
            "minimum": 0,
            "maximum": 10000,
            "type": "integer",
            "description": "Optional cap on result pages (36 products each) per source. 0 = no page cap (the product limits above still apply).",
            "default": 0
          },
          "sort": {
            "title": "Sort by",
            "enum": [
              "SCORE",
              "BEST_SELLER",
              "MOST_RECENT",
              "PRICE_BY_ASC",
              "PRICE_BY_DESC",
              "MOST_FAVOURITE",
              "MOST_RATED"
            ],
            "type": "string",
            "description": "Trendyol's own sort order (checked against the sort options the page offers on every run). Applies to search terms and listing URLs.",
            "default": "SCORE"
          },
          "minPrice": {
            "title": "Minimum price (TL)",
            "minimum": 0,
            "type": "integer",
            "description": "Trendyol's price filter, lower bound in Turkish lira (0 = none), e.g. 10000.",
            "default": 0
          },
          "maxPrice": {
            "title": "Maximum price (TL)",
            "minimum": 0,
            "type": "integer",
            "description": "Trendyol's price filter, upper bound in Turkish lira (0 = none), e.g. 20000.",
            "default": 0
          },
          "minRating": {
            "title": "Minimum star rating",
            "enum": [
              "0",
              "1",
              "2",
              "3",
              "4"
            ],
            "type": "string",
            "description": "Trendyol's product-rating filter (pr): only products rated at least this many stars.",
            "default": "0"
          },
          "maxRating": {
            "title": "Maximum star rating",
            "minimum": 0,
            "maximum": 5,
            "type": "number",
            "description": "Keep only products rated at or below this value, e.g. 3.5 (applied by the Actor to Trendyol's average rating; 0 = no limit). Unrated products are dropped when set.",
            "default": 0
          },
          "freeShippingOnly": {
            "title": "Free shipping only",
            "type": "boolean",
            "description": "Trendyol's 'Kargo Bedava' filter (fc=true).",
            "default": false
          },
          "fastDeliveryOnly": {
            "title": "Fast delivery only",
            "type": "boolean",
            "description": "Trendyol's 'Hızlı Teslimat' filter (rd=true).",
            "default": false
          },
          "couponsOnly": {
            "title": "Products with coupons only",
            "type": "boolean",
            "description": "Trendyol's 'Kuponlu Ürünler' filter (cc=true): products with a collectable coupon.",
            "default": false
          },
          "newReleaseOnly": {
            "title": "New products only",
            "type": "boolean",
            "description": "Trendyol's 'Yeni Ürünler' filter (np=true).",
            "default": false
          },
          "influencerOnly": {
            "title": "Influencer picks only",
            "type": "boolean",
            "description": "Trendyol's 'Fenomenlerin Seçtikleri' filter (pbi=true).",
            "default": false
          },
          "flashSaleOnly": {
            "title": "Flash-sale products only",
            "type": "boolean",
            "description": "Trendyol's 'Flaş Ürünler' filter (fp=true).",
            "default": false
          },
          "lowestPriceDays": {
            "title": "Lowest price in the last N days",
            "enum": [
              "",
              "10",
              "14",
              "30"
            ],
            "type": "string",
            "description": "Trendyol's 'Fiyat Geçmişi' filter (lpd): products now at their lowest price of that period.",
            "default": ""
          },
          "discountedOnly": {
            "title": "Discounted products only",
            "type": "boolean",
            "description": "Keep only products shown with a crossed-out old price (applied by the Actor to Trendyol's price data).",
            "default": false
          },
          "inStockOnly": {
            "title": "In-stock products only",
            "type": "boolean",
            "description": "Drop products Trendyol marks as sold out (applied by the Actor).",
            "default": false
          },
          "officialSellerOnly": {
            "title": "Official seller only",
            "type": "boolean",
            "description": "Keep only products carrying Trendyol's official-seller badge (applied by the Actor).",
            "default": false
          },
          "fetchDetails": {
            "title": "Open each product page (seller, attributes, stock)",
            "type": "boolean",
            "description": "Also open every product page to add seller name / score / city, other sellers, full category path, attributes, variants with barcode and stock, comment count and exact favourites. One extra request per product (slower). Product URLs in the input always get these details.",
            "default": false
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "Keep RESIDENTIAL in Turkey: visitors from other countries are sent to Trendyol's country picker (measured). An Apify proxy without a country gets TR added.",
            "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
                  },
                  "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}