All-In-One Trendyol Scraper

Slug: fatihtahta/trendyol-scraper

Overview

All-In-One Trendyol Scraper collects structured product, review, and answered Q&A data from Trendyol, including titles, prices, ratings, availability, brand and category metadata, seller details, and media links. It supports direct collection from product pages, search pages, category pages, merchant pages, and keyword-based discovery with optional shopping filters. Trendyol is one of the largest ecommerce marketplaces in Turkey, which makes its catalog and marketplace data useful for pricing intelligence, assortment analysis, promotion tracking, and catalog enrichment. The actor turns repeated manual collection into automated, repeatable runs with consistent output. That saves time for analysts, operators, and developers who need fresh data on a schedule.

Why Use This Actor

• Market research and analytics: Track pricing, ratings, assortment breadth, seller presence, and promotion visibility across searches, categories, brands, or merchant pages.
• Product and content teams: Enrich catalogs, benchmark competitor listings, compare merchandising patterns, and collect review or Q&A signals for product research.
• Developers and data engineering teams: Feed analytics tools, ETL pipelines, data warehouses, or internal APIs with structured records that are ready to consume.
• Lead generation and enrichment: Identify active merchants, brand presence, and listing coverage for outreach, marketplace mapping, or account research.
• Monitoring and competitive tracking: Re-run the same inputs over time to watch price movement, newly released items, coupon activity, or special-offer coverage.

Input Parameters

Provide any combination of URLs, queries, and filters to control what gets collected.

Parameter	Type	Description	Default
startUrls	string[]	One or more Trendyol URLs to scrape directly. Supported inputs include search result pages, category or collection pages, merchant store pages, merchant all-products pages, and individual product pages.	–
queries	string[]	One or more product-focused search terms, such as a brand, model, or category, for automatic product discovery on Trendyol.	–
minPrice	integer	Optional minimum price for query-based searches. Use it to exclude lower-priced items.	–
maxPrice	integer	Optional maximum price for query-based searches. Use it to keep results within a target budget range.	–
minimumStarRating	string	Optional minimum customer rating for query-based searches. Allowed values: 1, 2, 3, 4, 4.5.	–
lowestPriceDays	string[]	Keep only products that are currently at their lowest tracked price within the selected timeframe. Allowed values: 10, 14, 30.	[]
influencerPreferredOnly	boolean	When true, include only products labeled as Influencer Preferred.	false
couponsOnly	boolean	When true, include only products that currently show coupon availability.	false
specialOffersOnly	boolean	When true, include only products that currently show a special offer.	false
newlyReleasedOnly	boolean	When true, include only newly released products.	false
enrich_data	boolean	When true, visit each discovered product page and merge richer product details into product records. When false, search/category/merchant runs use only listing-response data. Direct product URLs are still collected from their product page.	false
getReviews	boolean	When true, collect customer reviews for each saved product as separate dataset records linked to the parent product.	false
maxReviews	integer	Optional maximum number of reviews to save per product. Useful for sampling or for controlling dataset size.	–
getQna	boolean	When true, collect answered product Q&A entries for each saved product as separate dataset records linked to the parent product.	false
maxQna	integer	Optional maximum number of Q&A items to save per product.	–
limit	integer	Maximum number of product listings to save for each query. Use smaller values for quick validation and larger values for broader market coverage.	50000

Example Input

{
  "queries": ["playstation 5", "gaming chair"],
  "minPrice": 5000,
  "maxPrice": 40000,
  "minimumStarRating": "4",
  "couponsOnly": true,
  "enrich_data": true,
  "getReviews": true,
  "maxReviews": 20,
  "limit": 500
}

Output

6.1 Output destination

The actor writes JSON records to the default Apify dataset. Records are grouped for direct ETL use: core identifiers stay at the top level, crawl/request metadata is under source_context, and source-specific detail is kept in semantic nested objects.

6.2 Record envelope

Every dataset record includes these stable top-level fields when available:

• type (string, required): Record category. Current values are product, review, and qna.
• id (string, required): Stable source identifier for the record.
• url (string, required): Canonical product URL for products, or parent product URL for related records.
• source_context (object, required): Input and crawl provenance, including seed_id, seed_type, seed_value, source_url, loaded_url, scraped_time, page_index, and domain when present.

Recommended idempotency key: type + ":" + id.

6.3 Product example

{
  "type": "product",
  "id": "800623487",
  "url": "https://www.trendyol.com/sony/playstation-5-slim-dijital-2-dualsense-ps5-kol-sarj-istasyonu-ithalatci-garantili-p-800623487",
  "title": "Playstation 5 Slim Dijital 2. Dualsense Ps5 Kol Sarj Istasyonu",
  "source_context": {
    "seed_id": "17650afa8671",
    "seed_type": "query",
    "seed_value": "playstation",
    "source_url": "https://www.trendyol.com/sr?qt=playstation&st=playstation&os=1&q=playstation",
    "scraped_time": "2026-05-21T10:32:15Z",
    "page_index": 1,
    "domain": "www.trendyol.com"
  },
  "identifiers": {
    "product_id": "800623487",
    "content_id": 800623487,
    "listing_id": "5921a6a34898002882a3b1b876ee7dc9",
    "item_number": 1064652564,
    "brand_id": 1466,
    "merchant_id": 555576
  },
  "brand": {
    "id": 1466,
    "name": "Sony",
    "web_brand_id": 795,
    "web_brand_name": "Sony",
    "is_global_brand": true
  },
  "category": {
    "id": 4848,
    "name": "Playstation 5",
    "hierarchy": "Elektronik/Oyun & Oyun Konsollari/Playstation Konsollari/Playstation 5"
  },
  "pricing": {
    "current_price": 37198,
    "currency": "TRY",
    "price": {
      "discounted_price": { "value": 37198, "text": "37.198 TL" },
      "selling_price": { "value": 37198, "text": "37.198 TL" }
    }
  },
  "availability": {
    "in_stock": true,
    "quantity": 34,
    "max_sale_limit": 3
  },
  "seller": {
    "primary": {
      "id": 555576,
      "name": "Fly Technology Ankara",
      "city": "Ankara",
      "country": "TURKIYE",
      "score": { "value": 9.3 }
    },
    "legal_info": {
      "official_name": "Example Seller Limited Sirketi",
      "registered_email": "seller@example.com",
      "tax_number": "1234567890",
      "tax_office": "Example Tax Office"
    }
  },
  "media": {
    "images": ["https://cdn.dsmcdn.com/example/1_org_zoom.jpg"],
    "primary_image": "https://cdn.dsmcdn.com/example/1_org_zoom.jpg"
  },
  "metrics": {
    "rating": { "average_rating": 4.52, "comment_count": 1762, "total_count": 3044 },
    "favorite_count": 99946,
    "favorite_count_label": "100K",
    "order_count_label": "100+"
  },
  "attributes": {
    "items": [
      {
        "key": { "id": 290, "name": "Garanti Tipi" },
        "value": { "id": 4182, "name": "Ithalatci Garantili" }
      }
    ],
    "variants": [{ "item_number": 1064652564, "in_stock": true }]
  },
  "badges": {
    "ranking": { "type": "BEST_SELLER", "title": "1" },
    "simplified": [{ "type": "FREE_CARGO", "title": "Kargo Bedava" }]
  },
  "promotions": {
    "items": [{ "id": 27426981, "name": "Kargo Bedava" }]
  },
  "details": {
    "discovery": {
      "english_translation": {
        "product_name": "Playstation 5 Slim Digital Bundle",
        "brand_name": "Sony"
      }
    }
  }
}

6.4 Field reference

Product records use these main groups:

• identifiers: Product, content, listing, item, group, brand, merchant, campaign, boutique, and product-code identifiers.
• brand: Brand names, brand IDs, web-brand references, and global-brand flags.
• category: Category ID/name, hierarchy, category trees, business unit, category rankings, layout, and category flags.
• pricing: Current numeric price, currency, tax/installment data, original source price objects, and optional source price components.
• availability: In-stock flags, stock state, quantity, sale limits, refundability, and related availability flags.
• seller: Seller identity under primary, registered seller details under legal_info, operational seller flags under operations, plus campaign and winning-variant data when enrichment is enabled.
• fulfillment: Shipping, delivery, flash-sale, fulfilment type, and delivery-duration fields.
• media: Product image URLs, primary image, and media capability flags.
• metrics: Rating totals, favorite count, review/comment counts, and source social-proof labels.
• attributes: Product attributes, variants, gender, energy class, and source-specific attribute flags.
• badges: Ranking, seller, tag, free-shipping, featured, premium, sale, and other meaningful source badges.
• promotions: Coupons, price labels, applied promotions, code-promo flags, and source promotion objects.
• advertising: Included only when the source indicates meaningful advertising or sponsored metadata.
• details: Extra useful source-specific data that does not fit a stronger semantic group.

Review records keep the top-level review fields (review_id, rating, comment, created_at, language, trusted) and group related data under reviewer, seller, metrics, media, parent_product, source_context, and details.

Q&A records keep the top-level Q&A identifiers and group related data under question, answer, parent_product, source_context, and details.

Data guarantees & handling

• Best-effort extraction: Fields may vary by region, session context, product availability, or site experiments.
• Optional fields: Null-check in downstream code before using optional or nested values.
• Deduplication: Use type + ":" + id for deduplication and upserts.

How to Run on Apify

1. Open the actor in Apify Console.
2. Add one or more Trendyol URLs or enter one or more search queries.
3. Configure optional filters such as price range, rating threshold, coupon visibility, or newly released items.
4. Set the maximum number of listings to collect, and optionally enable reviews or Q&A collection.
5. Click Start, wait for the run to finish, then download the dataset in JSON, CSV, Excel, or another supported format.

Scheduling & Automation

Scheduling

Automated Data Collection

You can schedule recurring runs to keep your Trendyol dataset fresh without starting each run manually. This is useful for ongoing price checks, assortment monitoring, and reporting workflows.

• Navigate to Schedules in Apify Console
• Create a new schedule (daily, weekly, or custom cron)
• Configure input parameters
• Enable notifications for run completion
• Optional: Add webhooks for automated processing

Integration Options

• Webhooks: Trigger downstream actions when a run completes.
• Zapier: Connect to 5,000+ apps without coding.
• Make (Integromat): Build multi-step automation workflows.
• Google Sheets: Export results to a spreadsheet.
• Slack/Discord: Receive notifications and summaries.
• Email: Send automated reports via email.

Performance

Estimated run times:

• Small runs (< 1,000 outputs): ~2-3 minutes
• Medium runs (1,000-5,000 outputs): ~5-15 minutes
• Large runs (5,000+ outputs): ~15-30 minutes

Execution time varies based on filters, result volume, and how much information is returned per record.

Compliance & Ethics

Responsible Data Collection

This actor collects publicly available product, pricing, merchant, review, and answered Q&A information from https://www.trendyol.com for legitimate business purposes. Common use cases include ecommerce research and market analysis, assortment and promotion monitoring, and catalog enrichment or analytics workflows. You are responsible for ensuring your use complies with applicable laws, regulations, and the target site's terms. This section is informational and not legal advice.

• Ecommerce research and market analysis
• Assortment and promotion monitoring
• Catalog enrichment and analytics workflows

Best Practices

• Use collected data in accordance with applicable laws, regulations, and the target site's terms.
• Respect individual privacy and personal information.
• Use data responsibly and avoid disruptive or excessive collection.
• Do not use this actor for spamming, harassment, or other harmful purposes.
• Follow relevant data protection requirements where applicable, including GDPR and CCPA.

Support

For help, use the Issues tab or the actor page in Apify Console. Include the input used with sensitive values redacted, the run ID, a short description of expected versus actual behavior, and, if helpful, a small output sample.