Replacements Ltd Scraper

Scrape Replacements, Ltd. — the world's largest source of discontinued and active china, crystal, silver/flatware, and collectibles patterns. Search by keyword, look up products by ID, pull every piece in a specific pattern, list a brand's full catalog, or browse the brand/pattern taxonomy of a category. HTTP-only with Chrome TLS impersonation. No auth, no proxy, no login.

What this actor does

• Search — free-text keyword search across the whole catalog (patterns, brands, piece types)
• Direct lookup — fetch specific products by ID or URL
• Pattern browsing — every piece available in a specific china/crystal/silver/collectibles pattern
• Brand browsing — a brand's entire catalog across all its patterns
• Taxonomy discovery — list every brand or every popular pattern in a category
• Filters: price range, in-stock only
• Product images are re-hosted to a permanent, publicly-reachable URL
• Empty fields are omitted

Output per product

• productId, name, description
• brand, manufacturer
• category — China / Crystal / Silver / Collectibles
• patternName, itemLabel (piece type, e.g. "Dinner Plate")
• price, priceCurrency, priceValidUntil (only for in-stock items with a real price)
• condition — e.g. Used
• availability — InStock / OutOfStock
• dimensions — e.g. 10 1/2 in
• imageUrl (permanently re-hosted), imageUrlOriginal
• productUrl, sourceUrl
• breadcrumb[] — full category → brand → pattern → item path
• recordType: "product", scrapedAt

Output per brand (browseBrands mode)

• brandName, brandUrl, category, recordType: "brand", scrapedAt

Output per pattern (browsePatterns mode)

• patternName, patternUrl, brandName (when known), category, recordType: "pattern", scrapedAt

Input

Field	Type	Default	Description
mode	string	search	search / byProductIds / byPatternUrls / byBrand / browseBrands / browsePatterns
searchQuery	string	lenox	Free-text query (mode=search)
productIds	array	[]	Numeric product IDs or product URLs (mode=byProductIds)
patternUrls	array	[]	Full pattern page URLs (mode=byPatternUrls)
category	string	collectibles	china / crystal / silver / collectibles (mode=byBrand, browseBrands, browsePatterns)
brandName	string	Lladro	Brand name, fuzzy-matched (required for byBrand; optional for browsePatterns)
priceMin	int	–	Drop products priced below this (USD)
priceMax	int	–	Drop products priced above this (USD)
inStockOnly	bool	false	Only emit in-stock products with a real price
maxItems	int	20	Hard cap (1–1000)

Example: search by keyword

{
  "mode": "search",
  "searchQuery": "blue willow",
  "inStockOnly": true,
  "maxItems": 50
}

Example: every piece in a specific pattern

{
  "mode": "byPatternUrls",
  "patternUrls": ["https://www.replacements.com/china-spode-christmas-tree/c/95690"],
  "maxItems": 100
}

Example: a brand's full catalog

{
  "mode": "byBrand",
  "category": "collectibles",
  "brandName": "Lladro",
  "priceMax": 500,
  "maxItems": 100
}

Example: list every brand in a category

{
  "mode": "browseBrands",
  "category": "china",
  "maxItems": 100
}

Example: list a category's most popular patterns

{
  "mode": "browsePatterns",
  "category": "collectibles",
  "maxItems": 50
}

Example: direct product lookup

{
  "mode": "byProductIds",
  "productIds": ["102826601", "https://www.replacements.com/p/64494561"]
}

Use cases

• Collector research — identify and price a discontinued china, crystal, or silver pattern
• Estate & inheritance appraisal — value inherited tableware and collectibles sets
• Price-guide / market research — track real asking prices across brands and patterns
• Antiques dealer sourcing — discover available inventory for a specific brand or pattern
• Insurance appraisal — document replacement value for scheduled personal property
• Collectibles cataloging — bulk-export a brand's figurine/ornament catalog (Lladro, Hummel, Department 56, etc.)

FAQ

Do I need an account or cookies? No. Replacements.com is fully public — no login, no API key, no proxy required.

What's the difference between byBrand and browsePatterns with a brandName? byBrand returns actual products (with price, condition, images) across every pattern the brand makes. browsePatterns with a brandName returns just the pattern list itself (name + URL) — useful for discovery before deciding which pattern to pull products from.

Why does silver category have no browsePatterns without a brand? Replacements.com's own site structure doesn't expose a combined "most popular patterns" page for the general silver category (it splits sterling vs. stainless flatware differently). Supply brandName for silver — byBrand/browsePatterns with a brand both work normally.

What happens if I search for an exact brand name (e.g. "Royal Doulton")? The site itself redirects an exact brand match to a brand landing page instead of a flat product list. The actor detects this automatically and pulls products from that brand's first few patterns so you still get real results — or use mode=byBrand directly for the brand's full catalog.

Why are some products missing a price? Only in-stock items have a real price on Replacements.com. Out-of-stock items are still returned (unless inStockOnly=true) but the price field is omitted rather than shown as $0.

What does condition: "Used" mean? Replacements.com sources most inventory as pre-owned/estate pieces, so nearly all listings carry a "Used" condition regardless of physical wear — this reflects the site's own listing data, not a quality assessment.

How fresh is the data? Real-time — every run fetches live pages directly from replacements.com.

Can I combine filters? Yes — priceMin/priceMax/inStockOnly all apply together across every mode that returns products.

Why do some imageUrl values point to images.replacements.com instead of a re-hosted URL? The actor always tries to re-host each product image to a permanent, publicly-reachable URL. That succeeds most of the time, but Replacements.com's image CDN is protected by the same bot-management as the rest of the site, and it occasionally rejects the re-host attempt from cloud infrastructure. When that happens, the actor falls back to the original images.replacements.com URL — which is a real, correct image that opens normally in any web browser; it just isn't always fetchable by an automated/server-side HTTP request.