World Market Product Scraper

Scrape World Market (worldmarket.com) — the popular US home decor, furniture, and specialty international food retailer. Search by keyword, browse an entire department, or look up specific product pages, and get price, brand, item number, category, description, images, availability, and customer rating for every product. No login, cookies, or paid proxy required.

What this actor does

• Three modes: search (keyword), byCategory (browse a department), byProductUrls (direct lookup)
• 17 curated departments covering the whole catalog: furniture, decor, kitchen, dining, bath, food & drinks, gifts, and more
• Sort options: bestselling, new arrivals, rating, price low-to-high, price high-to-low
• Price range filtering on the final scraped price
• Multi-size / multi-color products: returns the lowest listed price plus the highest (priceMax) when a product has several variants
• Empty fields are omitted — every record only contains fields that were actually found

Output per product

• title — product name
• price — lowest current price across all variants (USD)
• priceMax — highest variant price, only present when a product has multiple sizes/colors at different prices
• currency — always USD
• brand
• itemNumber — World Market's internal item/SKU number
• category — full breadcrumb path (e.g. Furniture > Living Room Furniture > Sectionals)
• description
• imageUrls[] — up to 8 product images
• productUrl
• availability — In Stock, Out of Stock, Limited Availability, Preorder, or Sold Out
• variants[] — per-variant breakdown (color or size, whichever the product varies by), only present when a product has 2+ selectable variants: each entry has label, sku, price, and availability
• rating — average customer rating (1–5), only present when the product has reviews
• reviewCount — only present when the product has reviews
• recordType: "product", scrapedAt

Input

Field	Type	Default	Description
mode	string	search	search / byCategory / byProductUrls
searchQuery	string	candle	Free-text keyword (mode=search)
category	string	–	Department to browse (mode=byCategory) — see enum below
productUrls	array	–	Direct worldmarket.com product-page URLs (mode=byProductUrls)
sortBy	string	bestselling	bestselling / newArrivals / ratingHighToLow / priceLowToHigh / priceHighToLow
minPrice	int	–	Drop products priced below this amount (USD)
maxPrice	int	–	Drop products priced above this amount (USD)
maxItems	int	20	Hard cap on emitted products (1–200)

category accepts: bestSellers, bath, clothingAndJewelry, decorAndPillows, dining, foodAndDrinks, freeShipping, furniture, gifts, holidays, kitchen, lighting, newAndTrending, outdoor, rugs, sale, wallDecorAndMirrors.

Example: keyword search

{
  "mode": "search",
  "searchQuery": "dining chair",
  "sortBy": "ratingHighToLow",
  "maxItems": 30
}

Example: browse a department with a price range

{
  "mode": "byCategory",
  "category": "kitchen",
  "sortBy": "priceLowToHigh",
  "minPrice": 10,
  "maxPrice": 50,
  "maxItems": 50
}

Example: look up specific products

{
  "mode": "byProductUrls",
  "productUrls": [
    "https://www.worldmarket.com/p/apothecary-lavender-tonic-scented-candle-128547.html"
  ]
}

Example: browsing food & drinks for gifting

{
  "mode": "byCategory",
  "category": "foodAndDrinks",
  "sortBy": "bestselling",
  "maxItems": 40
}

Use cases

• Price monitoring — track World Market prices for competitive intelligence
• Catalog enrichment — pull structured product data (brand, category, images) into a PIM
• Market research — analyze best-selling home decor and specialty food trends
• Deal alerts — combine sortBy: priceLowToHigh with minPrice/maxPrice to spot bargains
• Affiliate content — build gift guides and roundups sourced from real, live product data
• Inventory / availability tracking — monitor availability for specific items over time

FAQ

Is this affiliated with World Market / Cost Plus World Market? No. This is an independent, third-party actor that reads the same public pages any shopper's browser sees. It is not affiliated with, endorsed by, or connected to World Market.

Do I need to log in or provide cookies? No. World Market publishes full product data (including price) on public pages without requiring an account.

Why do some products show a priceMax and others don't? World Market sells many products in multiple sizes or colors at different price points. price is always the lowest available price; priceMax is only included when a higher-priced variant exists.

Why don't all products have a rating or reviewCount? Those fields are only included for products that have at least one customer review. Newer or niche items may not have any yet, and the field is omitted rather than showing a fake 0. Ratings are read directly off the product detail page, so they're populated in every mode, including byProductUrls.

How many products can I scrape in one run? Up to 200 per run via maxItems. For larger catalogs, run the actor multiple times with different category or searchQuery values.

Does byCategory cover every sub-category? It covers World Market's 17 top-level departments, which together span the full catalog. For a narrower slice, combine a department with searchQuery-style filtering downstream, or use byProductUrls for specific items.

How fresh is the data? Every run fetches live pages directly from worldmarket.com — there is no caching, so prices and availability reflect the current listing at run time.