OrbTop

Yarnspirations Yarn & Pattern Catalog Scraper

ECOMMERCEFOR CREATORS

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.