🛍️ Faire Product Scraper This actor allows you to scrape wholesale products from Faire.com by providing a search URL. It automatically handles pagination and extracts comprehensive product information including images, brands, ratings, and review counts. ## Features - URL-based Scraping: Extract products by providing a complete Faire search URL - Automatic Pagination: Automatically loads more products until reaching the end or max items limit - Comprehensive Product Data: Extract detailed information including: - Product names and images - Direct links to product detail pages - Brand names and brand profile links - Product ratings and review counts - Smart Deduplication: Automatically removes duplicate products - Proxy Support: Optional proxy configuration for reliable scraping ## Input Parameters | Field | Type | Required | Description | |----------------------|---------|----------|------------------------------------------------| | searchUrl | string | Yes | Complete Faire search URL to scrape | | maxItems | integer | No | Maximum number of products to fetch (default: unlimited) | | proxyConfiguration | object | No | Proxy settings for the actor | ### How to Get Search URL 1. Go to Faire.com 2. Use the search bar to find products or browse categories 3. Apply any filters you need (brand, price, rating, etc.) 4. Copy the complete URL from your browser's address bar 5. Paste it into the searchUrl field Example search URL: https://www.faire.com/search?q=iron+on+patches&refReqId=vdeqszna67g3cw5shm8a747yg&refType=SUGGESTIONS_SEARCH_QUERIES ## Output The output is a dataset of product objects, each containing: - searchUrl: The original search URL used - productName: Product name - imageUrl: URL of the product image - detailUrl: Direct link to the product detail page - brandName: Name of the brand/maker - brandUrl: Link to the brand's profile page - rating: Product rating (e.g., "5.0") - reviewCount: Number of customer reviews - scrapedAt: Timestamp of when the product was scraped Example output: json [ { "searchUrl": "https://www.faire.com/search?q=iron+on+patches", "productName": "Wild Child Iron On Patch", "imageUrl": "https://cdn.faire.com/fastly/356717e79b1fde0429dca8ca1998446be957e3f1af52794c1a06f9417859716f.jpeg", "detailUrl": "https://www.faire.com/search?brand=b_xzn3nr7cjg&product=p_vd4z237w6q", "brandName": "Kosmic Soul", "brandUrl": "https://www.faire.com/brand/b_xzn3nr7cjg", "rating": "5.0", "reviewCount": "42", "scrapedAt": "2025-11-08T01:09:06.251Z" }, ... ] ## Use Cases - Wholesale product sourcing and discovery - Market research and competitor analysis - Price comparison across brands - Brand performance analysis - Product catalog building - Trend identification in wholesale markets - Supplier discovery and evaluation ## Notes - Works with all Faire.com search results and categories - Results are saved incrementally as they are found - All timestamps are in ISO 8601 format - Rating is provided as a decimal string (e.g., "5.0") - Review count shows the total number of reviews - Proxy configuration is optional but recommended for large scraping jobs --- Start discovering wholesale products on Faire today!