🛍️ 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:

[
  {
    "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!