Mood Fabrics Product Scraper

Scrape public Mood Fabrics products for catalog research, fabric sourcing, sewing workflows, price monitoring, and AI-agent product discovery. Pass a Mood Fabrics product URL, collection URL, or product search query and receive one stable JSON record per product.

The actor uses Mood Fabrics' public Shopify catalog endpoints. It does not log in, access customer accounts, add items to carts, place orders, or expose private Shopify data.

What it extracts

Field group	Included fields
Product identity	productId, title, url, handle, vendor, productType
Pricing and inventory	price, priceMin, priceMax, compareAtPrice, currency, available, priceVaries
Catalog content	description, tags, images, featuredImage, options
Fabric details	fabricContent, stretch, opacity, suggestedProjects, width, weight, care
Variants	id, title, sku, barcode, price, compareAtPrice, available, weightGrams, options
Provenance	sourceUrl, sourceMode, scrapedAt, warnings

Fabric attributes are parsed from labeled product-description bullets when Mood Fabrics provides them. Missing values are returned as null rather than guessed.

When to use it

Use this actor when you need public Mood Fabrics product data for:

• fabric and textile catalog exports;
• finding materials by query such as silk velvet, floral cotton, or sequined tulle;
• comparing prices, stock availability, and product variants;
• sourcing fabrics for apparel, costume, interiors, or sewing projects;
• monitoring a collection or selected product pages;
• feeding structured product data to an AI agent through Apify MCP.

Do not use it for general web search, other fabric retailers, customer orders, private inventory, checkout automation, or authenticated account data. For broad multi-store product research, use a multi-site ecommerce actor instead.

Input

The default input scrapes the full Mood Fabrics catalog with a 25-product cap:

{
  "startUrls": [
    { "url": "https://www.moodfabrics.com/collections/brocade-fashion-fabrics" },
    { "url": "https://www.moodfabrics.com/products/silk-velvet-red" }
  ],
  "searchQueries": ["floral cotton"],
  "maxResults": 25,
  "maxPages": 5,
  "enrichDetails": true,
  "includeVariants": true,
  "responseFormat": "detailed"
}

startUrls accepts public Mood Fabrics collection and product URLs, such as /collections/brocade-fashion-fabrics and /products/<handle>. A /search?type=product&q=... URL is also recognized and converted to a product search. searchQueries accepts one natural-language catalog query per item. When no source is supplied, the actor uses /collections/all-products.

maxResults is a hard cap across every source. maxPages limits collection pagination; each public Shopify collection page can return up to 250 products. Search suggestions are limited to the site's top results for each query. enrichDetails visits each product's public .js endpoint for richer data and falls back to listing/search data if an individual detail request fails. includeVariants can be disabled to reduce output size. responseFormat: "concise" bounds descriptions and omits variants while preserving the same stable top-level keys.

Output example

{
  "recordType": "product",
  "productId": "15637387575369",
  "title": "Metallic Polyester Brocade Panel - Beige, Gold and Silvery Gray Paint Splatters and Swirls - Deadstock",
  "url": "https://www.moodfabrics.com/products/metallic-polyester-brocade-panel-beige-gold-and-silvery-gray-paint-splatters-and-swirls-deadstock-447789",
  "productType": "BROCADES",
  "price": 49.96,
  "priceMin": 49.96,
  "priceMax": 49.96,
  "currency": "USD",
  "available": true,
  "fabricContent": "Polyester, Lurex",
  "stretch": "None",
  "opacity": "Mostly Opaque",
  "suggestedProjects": "Corsets, Gowns, Skirts, Jackets",
  "images": ["https://www.moodfabrics.com/cdn/shop/files/447789.jpg"],
  "variants": [{ "sku": "447789", "price": 49.96, "available": true }],
  "sourceMode": "collection",
  "warnings": []
}

Pricing

Event	Price
Actor start	$0.00005, scaled by allocated memory
Product record	$0.005 per schema-valid product returned

Examples: 1 product costs about $0.005, 25 products about $0.125, and 100 products about $0.50, plus the small Actor-start event and any Apify usage/proxy charges shown at run time. The actor prints the maximum result-event cost before work begins and enforces maxResults before another product charge.

API and MCP examples

JavaScript

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('YOUR_USERNAME/mood-fabrics-product-scraper').call({
  searchQueries: ['silk velvet'],
  maxResults: 10,
  responseFormat: 'concise'
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

Python

from apify_client import ApifyClient

client = ApifyClient('YOUR_APIFY_TOKEN')
run = client.actor('YOUR_USERNAME/mood-fabrics-product-scraper').call(run_input={
    'startUrls': [{'url': 'https://www.moodfabrics.com/collections/velvet'}],
    'maxResults': 20,
    'enrichDetails': True,
})
items = client.dataset(run['defaultDatasetId']).list_items().items
print(items)

For Apify MCP, configure https://mcp.apify.com/?tools=YOUR_USERNAME/mood-fabrics-product-scraper. The actor's tool description should be read as: “Scrape Mood Fabrics products from collection, product, or search URLs for fabric sourcing and catalog research. Do not use for other retailers or private account data. Returns product title, URL, type, price, availability, images, variants, and parsed fabric attributes. Charged $0.005 per product plus the small start event.”

Reliability and limits

The scraper uses public Shopify JSON endpoints with bounded retries, request timeouts, detail fallback, deduplication, partial-result preservation, and a hard product cap. If an individual detail call fails, collection or search data is retained with a warning. If every requested endpoint fails before any product is returned, the run fails honestly with a retry-oriented status message. A valid source that returns no products completes with a warning and an empty dataset.

Legal and responsible use

This actor is intended for publicly available catalog data and authorized research. Review Mood Fabrics' current Terms and Conditions, robots directives, copyright, database rights, and applicable laws before collecting, storing, republishing, or using the data commercially. Do not use this actor to bypass access controls, collect personal data, or automate purchasing.