🛍️ MUJI Product Data Scraper - EU

Download complete MUJI product catalogs from any MUJI country store!

Powerful web scraper that extracts comprehensive product data, pricing, and inventory information from MUJI's e-commerce sites worldwide. Get thousands of products with detailed specifications, images, and real-time availability - perfect for market research, price monitoring, and product analysis.

🚀 Key Features

• 🎯 Smart Category Targeting: Download specific product categories or entire catalogs using flexible pattern matching
• 📊 Rich Product Data: Extract detailed specifications, pricing, stock levels, images, and customer reviews
• 🌍 Multi-Country Support: Works with any MUJI country site - includes ready-to-use configurations for UK, Germany, and France. Automatically isolates data by country when switching between sites.
• 📈 Data Historization: Track price changes and product updates over time
• ⚡ Efficient Scraping: Built with Python and Apify for fast, reliable data extraction

Input Configuration

Field	Description	Example
URL	MUJI website URL to scrape	https://uk.muji.eu/
ALLOW_HISTORIZATION	Enable data versioning	true or false
DOWNLOAD_ONLY_CATEGORY_NAMES	Extract categories only (testing)	false
CATEGORY_NAMES_FOR_SCRAPING	Filter categories to scrape	men/*, women/clothing/*

Category Filtering

Use patterns to target specific categories:

• * - All categories (default)
• men/* - All men's products
• women/clothing/* - Women's clothing only
• men/clothing/*, women/accessories/* - Multiple categories

Patterns are case-insensitive and support wildcards (*). Leave empty to scrape all categories.

Country-Specific Configurations

Example Configurations

The scraper works with any MUJI country site. Below are tested configurations for popular European stores:

United Kingdom - uk.muji.eu

{
  "URL": "https://uk.muji.eu/",
  "ALLOW_HISTORIZATION": true,
  "DOWNLOAD_ONLY_CATEGORY_NAMES": false,
  "CATEGORY_NAMES_FOR_SCRAPING": "men/*"
}

Note: Do not use www. prefix for UK MUJI site - use https://uk.muji.eu/ directly.

France - france.muji.eu

{
  "URL": "https://france.muji.eu/",
  "ALLOW_HISTORIZATION": true,
  "DOWNLOAD_ONLY_CATEGORY_NAMES": false,
  "CATEGORY_NAMES_FOR_SCRAPING": "men/*"
}

Germany - germany.muji.eu

{
  "URL": "https://germany.muji.eu/",
  "ALLOW_HISTORIZATION": true,
  "DOWNLOAD_ONLY_CATEGORY_NAMES": false,
  "CATEGORY_NAMES_FOR_SCRAPING": "men/*"
}

Other Countries

The scraper supports any MUJI country website. Simply replace the URL with your target country's MUJI site:

• Italy: https://italy.muji.eu/
• Spain: https://spain.muji.eu/
• Netherlands: https://netherlands.muji.eu/
• Japan: https://www.muji.com/jp/
• US: https://www.muji.us/
• And many more...

Use the same configuration structure as the examples above, just change the URL field to your desired country's MUJI website.

Output Data Structure

Datasets Created

Dataset	Description	Key Fields
category-urls-all	Discovered category URLs from navigation	master_url, url, index, timestamp
products-category-page	Basic product data from category listings	product_id, name, price_amount, availability, categories
extended-products-data-all	Detailed product data from individual pages	options, html_description, specifications, images

Category URLs Structure

{
  "master_url": "https://france.muji.eu/",
  "url": "https://france.muji.eu/men/clothing/coats-and-jackets",
  "index": 1,
  "timestamp": "2026-02-27T15:46:22.540835"
}

Products Category Page Structure

{
  "product_id": 8885,
  "name": "Veste à capuche en polyester déperlante pour homme",
  "sku": "P-AD0X5-F-000000",
  "url": "https://france.muji.eu/products/mens-water-repellent-hooded-jacket-20408",
  "summary": "Cette veste pratique et fonctionnelle...",
  "availability": "",
  "stock_level": 3,
  "price_currency": "EUR",
  "price_amount": 54.95,
  "price_formatted": "54,95€",
  "is_on_sale": false,
  "main_image_url": "https://cdn11.bigcommerce.com/...",
  "categories": ["Homme", "Vêtements", "Vestes et manteaux"],
  "weight_value": 0.34,
  "rating": 0,
  "num_reviews": 0,
  "has_options": true,
  "scraped_at": "2026-02-27T15:46:23.673169",
  "master_url": "https://france.muji.eu/",
  "category_url": "https://france.muji.eu/men/clothing/coats-and-jackets",
  "custom_field_material": "100% polyester (résine polyuréthane utilisée au verso)",
  "custom_field_country_of_origin": "Viêt Nam"
}

Extended Products Data Structure

{
  "original_product_id": 8885,
  "original_name": "Veste à capuche en polyester déperlante pour homme",
  "original_sku": "P-AD0X5-F-000000",
  "product_url": "https://france.muji.eu/products/mens-water-repellent-hooded-jacket-20408",
  "category_url": "https://france.muji.eu/men/clothing/coats-and-jackets",
  "html_description": "Cette veste pratique et fonctionnelle...",
  "specifications": "Detailed product specifications and features...",
  "muji_price_data": {
    "with_tax": {
      "formatted": "54,95€",
      "value": 54.95,
      "currency": "EUR"
    }
  },
  "options": [
    {
      "display_name": "Couleur",
      "required": true,
      "values": [
        {
          "label": "Gris",
          "image": {"data": "https://cdn11.bigcommerce.com/..."}
        },
        {
          "label": "Noir", 
          "image": {"data": "https://cdn11.bigcommerce.com/..."}
        }
      ]
    },
    {
      "display_name": "Taille",
      "values": [{"label": "XS"}, {"label": "S"}, {"label": "M"}]
    }
  ]
}

Getting Started

Local Development

# Install dependencies
pip install -r requirements.txt

# Run locally
./local-run.sh

Deploy to Apify

# Login and deploy
apify login
apify push

Troubleshooting

Common Issues

• DNS Error: Check URL format - remove www. prefix for UK site
• No matches: Check category patterns match actual site structure
• Too many results: Use more specific patterns like men/clothing/* instead of men/*
• Mixed country data: The scraper automatically filters products by country - when switching from France to Germany, only German products will be processed for extended data

Datasets Created

Dataset	Description
category-urls-all	Navigation category URLs discovered from site structure
products-category-page	Product listings scraped from category pages
extended-products-data-all	Detailed product information from individual product pages