Flaconi Beauty Products Scraper: Search Results Extraction at Scale

---

What Is Flaconi?

Flaconi is a leading European e-commerce platform specializing in beauty, cosmetics, and personal care products. Operating across multiple German-speaking markets (Austria, Germany, and beyond), Flaconi aggregates thousands of SKUs from luxury and mainstream beauty brands. For market researchers, competitors, and aggregator platforms, manually tracking product availability, variants, and pricing across Flaconi's catalog is impractical — the Flaconi Products Search Scraper automates this entirely, delivering structured product data from search results in seconds.

---

Overview

The Flaconi Products Search Scraper extracts product listings from Flaconi search result pages, converting unstructured e-commerce content into clean, machine-readable records. It captures product identifiers, variant information, color options, and pricing data — everything needed for price monitoring, competitive analysis, or product catalog aggregation.

Ideal for:

• Price aggregators comparing cosmetics across retailers
• Dropshippers & resellers sourcing product feeds
• Market researchers studying beauty product trends and availability
• Developers building beauty product databases or recommendation engines
• Retailers monitoring competitor product launches and pricing strategies

Key advantages include bulk URL processing, configurable item limits, and error resilience via ignore_url_failures — essential for large-scale scraping campaigns.

---

Input Format

The Actor supports two scraping modes — use only one at a time:

1. Scrape by URLs — scrape data directly from a list of Flaconi search result page URLs.

{
  "urls": [
    "https://www.flaconi.at/search/?offset=48&q=lip",
    "https://www.flaconi.de/search/?offset=0&q=foundation"
  ],
  "max_items_per_url": 200,
  "ignore_url_failures": true
}

2. Scrape by search filters — scrape data using a keyword and additional filters (region, gender, color, price range, etc.) instead of providing URLs.

{
  "region": "de",
  "keyword": "lip",
  "gender": "Unisex",
  "color": "Gold",
  "price_range": "19900,100500",
  "sort_by": "variants.scopedPrice.value.centAmount",
  "page": 1,
  "max_items_per_url": 200
}

There is also a General settings group that applies to both modes.

1. Scrape by URLs

Use this mode when you already have specific search result URLs. When this mode is used, all options in the "Scrape by search filters" section will be disabled.

Field	Type	Default	Description
urls	array	(required)	Direct links to Flaconi search result pages. You can paste URLs one by one, or use the Bulk edit section to add a prepared list.
ignore_url_failures	boolean	true	If true, the scraper continues running when a URL fails instead of stopping the entire run. If false, it stops on the first error. Recommended true for bulk jobs.

How to Build Search URLs

Flaconi search URLs follow this pattern:

https://www.flaconi.at/search/?q=KEYWORD&offset=OFFSET

• q parameter: Product search term (e.g., q=lip%20balm, q=foundation)
• offset parameter: Pagination position (e.g., offset=0, offset=48) — increment by 48 for each page
• Country domain: Use .at for Austria, .de for Germany, .it for Italy, etc.

Tip: Build multiple URLs with different keywords and offsets to cover your target product range (e.g., "mascara", "foundation", "skincare").

2. Scrape by search filters

Use this mode when you want to search using a keyword and additional filter attributes instead of scraping by URLs. If you use this mode, leave the urls field above empty.

Field	Type	Default	Description
keyword	string	—	The keyword to search for.
region	string (at, de)	—	The region/store to search in: Austria (at) or Germany (de).
sort_by	string ("", variants.scopedPrice.value.centAmount, createdAt)	—	Sort results by Relevance (empty), Price, or Published date.
gender	string ("", Frauen, Unisex, Herren)	—	Filter by gender: All (empty), Women, Unisex, Men.
color	string	—	Filter by product color. One of: Black, White, Transparent, Blue, Gold, Pink, Green, Brown, Beige, Red, Violet, Silver, Orange, Yellow, Grey (leave empty for all).
price_range	string	—	Price range filter in min,max format, e.g. 10,20.
page	integer	—	The page number to start scraping from.

3. General settings

Applies to both scraping modes above.

Field	Type	Default	Description
max_items_per_url	integer	20	Maximum number of products to extract per URL/search (1–200). Increase for broader datasets.
proxy	object	Apify Proxy, RESIDENTIAL group, country US	Proxy configuration used by the scraper. Defaults to Apify Proxy with residential IPs.

---

Output Format

Sample Output Record

{
  "product_id": "d3feac4f-6973-459e-b24e-c446ee533b81",
  "name": "MAC MACXimal Matte Lipstick Mini Lippenstift",
  "slug": "make-up/mac/macximal/mac-macximal-matte-lipstick-mini-lippenstift",
  "variants": [
    {
      "sku": "90007058-0010710",
      "price": 1275,
      "attributes": {
        "series": "MACXimal",
        "sub_series": "Matte Lipstick Mini",
        "brand": "MAC",
        "fl_product_type": "Lippenstift",
        "size": 1.7,
        "unit": {
          "label": "g"
        },
        "display_base_unit": {
          "label": "g"
        },
        "exclusive": false,
        "base_amount": 10,
        "display_base_amount": 10
      },
      "images": [
        "https://cdn.flaconi.at/media/catalog/product/7/7/773602697113.jpg?r=1Sj8Cb"
      ],
      "is_on_stock": true,
      "key": "90007058-C",
      "stock_amount": 0,
      "is_new": false,
      "is_limited": false,
      "is_sustainable": false,
      "price_info": {
        "discount_percentage": 0.29,
        "price_per_size_amount": 7500,
        "base_price": 1800,
        "is_special_price": false,
        "is_on_sale": true,
        "reference_price": 1230,
        "reference_price_percentage": "3.66",
        "reference_price_discount_amount": -45
      }
    }
  ],
  "key": "90007058-C",
  "variant_count": 7,
  "make_up_color_option_list": [
    {
      "hex_code": "#890c23",
      "makeup_color": "Ruby Woo"
    },
    {
      "hex_code": "#844d44",
      "makeup_color": "Warm Teddy"
    },
    {
      "hex_code": "#985c5f",
      "makeup_color": "Mehr"
    },
    {
      "hex_code": "#8a2d1f",
      "makeup_color": "Chili"
    },
    {
      "hex_code": "#561c24",
      "makeup_color": "Diva"
    },
    {
      "hex_code": "#90504a",
      "makeup_color": "Velvet Teddy"
    },
    {
      "hex_code": "#773673",
      "makeup_color": "Everybody´s Heronie"
    }
  ],
  "price_variant": "90007058-0010710",
  "from_url": "https://www.flaconi.at/search/?offset=48&q=lip&ajax=true"
}

Each product record contains 8 fields capturing essential product and variant information:

Core Product Information

Field	Data Type	Description	Example
Product ID	String/Number	Unique identifier for the product in Flaconi's system	"12345678"
Name	String	Product name/title as displayed on Flaconi	"MAC Fix+" or "Charlotte Tilbury Magic Cream"
Slug	String	URL-friendly identifier; used in product detail page URLs	"mac-fix-plus"

Variant & Color Data

Field	Data Type	Description	Example
Variants	Array	List of available product variants (e.g., sizes, quantities, formulas)	["30ml", "100ml", "Travel Size"]
Variant Count	Integer	Total number of variant options for this product	3
Key	String	Internal variant key or SKU identifier	"MAC_FIX_PLUS_30ML"
Make Up Color Option List	Array	Available colors/shades if the product is makeup or color-dependent	["Fair", "Light", "Medium", "Deep"] or ["Rose Gold", "Warm Bronze"]
Price Variant	Object/Array	Pricing data segmented by variant; typically includes base price and currency	{"30ml": {"price": 24.99, "currency": "EUR"}, "100ml": {"price": 44.99, "currency": "EUR"}}

---

How to Use

Step 1: Identify Search Terms

Determine which product categories or keywords you want to track (e.g., "lipstick", "sunscreen", "foundation"). You can add one search URL per keyword or paginate across results.

Step 2: Build Your URLs

For each keyword, construct Flaconi search URLs:

• Start with offset=0
• Increment by 48 for each subsequent page
• Example: https://www.flaconi.at/search/?q=mascara&offset=0, then offset=48, then offset=96, etc.

Step 3: Configure Input

Paste your URLs into the urls array, set max_items_per_url to your desired limit (typically 50–200), and enable ignore_url_failures for robustness.

Step 4: Run the Scraper

Start the actor and monitor progress. The scraper will process each URL and return product records.

Step 5: Export & Analyze

Download results as JSON, CSV, or Excel. Import into your database, price comparison tool, or analytics platform.

Best Practices

• Pagination: If you need all results from a category, create multiple URLs with offset=0, 48, 96, etc.
• Rate limiting: Space out large runs to avoid overwhelming Flaconi's servers.
• Keyword variety: Mix specific searches (e.g., "MAC mascara") with broad ones (e.g., "mascara") to capture diverse product ranges.
• Regular runs: Re-scrape periodically to track price changes and new product launches.

Troubleshooting Common Issues

Issue	Solution
URL returns no products	Verify the search term is correct and products exist on Flaconi; check the domain (.at vs .de)
High variant count but no prices	Some products may have limited pricing data; filter if needed in post-processing
Timeouts on large batches	Reduce max_items_per_url or split URLs into smaller runs

---

Use Cases & Business Value

Price Monitoring & Competitive Analysis

Track competitor pricing across beauty product lines. Monitor how prices fluctuate across regions (Austria vs. Germany) and seasons (e.g., holiday promotions).

Product Feed Aggregation

Feed Flaconi product data into your own beauty product database or e-commerce catalog. Enrich your platform with real-time color/variant information.

Market Research & Trend Analysis

Analyze which beauty brands, categories, and price points dominate Flaconi's inventory. Identify emerging product trends and fast-movers.

Dropshipping & Reseller Operations

Build your sourcing list with live Flaconi inventory, variants, and pricing. Identify high-margin or fast-turning products.

SEO & Content Creation

Harvest product names, descriptions (via additional scraper configuration), and color options for beauty blog content, guides, and product comparison articles.

The Flaconi Products Search Scraper eliminates hours of manual browsing and copy-pasting, delivering production-ready data that drives smarter business decisions.

---

Conclusion

The Flaconi Products Search Scraper is an essential tool for anyone operating in the beauty e-commerce ecosystem. Whether you're aggregating prices, monitoring competitors, or building product databases, this scraper delivers reliable, structured data from Flaconi.at and Flaconi.de at scale. Configure your search terms, set your parameters, and start collecting actionable product intelligence instantly.