Use Trendyol Product Finder with Price & Discount Tracking with Python

Search Trendyol by keyword or category, or get trending and new-arrival items, with price, discount percentage, rating and seller details.

1. Choose the data you need

Review the published README for supported collection modes, examples, and limits. The recipe below uses the current published input definition.

2. Prepare a source-based input

This JSON contains published prefills and required-field defaults. Review every value for your task before running it; it is not a promise of successful collection.

{
  "categoryUrls": [],
  "couponsOnly": false,
  "discountedOnly": false,
  "fastDeliveryOnly": false,
  "freeShippingOnly": false,
  "gender": "",
  "inStockOnly": false,
  "includeDetails": false,
  "includeQna": false,
  "includeReviews": false,
  "market": "TR",
  "maxItems": 3,
  "maxQna": 5,
  "maxReviews": 5,
  "minRating": "",
  "mode": "search",
  "newlyReleasedOnly": false,
  "officialSellerOnly": false,
  "productUrls": [],
  "searchQueries": [
    "sneakers"
  ],
  "searchUrls": [],
  "sortBy": "SCORE",
  "specialOffersOnly": false,
  "storeUrls": []
}

Download input.example.json and save your reviewed copy as input.json.

Field	Type	Required	Description
`mode`	string	required	What to collect. Search, category, store, best-seller and new-arrival modes return products; product returns full details; reviews and qna return those record types.
`market`	string	optional	Trendyol storefront to use. Prices and currency follow this market.
`searchQueries`	array	optional	(mode=search, bestSellers, newArrivals) One or more keywords, e.g. sneakers, coffee machine, iPhone.
`searchUrls`	array	optional	(mode=search, bestSellers, newArrivals) Paste Trendyol search result URLs. Their query filters are preserved.
`categoryUrls`	array	optional	(mode=category, bestSellers, newArrivals) Paste Trendyol category, brand or campaign URLs, or a category ID.
`storeUrls`	array	optional	(mode=store) Paste seller store URLs or seller IDs.
`productUrls`	array	optional	(mode=product, reviews, qna) Paste product URLs, product paths or numeric product IDs.
`sortBy`	string	optional	Sort order for listing modes. Best-seller and new-arrival modes force their own sort.
`gender`	string	optional	Optional gender filter for listing modes.
`minPrice`	integer	optional	Minimum displayed price in the selected market's currency.
`maxPrice`	integer	optional	Maximum displayed price in the selected market's currency.
`minRating`	string	optional	Optional minimum average rating, applied after the listing is fetched.
`freeShippingOnly`	boolean	optional	Keep products with free shipping.
`fastDeliveryOnly`	boolean	optional	Keep products with same-day, next-day or express delivery.
`discountedOnly`	boolean	optional	Keep products whose displayed price is below a higher reference price.
`inStockOnly`	boolean	optional	Keep products marked as available.
`couponsOnly`	boolean	optional	Keep products that show a coupon or discount code.
`specialOffersOnly`	boolean	optional	Keep products that show a promotion, flash sale or bundle offer.
`newlyReleasedOnly`	boolean	optional	Keep products tagged as new by Trendyol.
`officialSellerOnly`	boolean	optional	Keep products from sellers marked as official.
`includeDetails`	boolean	optional	For listing modes, open each product page to add variants, attributes, seller details, delivery estimates and social proof.
`includeReviews`	boolean	optional	Collect review rows for each product, in addition to product records.
`maxReviews`	integer	optional	Review rows to collect per product.
`includeQna`	boolean	optional	Collect answered question rows for each product, in addition to product records.
`maxQna`	integer	optional	Answered question rows to collect per product.
`maxItems`	integer	optional	Maximum product records for listing and product modes, or product sources processed in reviews/qna modes.

3. Start an Actor run

Set APIFY_TOKEN in your environment. Python 3.10 or newer is sufficient; this recipe uses no third-party packages.

Execution may incur charges. Review current pricing on Apify. The request asks for a 120-second timeout and a charge limit; these settings are subject to Apify’s pricing and do not guarantee an all-inclusive spending cap.

import json
import os
import urllib.request

# Save the schema-derived example as input.json; review and edit it first.
with open("input.json", encoding="utf-8") as stream:
    actor_input = json.load(stream)

token = os.environ["APIFY_TOKEN"]
request = urllib.request.Request(
    "https://api.apify.com/v2/acts/p1d6CuaYHNpsH1qjh/runs?timeout=120&maxTotalChargeUsd=0.50",
    data=json.dumps(actor_input).encode("utf-8"),
    headers={"Authorization": "Bearer " + token, "Content-Type": "application/json"},
    method="POST",
)
# This starts a potentially billable run. Do not automatically retry this POST.
with urllib.request.urlopen(request, timeout=40) as response:
    run = json.load(response)["data"]
print("Run ID:", run["id"])
print("Status:", run["status"])
# Inspect and download results in Apify Console once the run succeeds.

4. Inspect the actual results

Open the run in Apify Console and wait for a successful completion. Use the published output schema to locate results and the dataset schema to understand declared views. Missing or optional record fields must not be treated as guaranteed values.

Trendyol products with prices, discounts, variants, seller details and delivery estimates, plus review and answered-question records.

Questions before you run

Which inputs are required?

The published required fields are mode

What does this guide verify?

The fields, prefills, and schema links are rendered from the published build. This is a usage recipe, not a paid live extraction test. Source availability and collection results can vary.

What if the run request times out?

Check Apify Console before retrying. The first request may already have created a run. Do not automatically repeat a run-creation POST.

Open on Apify Full Actor reference

Generated from source build yF2v5vL6ZVaEcys4m and its README and schemas. Source changes regenerate this guide; no third-party editorial claims are inferred.