Faire Wholesale Scraper

Pull wholesale product and brand data from Faire.com at scale — retail prices, minimum order values, case sizes, brand ratings, credibility badges, and Instagram handles for every maker in a search, category, or brand catalog. Built for boutique buyers, wholesale market analysts, and product researchers who need a clean, structured feed of Faire's marketplace without clicking through thousands of brand pages by hand.

Why This Scraper?

• Minimum order value and case size on every row — the two numbers wholesale buyers actually budget against: each brand's opening-order minimum (minimumOrderValue) and the units-per-case (unitsPerCase) a SKU ships in, so you can filter suppliers by budget before you ever message them.
• Full brand profiles with per-star review breakdown — average rating, total review count, and a count of how many 5-star vs 1-star reviews each brand has earned (brandStarBreakdown), folded onto every product.
• Brand credibility badges — Eco-Friendly, Women-Owned, Handmade, Organic and more surfaced as a clean list, so you can shortlist suppliers by the values your shelf sells on.
• Instagram handle for direct outreach — each brand's Instagram handle comes attached to the row, turning a product list into an outreach list with a working channel, not just a name.
• Retail price resolved across every variant — the suggested retail price is computed across all of a product's options (sizes, colors, scents), so multi-variant products still return one clean price.
• Three URL entry types plus keyword search — paste a Faire search, category, or brand-page URL, or just type keywords like "ceramic mugs"; each input is auto-detected and processed on its own.
• Up to 5,000 products per search or URL — deep pagination runs a whole category to exhaustion, well past the 3,000-product ceiling of comparable tools.
• Brand country and lead time — human-readable shipping-origin country (e.g. "Spain", not "ESP") and estimated lead time in days for supply-chain and landed-cost planning.
• One-toggle brand enrichment — flip full brand detail off for a fast product-only pass, or on for the complete supplier dossier on every row.

Use Cases

Retail Sourcing

• Build a shortlist of makers in a category filtered by minimum order value and case size
• Compare brands by rating and review volume before committing to an opening order
• Discover new and best-seller products across a vertical in one run
• Pull an entire brand's catalog from a single brand-page URL

Wholesale Market Research

• Map product assortment and pricing across a category like candles, jewelry, or skincare
• Track how many brands carry a badge (Women-Owned, Eco-Friendly) in a segment
• Benchmark retail price points across competing makers
• Monitor lead times and country-of-origin distribution in a product niche

Lead Generation

• Build supplier outreach lists with brand name, Instagram handle, and brand URL
• Target makers by country, rating threshold, or credibility badge
• Segment prospects by minimum order value to match your buying budget
• Feed qualified brand leads straight into a CRM

Product & Assortment Research

• Analyze case sizes and minimum orders to model shelf economics
• Compare category taxonomy and product mix across brands
• Identify trending best-sellers and new arrivals to inform buying decisions
• Collect product imagery for merchandising mockups and lookbooks

Price & Availability Monitoring

• Track retail price movements on a watch-list of products over time
• Watch product status (for sale, sold out) across a category
• Re-run a saved search on a schedule to catch new brands entering a niche
• Compare pricing across markets and currencies

Getting Started

Search by Keyword

The simplest way to start — one or more search terms:

{
    "searchTerms": ["candles"]
}

Deeper Run with Multiple Terms

{
    "searchTerms": ["ceramic mugs", "organic skincare"],
    "maxProductsPerQuery": 300,
    "brandEnrichment": true
}

Pull a Whole Brand or Category by URL

Paste Faire search, category, or brand-page URLs directly:

{
    "startUrls": [
        "https://www.faire.com/category/Jewelry",
        "https://www.faire.com/brand/b_ka9gz7z7z6"
    ],
    "maxProductsPerQuery": 500,
    "brandEnrichment": true
}

Fast Product-Only Pass

Turn brand enrichment off for a quicker, lighter run:

{
    "searchTerms": ["stationery"],
    "maxProductsPerQuery": 1000,
    "brandEnrichment": false
}

Input Reference

What to Scrape

Parameter	Type	Default	Description
searchTerms	string[]	["candles"]	Keywords to search on Faire, such as "ceramic mugs" or "organic skincare". Each term is searched separately. Leave empty if you are pasting page URLs instead.
startUrls	string[]	[]	Faire.com URLs — search result pages, category pages, or brand pages. The scraper auto-detects each URL type. Leave empty if you are using search terms instead.

Limits & Detail

Parameter	Type	Default	Description
maxProductsPerQuery	integer	100	Maximum products to collect for each search term or URL (1–5,000). Results come in pages of 60, so small values round up to the nearest 60 (a value of 1 still returns 60). Lower it to keep runs fast and cheap; raise it to go deep on a category or brand.
brandEnrichment	boolean	true	Add the full brand profile to every product — country, ratings and review breakdown, badges, minimum order value, lead time, and Instagram. Turn off for a faster, product-only run.

Output

Each product is one flat row. When brand enrichment is on, the brand's profile fields are attached to every product from that brand. A representative row:

{
    "id": "p_abc123xyz",
    "name": "Hand-Poured Soy Candle — Amber & Moss",
    "productUrl": "https://www.faire.com/product/p_abc123xyz",
    "imageUrl": "https://cdn.faire.com/fastly/abc123.jpg",
    "images": [
        "https://cdn.faire.com/fastly/abc123.jpg",
        "https://cdn.faire.com/fastly/abc124.jpg"
    ],
    "retailPrice": 28.0,
    "currency": "USD",
    "minimumOrderValue": 150.0,
    "unitsPerCase": 6,
    "leadTimeDays": "5",
    "isNew": false,
    "isBestSeller": true,
    "status": "FOR_SALE",
    "category": "Candles",
    "brandId": "b_ka9gz7z7z6",
    "brandName": "Northwind Candle Co.",
    "brandUrl": "https://www.faire.com/brand/b_ka9gz7z7z6",
    "brandCountry": "United States",
    "brandBadges": ["Handmade", "Women-Owned", "Eco-Friendly"],
    "brandRating": 4.8,
    "brandReviewCount": 1243,
    "brandStarBreakdown": { "5": 1050, "4": 140, "3": 30, "2": 15, "1": 8 },
    "brandLeadTimeDays": "5",
    "brandInstagram": "northwindcandle",
    "searchQuery": "candles",
    "scrapedAt": "2026-07-24T14:30:00Z"
}

Core Product

Field	Type	Description
id	string	Faire product token
name	string	Product name
productUrl	string	Direct Faire product page URL
imageUrl	string	Primary product image
images	string[]	All product image URLs
category	string	Product category / taxonomy label
status	string	Product state (for sale, sold out, etc.)
isNew	boolean	Marked as a new arrival
isBestSeller	boolean	Marked as a maker best-seller

Pricing & Ordering

Field	Type	Description
retailPrice	number	Suggested retail price, resolved across all product variants
currency	string	ISO currency code (e.g. USD)
minimumOrderValue	number	Brand's minimum opening-order amount
unitsPerCase	number	Units per case / pack (minimum per SKU)
leadTimeDays	string	Estimated ship / lead time in days

Brand Profile

Populated when brandEnrichment is on (a core subset is included even when off).

Field	Type	Description
brandId	string	Faire brand token
brandName	string	Brand name
brandUrl	string	Brand page URL
brandCountry	string	Shipping-origin country, human-readable (e.g. "Spain")
brandBadges	string[]	Credibility badges (Eco-Friendly, Women-Owned, Handmade, Organic, …)
brandRating	number	Average brand rating (stars)
brandReviewCount	integer	Total number of brand reviews
brandStarBreakdown	object	Review count per star level (1–5)
brandLeadTimeDays	string	Brand's stated lead time in days
brandInstagram	string	Brand's Instagram handle

Provenance

Field	Type	Description
searchQuery	string	The search term or URL that produced this row
scrapedAt	string	ISO 8601 timestamp of data collection

Tips for Best Results

• Paste a brand URL to pull a full supplier dossier — a https://www.faire.com/brand/... URL returns that brand's products plus its complete profile (badges, ratings, lead time, Instagram) in one shot, ideal for vetting a single maker fast.
• Use category URLs for exhaustive vertical coverage — a /category/... URL paginates deep, so pair it with a high maxProductsPerQuery to sweep an entire niche rather than a keyword's top results.
• Filter suppliers by budget using the min-order fields — minimumOrderValue and unitsPerCase are the fastest way to screen brands to the ones that fit your buying budget before you reach out.
• Turn off brand enrichment for speed — a product-only pass is faster and still returns core brand fields like name, rating, and minimum order value; switch it on when you need badges, the star breakdown, and Instagram handles.
• Start small, then scale — set maxProductsPerQuery to 20–50 on your first run to confirm the data fits your needs, then raise it for a full pull.
• Mix search terms and URLs in one run — combine keyword terms with category and brand URLs; each is processed separately and tagged in searchQuery so you always know its source.
• Wholesale (retailer-only) prices are not returned — Faire shows discounted wholesale pricing only to signed-in retail accounts, so this actor reports the public suggested retail price; use minimumOrderValue and unitsPerCase for cost planning.

Pricing

From $2.50 per 1,000 results — competitively priced for bulk wholesale market research, with every product row counting as one result. Bronze, Silver, and Gold subscribers pay progressively less; the table below shows total cost at each discount tier.

Results	No discount	Bronze	Silver	Gold
100	$0.30	$0.29	$0.27	$0.25
1,000	$3.00	$2.85	$2.65	$2.50
10,000	$30.00	$28.50	$26.50	$25.00
100,000	$300.00	$285.00	$265.00	$250.00

A "result" is any product row in the output dataset. No compute or time-based charges — you pay per result, plus a small fixed per-run start fee.

Integrations

Export data in JSON, CSV, Excel, XML, or RSS. Connect to 1,500+ apps via:

• Zapier / Make / n8n — Workflow automation
• Google Sheets — Direct spreadsheet export
• Slack / Email — Notifications on new results
• Webhooks — Trigger custom APIs on run completion
• Apify API — Full programmatic access

Legal & Ethical Use

This actor is designed for legitimate wholesale market research, product sourcing, and supplier lead generation. Users are responsible for complying with applicable laws and Faire's Terms of Service. Collect only publicly available data, respect intellectual property, and do not use extracted data for spam, harassment, or any unlawful purpose.