Apex Hali Scraper

🧵 Apex Hali Scraper – Carpet & Rug Product Data Extractor

A powerful e-commerce scraper that extracts structured product data from Apex Hali, a leading Turkish carpet and rug store built on Shopify. This actor helps you collect complete product catalogs, monitor prices, and analyze collections with clean, structured output ready for automation.

🚀 Start Scraping Carpet Data

Turn Apex Hali’s catalog into structured data in minutes. 👉 Extract product prices, images, and variants 👉 Crawl full collections or specific product URLs 👉 Monitor carpet pricing and availability 👉 Export data to CSV, JSON, or Excel Click “Run” and start building your product dataset.

🧠 What Makes This Scraper Powerful?

Scraping e-commerce sites is not just about collecting product names. You need: Clean structured data Consistent pricing formats Reliable extraction despite theme changes Full catalog coverage This scraper solves that with: Multi-selector extraction (CSS + JS + meta fallback) Shopify-aware crawling and pagination handling Normalized Turkish Lira pricing Extraction confidence scoring

🔄 Flexible Scraping Modes

Choose how you want to scrape:

🔹 Full Catalog Mode (discover_and_scrape) Crawls collections Discovers all product URLs Extracts full product data

🔹 Product URL Mode (product_urls_only) Scrape only specific product pages No discovery crawling

🔹 Category Mode (category_urls_only) Extract collection structure only Skip product-level scraping

⚡ Key Features

Apex Hali product scraper (Shopify-based) Carpet and rug catalog extraction Turkish Lira price normalization Variant extraction (size, options) Image and media scraping SEO metadata extraction Breadcrumb and category mapping Extraction confidence scoring Anti-detection with human-like delays

📊 Data You Can Extract

Each product may include: Product name & URL Price (text + numeric) Currency (TRY) Availability status Product description Variants (size, color, options) Images (all + primary) Breadcrumb categories SKU and product type SEO metadata (title + description) Clean, structured, and ready for analytics.

🎯 Real-World Use Cases

🛒 Product Catalog Building Create structured datasets for carpet and rug products.

💰 Price Monitoring Track price changes and compare products across collections.

📊 Market Research Analyze product categories, pricing strategies, and catalog depth.

🤖 AI & Data Pipelines Feed product data into machine learning or recommendation systems.

📦 Inventory Systems Build internal product feeds for business workflows.

🛠️ How to Use

Add Apex Hali URLs (homepage, collection, or product pages) Select scraping mode Set limits (products/pages) Enable proxy (recommended: TR residential) Run the actor Download or integrate data via API

🛠️ How to Use Apex Hali Scraper on Apify (aligned to this implementation)

1. Add one or more Apex Hali URLs in startUrls (homepage, /collections/..., or /products/...).
2. Choose mode:
   • discover_and_scrape (default): crawl collections and scrape products
   • product_urls_only: scrape only the provided product URLs
   • category_urls_only: output collection/category rows without visiting product pages
3. Set maxProducts and maxPages to control scale.
4. Keep maxConcurrency ≤ 8 for stability.
5. Enable proxyConfiguration (Residential + country TR recommended).
6. Run and export from Dataset as JSON/CSV/Excel (or via API).

Input example

Full schema: INPUT_SCHEMA.json. Example:

{
  "startUrls": [
    { "url": "https://www.apexhali.com/en" },
    { "url": "https://www.apexhali.com/en/collections/machine-carpet" },
    { "url": "https://www.apexhali.com/en/products/hare-plus-8917-mavi-makine-halisi" }
  ],
  "mode": "discover_and_scrape",
  "maxProducts": 10,
  "maxPages": 5,
  "categoryFilters": [],
  "includeCollections": true,
  "includeProductDetails": true,
  "includeBreadcrumbs": true,
  "includeImages": true,
  "includeVariants": true,
  "includeDescription": true,
  "includeSeoMetadata": true,
  "includeAvailabilitySignals": true,
  "includePriceHistoryFields": false,
  "language": "en",
  "requestTimeoutSecs": 45,
  "maxConcurrency": 3,
  "blockAssets": true,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"],
    "apifyProxyCountry": "TR"
  },
  "debugMode": false,
  "saveHtmlSnapshot": false,
  "saveScreenshot": false,
  "saveParsedRows": false
}

Output example

Results are stored in the Actor’s default dataset. Example product row (illustrative):

{
  "type": "product",
  "productName": "Hare Plus 8917 Mavi - Makine Halısı",
  "productUrl": "https://www.apexhali.com/en/products/hare-plus-8917-mavi-makine-halisi",
  "priceText": "From ₺12,880.00 TL",
  "priceNumeric": 12880.0,
  "currency": "TRY",
  "availabilitySignal": "in_stock",
  "timestamp": "2026-04-29T12:00:00.000Z"
}

📦 Output

Each dataset row represents: Product record Collection summary Error row (if extraction fails) Final summary 👉 Only meaningful fields included 👉 No empty values 👉 Optimized for pipelines

🔐 Reliability & Anti-Blocking

To ensure stable scraping: Use Turkish residential proxy Keep concurrency ≤ 8 Enable debug mode for troubleshooting Use fallback selectors for stability

❓ Frequently Asked Questions

What is Apex Hali Scraper used for? This is a carpet product scraper that extracts structured data from apexhali.com, including prices, images, variants, and catalog information.

Can I scrape the full Apex Hali catalog? Yes. Use discover_and_scrape mode to crawl collections and extract all product data automatically.

Does this work as a Shopify scraper? Yes. Apex Hali is built on Shopify, and this actor is optimized for Shopify-based product extraction and pagination.

Can I track carpet prices over time? Yes. Schedule runs and compare priceNumeric values to monitor price changes and trends.

What makes this different from a basic product scraper? This scraper includes: Price normalization Extraction confidence scoring Multi-mode scraping SEO metadata extraction

Why is a Turkish proxy recommended? Using a TR residential proxy improves success rate by avoiding geo-restrictions and reducing blocking from apexhali.com.

Can I scrape only specific product URLs? Yes. Use product_urls_only mode to target specific products without crawling.

What type of data can I extract from carpet products? You can extract product details such as: Prices Variants (sizes, options) Images Descriptions SEO metadata

Is this useful for e-commerce research? Yes. This tool is widely used for product research, competitor analysis, and catalog extraction.

What formats can I export data in? You can export in JSON, CSV, or Excel, or access via the Apify platform API.

📈 Why Use This Scraper?

Manual product data collection is slow and inconsistent. This actor gives you: Automated catalog extraction Structured product datasets Reliable scraping performance Scalable data workflows

🚀 Get Started

Add your Apex Hali URLs and start extracting carpet product data instantly.

Output

Results are stored in the Actor's default dataset. Each item is one of four record types.

Typical product record fields:

• Identity: type, productName, productUrl, canonicalUrl, pageType, sourceCollection, language.
• Pricing: priceText, priceNumeric, compareAtPriceText, compareAtPriceNumeric, currency.
• Availability: availabilityText, availabilitySignal (in_stock / out_of_stock / unknown).
• Content: description, breadcrumb, variants, productType, sku.
• Media: images, primaryImage.
• SEO: metaTitle, metaDescription.
• Quality: extractionConfidence (high / medium / low), extractionConfidenceReason.
• Meta: timestamp.
• Errors: error, errorType on failure rows.

Example product item:

{
  "type": "product",
  "productName": "Hare Plus 8917 Mavi - Makine Halısı",
  "productUrl": "https://www.apexhali.com/en/products/hare-plus-8917-mavi-makine-halisi",
  "canonicalUrl": "https://www.apexhali.com/en/products/hare-plus-8917-mavi-makine-halisi",
  "pageType": "product",
  "sourceCollection": "Hare - Dokuda Derinlik",
  "breadcrumb": ["Machine Carpets", "Blue Carpets"],
  "priceText": "From ₺12,880.00 TL",
  "priceNumeric": 12880.0,
  "compareAtPriceText": null,
  "compareAtPriceNumeric": null,
  "currency": "TRY",
  "availabilityText": "Available",
  "availabilitySignal": "in_stock",
  "description": "High-quality machine-woven carpet in blue tones...",
  "images": ["https://cdn.shopify.com/s/files/..."],
  "primaryImage": "https://cdn.shopify.com/s/files/...",
  "variants": [
    { "name": "Size", "values": ["80x150", "120x180", "160x230", "200x290"] }
  ],
  "productType": "Machine Carpet",
  "sku": "8917-MAVI",
  "metaTitle": "Hare Plus 8917 Mavi - Makine Halısı | Apex Hali",
  "metaDescription": "Buy Hare Plus 8917 Mavi...",
  "language": "en",
  "extractionConfidence": "high",
  "extractionConfidenceReason": "Product title, URL, price, and image all extracted successfully",
  "timestamp": "2026-04-18T01:00:00.000Z"
}

Example collection summary row:

{
  "type": "collection",
  "collectionName": "Machine Carpets",
  "collectionUrl": "https://www.apexhali.com/en/collections/machine-carpet",
  "productCountVisible": 24,
  "timestamp": "2026-04-18T01:00:00.000Z"
}

Error row (type: "__error__") and final summary row (type: "__summary__") are also pushed to the dataset.

➡️ Output is structured for pipelines, spreadsheet export, or direct use via the Apify API.

Use Cases

• 🛒 Carpet product research and catalog building
• 💰 Price monitoring and compare-at price tracking
• 📊 Market and competitor analysis across collections
• 📦 Inventory feed generation for internal systems
• 🤖 AI training data and product embedding pipelines
• 🔁 Scheduled catalog snapshots and change detection

Integrations & API

• Run and fetch results through the Apify API
• Use Python, Node.js, or HTTP clients against run and dataset endpoints
• Connect Zapier, Make, Google Sheets, and other Apify integrations
• Webhooks and schedules for recurring catalog monitoring runs

Why Choose This Actor?

• Scrapes the full public Apex Hali catalog — collections, products, and metadata in one run
• Multi-selector extraction with JS and og: fallbacks — resilient to minor theme changes
• Turkish Lira price normalization with numeric field for direct comparison
• Extraction confidence scoring so you always know how reliable each record is
• Three modes for full catalog export, targeted product scraping, or structure-only discovery
• Clean structured output ready for analytics, warehouses, or spreadsheet export

FAQ

How does Apex Hali Scraper work?

It opens apexhali.com in a headless Chrome browser, crawls category and collection pages to discover product links, then visits each product page and extracts all visible structured data using CSS selectors, JavaScript fallbacks, and Open Graph meta tags.

Can I scrape multiple collections in one run?

Yes. Add multiple collection URLs to startUrls, or leave it empty to start from the homepage and discover all collections automatically.

Do I need an Apex Hali account?

No. Only publicly visible pages are scraped — no login, cookies, or account credentials are required.

Why is a Turkish proxy recommended?

apexhali.com is a Turkish site. Using a Turkish (TR) residential proxy reduces the chance of geo-based blocks or captcha challenges.

Can I filter to specific product categories?

Yes. Use categoryFilters to restrict crawling to URLs or page titles containing your keywords (e.g. ["machine carpet", "bamboo"]).

What does extraction confidence mean?

Each product record carries extractionConfidence (high / medium / low) based on whether the title, URL, price, and image were all found. Low confidence means some fields are missing.

Can I scrape only specific product URLs?

Yes. Set mode to product_urls_only and put your product URLs in startUrls. No discovery crawl will run.

Can I monitor prices over time?

Yes. Schedule periodic runs, then compare priceNumeric values across datasets to detect changes.

What formats can I download?

JSON, CSV, and Excel from the Apify dataset UI, plus full access via the Apify API.

Is scraping apexhali.com legal?

Only publicly visible, non-authenticated catalog data is scraped. You are responsible for ensuring compliance with apexhali.com's terms of service and applicable local laws.

SEO Keywords

apex hali scraper apex hali product scraper apexhali.com scraper turkish carpet scraper carpet catalog scraper rug price scraper apify carpet scraper shopify catalog scraper halı fiyat scraper carpet product data extractor apexhali data export turkish rug catalog scraper

Actor permissions

This Actor is designed to work with limited permissions: it reads your input and writes to its default dataset only. It does not require access to other user storages, queues, or account data.

To set limited permissions in Apify Console:

1. Open your Actor on the Apify platform.
2. Go to Source or Settings.
3. Open Review permissions / Permissions.
4. Choose Limited permissions and save.

Limitations

• Apex Hali uses a Shopify-based theme; if CSS class names change, selector updates in main.py may be required.
• Some images and variant options are lazy-loaded; the scraper uses eager load strategy and explicit waits to capture them, but infinite-scroll catalogs may need additional JS scroll handling.
• Very high concurrency or frequent runs may trigger rate limiting — use residential proxies and keep maxConcurrency moderate (≤ 8).
• Only data visible on public pages without login is scraped.
• Turkish Lira price formats cover the most common patterns; unusual edge-case formats may require parser updates.

Future Roadmap

• Scheduled price monitoring with change-detection alerts
• Full variant enumeration by navigating option selectors
• Feed export to Google Sheets or Airtable
• Image download to Apify key-value store
• Improved handling of JS-rendered infinite scroll catalogs
• Collection hierarchy mapping (parent → child categories)
• Multi-language parallel runs (EN + TR comparison)

License

This project is licensed under the MIT License — see the LICENSE file for details.

Get Started

Add your Apex Hali collection or product URLs, enable a residential proxy for Turkey, and run your first catalog scrape on Apify today. 🚀