Yarnspirations Yarn & Pattern Catalog Scraper

Scrapes the complete Yarnspirations product catalog — yarns, free patterns, and tools — from the public Shopify storefront API. Covers all five major brands: Red Heart, Bernat, Caron, Patons, and Lily Sugar'n Cream.

No authentication required. Returns structured product data including type, brand, price, availability, SKU, craft type, and direct image and product page URLs.

What you get

Each record in the output dataset includes:

Field	Description
product_id	Shopify product ID
title	Product title
handle	URL-friendly product slug
product_type	Yarn, Pattern, Tool, Bundle, etc.
brand	Brand name (Red Heart, Bernat, Caron, Patons, Lily Sugar'n Cream)
vendor	Vendor name (same as brand on Yarnspirations)
tags	Shopify product tags array
price_usd	Price in USD (0 for free patterns)
available	Whether any variant is currently in stock
sku	Primary variant SKU
is_free_pattern	True when the product is a free downloadable pattern
craft_type	knit or crochet (parsed from tags)
image_url	Primary product image URL
product_url	Full URL to the product page

Note on spec fields: fiber_content, yarn_weight, yardage, gauge, needle_hook_size, care_instructions, and skill_level are rendered from Shopify metafields on individual product pages and are not available in the storefront API. These fields are returned as empty strings.

How it works

The actor paginates through https://www.yarnspirations.com/products.json?limit=250&page=N, retrieving up to 250 products per page. It stops automatically when the API returns an empty page. The full catalog contains approximately 12,000–13,000 products across 52 pages.

No proxy is required. The Shopify storefront API is publicly accessible with no authentication, geo-restrictions, or rate-limit enforcement beyond the ~2 requests/second safe limit (the actor uses a 600ms delay between pages).

Input

Parameter	Type	Default	Description
maxItems	integer	15	Maximum number of products to scrape. Leave empty or set to a high number to scrape the full catalog.

Example input to scrape the full catalog:

{
  "maxItems": 20000
}

Example input to scrape a sample of 50 products:

{
  "maxItems": 50
}

Use cases

• Price tracking — Monitor yarn prices across all Yarnspirations brands
• Catalog synchronization — Keep an up-to-date inventory of available products
• Pattern catalog — Extract all free patterns by craft type (knit vs crochet)
• Brand analysis — Compare product counts and availability across Red Heart, Bernat, Caron, Patons, and Lily Sugar'n Cream
• Craft supply reseller data — Structured catalog for resellers or price comparison tools

Coverage

The actor covers the entire yarnspirations.com product catalog, which includes products from the Yarnspirations family of brands operated by Spinrite Inc.:

• Red Heart — America's best-known yarn brand
• Bernat — Blanket, baby, and specialty yarns
• Caron — Fashion and everyday yarns
• Patons — Premium knitting and crochet yarns
• Lily Sugar'n Cream — Cotton kitchen and craft yarns

Performance

A full catalog run (~12,500 products, 52 pages) completes in approximately 35–40 seconds at the default 600ms page delay. Memory usage stays well under 256 MB.