ChicMe Scraper

Scrape ChicMe.com — a global budget fast-fashion storefront. Search products, browse any category with sorting, list all categories, or fetch full product detail by handle/URL. Get price, discount %, colors, sizes, stock status, images, tags and more. No login, no API key, no proxy required.

What this actor does

• Five modes: search, browseCollection, listCollections, byHandle, relatedProducts
• Search — quick free-text product search (top 10 matches)
• Browse a category — paginated, with 8 sort orders (price, newest, best-selling, title, featured)
• List categories — discover every category/collection on the storefront, with product counts
• Lookup by handle/URL — fetch full detail (all variants, all images, full description) for specific products
• Related products — "customers also viewed" recommendations for any product handle (up to 10 per handle)
• Search suggestions — every search run also returns related search terms and matching categories for the query, at no extra cost
• Category info — every browseCollection run also returns the category's own total product count, description and image, at no extra cost
• Filters: price range, in-stock only, on-sale only, minimum discount %, color, size, product type, tags
• Empty fields are omitted

Output per product

• productId, title, handle, productUrl
• vendor, productType, description, tags[]
• price, compareAtPrice, discountPercent, currency (USD)
• inStock (search, browseCollection, relatedProducts — omitted for byHandle, since ChicMe's single-product detail endpoint doesn't expose stock status)
• variants[] — each with variantId, title, sku, color, size, price, compareAtPrice, inStock (byHandle omits per-variant inStock too, same reason), imageUrl, weightGrams (shipping weight in grams)
• availableColors[], availableSizes[]
• imageUrl (primary), images[] (up to 10)
• publishedAt, createdAt, updatedAt
• sourceMode, recordType: "product", scrapedAt
• relatedToHandle (mode=relatedProducts only) — the product handle this recommendation was fetched for

Output per category (mode=listCollections)

• collectionId, title, handle, collectionUrl
• description, productsCount, imageUrl
• publishedAt, updatedAt
• recordType: "collection", scrapedAt

Search suggestions record (mode=search, one per run)

Alongside product results, every search run pushes one extra record with related search-term completions and matching categories for the query — useful for discovering better keywords or category handles, and returned even when the query itself has 0 product matches.

• searchQuery — the query you searched for
• relatedSearchTerms[] — ChicMe's own predictive "did you mean" / related terms for the query
• matchedCollections[] — categories matching the query, each with title, handle, collectionUrl
• recordType: "searchSuggestions", scrapedAt

Category info record (mode=browseCollection, one per run)

Every browseCollection run also pushes one extra record describing the category itself — its own title/description and the total number of products it contains storewide (productsCount), so you can tell at a glance how many products were emitted vs. how many exist in total.

• collectionId, title, handle, collectionUrl
• description, productsCount, imageUrl
• publishedAt, updatedAt
• recordType: "collectionInfo", scrapedAt

Input

Field	Type	Default	Description
mode	string	search	search / browseCollection / listCollections / byHandle / relatedProducts
searchQuery	string	summer dress	Free-text query (mode=search)
collectionHandle	select	dresses	Common category (mode=browseCollection)
customCollectionHandle	string	–	Overrides the dropdown with any handle/URL
sortBy	select	best-selling	Sort order within the category
productHandles	array	–	Product handles/URLs (mode=byHandle looks them up directly; mode=relatedProducts fetches recommendations for each)
priceMin	number	–	Drop products cheaper than this (USD)
priceMax	number	–	Drop products pricier than this (USD)
inStockOnly	bool	false	Only emit products with an available variant. Not usable with mode=byHandle — ChicMe's single-product detail endpoint doesn't report stock status, so this filter drops everything in that mode
onSaleOnly	bool	false	Only emit products genuinely marked down (discountPercent > 0)
discountMinPercent	number	–	Only emit products marked down by at least this % (e.g. 20)
color	string	–	Only emit products with a matching variant color (partial match, e.g. black)
size	string	–	Only emit products with a matching available size (exact match, e.g. M)
productType	select	–	Common garment style/cut, e.g. Bodycon, A Line, Blazer (not Dress, which is a category, not a style type)
productTypeContains	string	–	Free-text override for productType above (partial match) — use for a style not in the dropdown
tagsInclude	array	–	Only emit products carrying at least one of these tags
maxItems	int	50	Hard cap (1–1000)

Example: search

{
  "mode": "search",
  "searchQuery": "summer dress"
}

Example: browse a category, cheapest first

{
  "mode": "browseCollection",
  "collectionHandle": "bodycon-dresses",
  "sortBy": "price-ascending",
  "priceMax": 30,
  "inStockOnly": true,
  "maxItems": 100
}

Example: browse a category, filtered by color/size/tags

{
  "mode": "browseCollection",
  "collectionHandle": "dresses",
  "color": "black",
  "size": "M",
  "productTypeContains": "bodycon",
  "tagsInclude": ["Party"],
  "maxItems": 50
}

Example: discover every category

{
  "mode": "listCollections",
  "maxItems": 300
}

Example: full detail for specific products

{
  "mode": "byHandle",
  "productHandles": [
    "floral-print-u-neck-long-sleeve-ribbed-tee-slim-fit-layering-top",
    "https://www.chicme.com/products/zipper-knee-high-thin-heel-boots-pointed-toe-long-sexy-stiletto-heel"
  ]
}

Example: related products for a specific item

{
  "mode": "relatedProducts",
  "productHandles": [
    "floral-print-u-neck-long-sleeve-ribbed-tee-slim-fit-layering-top"
  ],
  "maxItems": 10
}

Use cases

• Price monitoring — track a category for price drops or restocks
• Trend research — see what's newly listed or best-selling in a category
• Catalog aggregation — pull ChicMe's product catalog into a comparison feed
• Assortment analysis — compare color/size availability across a category
• Content/affiliate sites — build "best deals" or "new arrivals" roundups

FAQ

Do I need a ChicMe account or API key? No. The actor reads ChicMe's public storefront data — no login, cookies, or API key are required.

Why is search capped at ~10 results? ChicMe's quick-search endpoint is a predictive/typeahead search and caps at 10 matches per query, regardless of how high maxItems is set. For deeper, paginated results use browseCollection instead — it returns the full category, sorted however you like.

How do I find more category handles? Run mode=listCollections first (optionally with a high maxItems) to get every category's handle, title, and productsCount, then feed a handle into customCollectionHandle.

What currency are prices in? USD.

What does discountPercent mean? The percentage off the list price (compareAtPrice), only included when the item is genuinely marked down.

Why do some products have no variants? search results are automatically enriched with a full product lookup so colors/sizes/variants match browseCollection and byHandle. A product only omits variants if it genuinely has no variant data on ChicMe (rare, single-SKU listings).

Can I filter by color, size, or tags? Yes — color and productType/productTypeContains do a case-insensitive partial match, size is an exact case-insensitive match, and tagsInclude matches if the product has any of the given tags. All four work identically across search, browseCollection, and byHandle.

What's the difference between productType and productTypeContains? productType is a dropdown of ChicMe's common garment styles (Bodycon, A Line, Blazer, Jumpsuit, etc.). productTypeContains is a free-text field that overrides the dropdown — use it for a style not yet in the list, or a broader partial match.

Can I get only discounted / on-sale items? Set onSaleOnly: true to only emit products with a genuine markdown (discountPercent > 0), or set discountMinPercent (e.g. 30) for a minimum markdown threshold, or point collectionHandle/customCollectionHandle at ChicMe's own sale categories (e.g. clearance-sale, last-chance-deals) and combine all three for the deepest discounts.

How fresh is the data? Real-time — every request reads ChicMe's live storefront.

What does mode=relatedProducts return? The same "customers also viewed" recommendations ChicMe shows on a product page, for each handle you supply. This is capped at 10 recommendations per handle by ChicMe itself, regardless of maxItems.

What's the searchSuggestions record I see in mode=search output? One extra record per run (not counted against maxItems) with related search terms and matching categories for your query — handy for widening a search or jumping straight to browseCollection with a discovered category handle.