Faire Product Scraper: Collect Wholesale Product Data Instantly

---

What Is Faire.com?

Faire.com is a B2B wholesale marketplace connecting independent retailers with brands and makers. With millions of products across categories like Food & Drink, Home Décor, Fashion, and Beauty, Faire serves as a critical sourcing platform for retail businesses worldwide. Manually searching and collecting product data is inefficient — the Faire Product Scraper automates extraction, delivering structured product records ready for analysis and integration.

---

Overview

The Faire Product Scraper extracts product listings from Faire search results and category pages, collecting 14+ fields per item including pricing, images, brand metadata, and promotional indicators. It is ideal for:

• Retail buyers sourcing new products and comparing suppliers
• Market researchers analyzing wholesale pricing trends and product categories
• Competitor analysts monitoring product assortments and promotional activity
• E-commerce developers building product databases and catalog integrations
• Dropshippers identifying trending wholesale items

Key features include configurable item limits per URL, image collection, promotional status tracking, and error tolerance via ignore_url_failures.

---

Input Format

The scraper accepts a JSON configuration with three main parameters:

{
  "urls": [
    "https://www.faire.com/category/Food%20&%20Drink/subcategory/Coffee%20&%20Tea?page=2"
  ],
  "ignore_url_failures": true,
  "max_items_per_url": 200
}

Input Parameters Explained

Parameter	Type	Description
urls	Array of strings	Direct links to Faire category pages, search results, or product listings. Support pagination via URL parameters (e.g., ?page=2). Can include single product URLs or category/subcategory pages.
ignore_url_failures	Boolean	Default: true. If true, the scraper continues running if certain URLs fail to load. If false, a single failed URL stops the entire run. Recommended: true for bulk operations.
max_items_per_url	Integer	Maximum number of products to extract per URL (e.g., 200). Limits data volume and run time. Adjust based on your needs; higher values collect more items but increase execution time.

Best practices:

• Use category or search URLs (e.g., https://www.faire.com/category/Food%20&%20Drink) to capture multiple products per page
• Include pagination parameters (e.g., ?page=1, ?page=2) to target specific result sets
• Set max_items_per_url conservatively (20–100) for fast feedback; increase to 200+ for comprehensive data collection

---

Output Format

Example Output

{
  "product": {
    "token": "p_998taj5mfh",
    "name": "Organic Peach Sparkling Yerba Mate Energy Tea – 12-pack Cans",
    "brand_token": "b_bekvsvuuz0",
    "is_new": false,
    "maker_best_seller": true,
    "per_style_min_order_quantity": 0,
    "expected_ship_window_days": 0,
    "state": "FOR_SALE",
    "preorderable": false,
    "is_promoted": false,
    "impression_id": "1783309207_m4m7dfcyfbpxrks",
    "avg_brand_review_rating": "4.9",
    "brand_review_count": 33,
    "board_tokens": [],
    "promoted_by": []
  },
  "badge_list": {
    "badges": [
      {
        "priority": 5,
        "type": "FAIRE_BESTSELLER",
        "display_to_user": true,
        "style": {
          "badge_message": "Bestseller",
          "alt_text": "Bestseller",
          "text_color": "CORE_TEXT_PRIMARY",
          "background_color": "CORE_TEXT_PRIMARY_INVERSE",
          "responsive_badge_message": {
            "mobile_and_above": "Bestseller"
          }
        },
        "xp_settings": []
      }
    ],
    "badge_xp_settings": []
  },
  "best_image": {
    "token": "i_ep4dhjyb7x",
    "width": 4000,
    "height": 4000,
    "sequence": 0,
    "url": "https://cdn.faire.com/fastly/54fc49cd97dafd7240511af7dc41ecf6760353916fb876d5174bf53b791d6dc9.png",
    "type": "HERO",
    "optimized_url": "https://cdn.faire.com/fastly/54fc49cd97dafd7240511af7dc41ecf6760353916fb876d5174bf53b791d6dc9.png?format=jpg",
    "tags": [
      "Hero",
      "fastly_3x4:{\"preCrop\":\"95.79p,100p,x0.75p,y0p\",\"canvas\":\"100p,127.72p,offset-x50p,offset-y58.8p\",\"bgColor\":\"FFFFFF\",\"modelVersion\":\"FOCUS_V2\"}"
    ],
    "crop_parameters": []
  },
  "min_option_retail_price": {
    "amount_cents": 3695,
    "currency": "USD"
  },
  "has_active_brand_promo": false,
  "is_highlighted_product_for_promotional_event": false,
  "based_in_country": "USA",
  "options_details": null,
  "container_style": "DEFAULT",
  "quick_add_display_type": "PERSISTENT",
  "images": [],
  "settings_to_assign_on_view": [
    "IMAGE_OVERLAY_OPACITY_251230",
    "SEARCH_UX_FIND_SIMILAR_PRODUCTS_260119"
  ],
  "pos_insights": [],
  "brand": {
    "token": "b_bekvsvuuz0",
    "name": "CLEAN Cause",
    "insider_benefits": {
      "discount_percentage": 0,
      "benefits": []
    },
    "forbids_online_only_retailers": true,
    "forbids_business_use_buyers": false,
    "minimum_order_amount": {
      "amount_cents": 0,
      "currency": "USD"
    },
    "ships_from_country": "USA",
    "based_in": "USA",
    "is_highlighted_brand_for_promotional_event": false,
    "is_top_shop": false,
    "active_products_count": 15,
    "based_in_country_message": {
      "desktop_message": "United States",
      "mobile_message": "United States"
    },
    "profile_image": {
      "token": "i_epzpxrpu39",
      "width": 1500,
      "height": 1500,
      "sequence": 0,
      "url": "https://cdn.faire.com/fastly/db0ac49d6704bfbe0507c69119552c9f8f7da566b8fd7d3cf0d1a1d00d34b35a.jpeg",
      "optimized_url": "https://cdn.faire.com/fastly/db0ac49d6704bfbe0507c69119552c9f8f7da566b8fd7d3cf0d1a1d00d34b35a.jpeg?format=jpg",
      "tags": [],
      "crop_parameters": []
    },
    "squared_image": {
      "token": "i_e8gcx85bd8",
      "width": 4123,
      "height": 2749,
      "sequence": 0,
      "url": "https://cdn.faire.com/fastly/8dc9efdfe82c25c94c83dcdd0dfbe94a01139915b0ace41d3e6b497c13171eb8.jpeg",
      "optimized_url": "https://cdn.faire.com/fastly/8dc9efdfe82c25c94c83dcdd0dfbe94a01139915b0ace41d3e6b497c13171eb8.jpeg?format=jpg&precrop=2749,2749,x687,y0,safe",
      "tags": [
        "manual_image_crop:{\"x\":687,\"y\":0,\"width\":2749,\"height\":2749}"
      ],
      "crop_parameters": []
    },
    "avg_brand_review_rating": "4.9"
  },
  "from_url": "https://www.faire.com/category/Food%20&%20Drink/subcategory/Coffee%20&%20Tea?page=2"
}

Each scraped product returns a structured record with 14+ fields covering product details, pricing, images, brand info, and promotional flags:

Product Core Data

Field	Meaning
Product	Product name and primary identifier as displayed on Faire
Brand	Manufacturer or brand name associated with the product
Based In Country	Country of origin or brand headquarters
Badge List	Promotional or quality badges assigned to the product (e.g., "New," "Trending," "Best Seller")

Pricing & Retail Info

Field	Meaning
Min Option Retail Price	Minimum suggested retail price for the product or its variants
Options Details	Variant information (e.g., sizes, colors, SKUs with individual pricing)
Container Style	Packaging or container type (e.g., bulk pack, individual unit, wholesale case)

Promotional & Display Status

Field	Meaning
Has Active Brand Promo	Boolean flag indicating if the product has an active brand-initiated promotion or discount
Is Highlighted Product For Promotional Event	Boolean flag indicating if the product is featured in a current Faire promotional campaign or seasonal event
Quick Add Display Type	How the product is displayed for quick purchase (e.g., grid, list, featured)

Images & Media

Field	Meaning
Best Image	URL to the primary product image (optimized for display)
Images	Array of all available product image URLs for the listing

Advanced Fields

Field	Meaning
Settings To Assign On View	Configuration options to apply when displaying the product (e.g., default variant selection, display preferences)
POS Insights	Point-of-sale metadata (e.g., inventory level indicators, turnover predictions, margin insights)

---

How to Use

1. Find Faire URLs — Navigate to Faire.com, browse categories, or search for products. Copy the URL from the category page or search results (e.g., https://www.faire.com/category/Food%20&%20Drink/subcategory/Coffee%20&%20Tea?page=2).

2. Build your input — Paste URLs into the urls array. Add multiple URLs to scrape different categories in one run.

3. Configure limits — Set max_items_per_url based on your needs (20 for quick tests, 200 for comprehensive data).

4. Enable error handling — Keep ignore_url_failures: true to avoid interruptions if a page fails to load.

5. Run the scraper — Start the actor and monitor progress via the run log.

6. Export results — Download data as JSON, CSV, or Excel for analysis, import to databases, or integrate with downstream systems.

Troubleshooting:

• If no products are returned, verify the URL is a category or search results page (not a single product page)
• Check that pagination parameters are correctly formatted (e.g., ?page=2 not ?p=2)
• If pages load slowly, reduce max_items_per_url to speed up collection

---

Use Cases & Business Value

• Wholesale sourcing: Identify new suppliers and compare product assortments across Faire categories
• Price monitoring: Track wholesale pricing trends and promotional activity over time
• Market research: Analyze product popularity, badge distribution, and brand presence by category
• Dropshipping: Build catalogs of trending wholesale products with pricing and images
• Retail analytics: Benchmark your product assortment against competitor offerings on Faire
• Promotional insights: Monitor which products are featured in campaigns to spot market trends

The Faire Product Scraper transforms Faire's wholesale marketplace into a searchable, actionable dataset — eliminating hours of manual browsing and enabling data-driven sourcing and business decisions.

---

Conclusion

The Faire Product Scraper is an essential tool for retailers, researchers, and e-commerce businesses leveraging Faire as a sourcing platform. With support for 14+ fields including images, pricing, brand data, and promotional insights, it delivers the structured information needed for competitive analysis, product discovery, and catalog management. Start scraping today and unlock the full potential of Faire's wholesale marketplace.