Shafa Product Search Scraper: Extract Fashion Listings at Scale

---

What Is Shafa.ua?

Shafa.ua is a leading Ukrainian online marketplace specializing in fashion, apparel, and lifestyle products. The platform aggregates listings from multiple sellers, offering everything from contemporary fashion to vintage and secondhand items. With millions of active listings, Shafa is a goldmine for fashion market data — but manually extracting product information across search results is inefficient. The Shafa Product Search Scraper automates this, transforming search pages into structured, analysis-ready datasets.

---

Overview

The Shafa Product Search Scraper extracts product listings directly from Shafa.ua search results pages, delivering comprehensive product metadata in a single run. It is built for:

• E-commerce analysts tracking competitor pricing and inventory
• Fashion retailers monitoring market trends and supply
• Price comparison platforms aggregating Ukrainian fashion data
• Researchers studying secondhand fashion markets
• Dropshippers and resellers identifying sourcing opportunities

Key features include configurable item limits per search page, resilient error handling via ignore_url_failures, and detailed product attributes including pricing, seller data, and customer engagement metrics.

---

Input Format

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

1. Scrape by URLs — scrape data directly from a list of Shafa.ua search result URLs.

{
  "urls": [
    "https://shafa.ua/uk/women?search_text=fitch&page=2"
  ],
  "ignore_url_failures": true,
  "max_items_per_url": 200
}

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

{
  "keyword": "a",
  "category": "cosmetics",
  "sort_by": "2",
  "price_min": "0",
  "price_max": "1000",
  "brand": "",
  "condition": "1",
  "gender": "",
  "color": "10",
  "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)	Search result page URLs from Shafa.ua to scrape. 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. Recommended for bulk jobs.

How to build URLs:

1. Visit Shafa.ua and select a category (e.g., /women, /men, /shoes)
2. Enter a search term and apply filters
3. Copy the full URL including query parameters (e.g., ?search_text=brand&page=1)
4. Add multiple URLs to scrape across different searches or pages

Tip: Use pagination (page=1, page=2, etc.) to collect data across multiple result pages in a single run.

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.
category	string	—	The product category to search in (e.g., women, men, kids, home, electronics, sport, brands, and more).
sort_by	string (1–4)	—	Sort results by Popularity (1), Price: Low to High (2), Price: High to Low (3), or Published date (4).
price_min	number	—	Minimum price to filter items by.
price_max	number	—	Maximum price to filter items by.
brand	string	—	Brand to filter items by, selected from a predefined list of supported brand IDs (e.g., Nike, Abercrombie & Fitch, Zara, Adidas, and hundreds more). Leave empty to search all brands.
condition	string (""–5)	—	Item condition: Any (empty), New (1), Ideal (2), Very Good (3), Good (4), Satisfactory (5).
gender	string ("", 2424, 2423, 2422)	—	Gender filter: Any (empty), Women (2424), Men (2423), Unisex (2422).
color	string ("", 1–32)	—	Item color, selected from a predefined list (e.g., White, Black, Red, Blue, Green, Beige, and more). Leave empty for any color.
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	200 (1–200)	Maximum number of products to extract per URL/search.

---

Output Format

Example output:

{
  "id": 212137874,
  "url": "/uk/women/rubashki-i-bluzy/bluzy/212137874-bluza-z-shtuchnogo-shovku-brendu-zara-women-zamiripog-60-sm-dovzhina",
  "thumbnail": "https://image-thumbs.shafastatic.net/2312059010_310_430",
  "name": "Блуза з штучного шовку бренду zara women .\nзаміри:пог-60 см, довжина виробу - 67 см, довжина рукава -57 см(рукав мишка)",
  "price": 199.0,
  "old_price": null,
  "status_title": "AVAILABLE",
  "discount_percent": null,
  "likes": 9,
  "is_liked": false,
  "brand": {
    "id": 183,
    "name": "ZARA",
    "__typename": "Brand"
  },
  "catalog_slug": "rubashki-i-bluzy/bluzy",
  "is_new": false,
  "sizes": [
    {
      "id": 833,
      "name": "S",
      "size_group": {
        "id": 40,
        "size_system_code": null,
        "__typename": "SizeGroup"
      },
      "__typename": "Size"
    },
    {
      "id": 834,
      "name": "M",
      "size_group": {
        "id": 40,
        "size_system_code": null,
        "__typename": "SizeGroup"
      },
      "__typename": "Size"
    }
  ],
  "size": "833",
  "sale_label": {
    "status": "SALE_NONE",
    "date": "2026-06-17",
    "price": "0",
    "__typename": "SaleLabel"
  },
  "seller": {
    "id": 10942612,
    "__typename": "User"
  },
  "free_delivery_services": null,
  "is_ukrainian": false,
  "owner_has_recent_activity": true,
  "tags": [],
  "rating": null,
  "rating_amount": null,
  "is_viewed": true,
  "created_at": "2026-06-16T16:50:09.035096+00:00",
  "selling_condition": "SALE",
  "collections_tags": [],
  "source_import": null,
  "price_variants": [
    {
      "id": null,
      "price": "199",
      "old_price": null,
      "discount_percent": null,
      "sale_label": {
        "status": "SALE_NONE",
        "date": "2026-06-17",
        "price": "0",
        "__typename": "SaleLabel"
      },
      "size": {
        "id": 833,
        "name": "S",
        "size_group": {
          "id": 40,
          "size_system_code": null,
          "__typename": "SizeGroup"
        },
        "__typename": "Size"
      },
      "__typename": "ProductVariantType"
    },
    {
      "id": null,
      "price": "199",
      "old_price": null,
      "discount_percent": null,
      "sale_label": {
        "status": "SALE_NONE",
        "date": "2026-06-17",
        "price": "0",
        "__typename": "SaleLabel"
      },
      "size": {
        "id": 834,
        "name": "M",
        "size_group": {
          "id": 40,
          "size_system_code": null,
          "__typename": "SizeGroup"
        },
        "__typename": "Size"
      },
      "__typename": "ProductVariantType"
    }
  ],
  "from_url": "https://shafa.ua/uk/women?page=2"
}

Each product extracted from Shafa search results returns a comprehensive record with 25+ fields:

Product Identification

Field	Meaning
ID	Unique product identifier in the Shafa system
URL	Direct link to the product detail page on Shafa.ua
Name	Product title as displayed in search results
Brand	Manufacturer or brand name (e.g., "Fitch", "Nike")

Pricing & Discounts

Field	Meaning
Price	Current selling price in UAH
Old Price	Original price before discount (if applicable)
Discount Percent	Percentage discount applied to the product
Status Title	Label indicating price status (e.g., "New Price", "Sale")
Price Variants	Alternative pricing for different sizes or options

Product Media & Visuals

Field	Meaning
Thumbnail	URL of the product's main image used in search results
Catalog Slug	URL-friendly category identifier (e.g., "women-clothing")

Seller & Sourcing Information

Field	Meaning
Seller	Name of the seller/vendor listing the product
Is Ukrainian	Boolean flag: true if seller is Ukrainian-based
Owner Has Recent Activity	Indicates whether the seller has recent marketplace activity
Free Delivery Services	Delivery options available for this listing
Source Import	Origin of the product (e.g., import country if applicable)

Product Attributes

Field	Meaning
Sizes	Available size options for the product (e.g., ["XS", "S", "M", "L"])
Size	Currently displayed or selected size
Is New	Boolean: true if product is brand-new condition
Selling Condition	Item condition (e.g., "New", "Like New", "Good", "Fair")

Customer Engagement & Popularity

Field	Meaning
Likes	Total number of user "likes" or favorites
Is Liked	Boolean: true if the current user has liked this product
Rating	Average product rating (typically 1–5 stars)
Rating Amount	Number of customer reviews contributing to the rating
Is Viewed	Boolean: true if the user has previously viewed this product

Categorization & Organization

Field	Meaning
Tags	Searchable tags assigned to the product (e.g., ["summer", "casual"])
Collections Tags	Curated collection or promotional groupings
Sale Label	Special promotional label if applicable (e.g., "Flash Sale")

Metadata & Timestamps

Field	Meaning
Created At	Date and time the listing was posted to Shafa

---

How to Use

1. Navigate Shafa.ua — Browse the marketplace and identify product categories or search terms of interest.
2. Prepare URLs — Run searches on Shafa (e.g., search "nike" in women's section), then copy the full URL including query parameters and page numbers.
3. Configure the scraper — Paste 1–10 URLs into the urls array. Set max_items_per_url to control data volume (typical: 50–200).
4. Set error handling — Keep ignore_url_failures: true to skip any problematic pages without interrupting the run.
5. Execute the scraper — Start the actor and monitor progress in the run log.
6. Download results — Export the dataset as JSON, CSV, or Excel for analysis in spreadsheets or databases.

Best practices:

• Use specific search terms to ensure relevant results (e.g., search_text=fitch&category=women)
• If scraping multiple pages, leverage pagination parameters in the URL
• Set realistic max_items_per_url limits — Shafa search pages typically return 50–100 items per page
• For large-scale runs (1000+ products), split URLs across multiple scraper runs

---

Use Cases & Business Value

• Price monitoring & intelligence: Track competitor pricing, discounts, and inventory turnover in the Ukrainian fashion market
• Market research: Analyze product trends, popular brands, and customer sentiment via ratings and tags
• Secondhand market analysis: Understand pricing of vintage or gently-used fashion items
• Reseller operations: Identify profitable sourcing opportunities with pricing and condition data
• Inventory benchmarking: Compare product availability and sizing options across sellers
• Promotional calendar: Identify seasonal trends and sale patterns based on discount data

The structured output enables seamless integration with BI tools (Tableau, Power BI), spreadsheet analysis, or custom Python scripts for deeper insights.

---

Conclusion

The Shafa Product Search Scraper is a powerful tool for anyone needing structured fashion product data from Ukraine's largest marketplace. With 25+ data points per product — from pricing and images to seller ratings and availability — this scraper transforms search results into actionable intelligence. Whether you're a market researcher, price comparison platform, or e-commerce business, this scraper saves time and unlocks competitive advantage in the Ukrainian fashion space.