# Faire Brand Extractor (`devcake/faire-brand-extractor`) Actor

Extract Faire brands for your retail or E-commerce. Get product catalog,reviews, check supplier ratings, analyze wholesale pricing, lead times and MOQ.

- **URL**: https://apify.com/devcake/faire-brand-extractor.md
- **Developed by:** [devcake](https://apify.com/devcake) (community)
- **Categories:** E-commerce, Lead generation
- **Stats:** 33 total users, 5 monthly users, 89.7% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $7.00 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## 🏭 Faire Supplier Research Tool - Brand Analysis & Reviews

**🔍 Research Faire suppliers. Get wholesale prices, customer reviews, ratings, and complete product catalogs for any Faire brand.**

> 💡 **The fastest way to vet US suppliers, European wholesalers, and global brands on Faire. Read what other retailers really think, check wholesale prices, and make informed sourcing decisions in minutes.**

***

### 👥 Who Is This For?

- 🏪 **Boutique owners** researching **US suppliers** and **American wholesalers** before placing orders
- 📦 **Retail store owners** comparing **wholesale prices** from **European suppliers** and domestic vendors
- 🔍 **Sourcing agents** vetting **B2B suppliers** and **wholesale distributors** for clients
- 💼 **E-commerce sellers** finding products with good margins from **USA manufacturers**
- 📊 **Product researchers** analyzing competitors and **wholesale brands**
- 🛍️ **Dropshippers** evaluating **supplier reliability** and **wholesale vendor** quality
- 🌍 **International buyers** looking for **American suppliers** and **US-based wholesalers**

***

### 📦 What You Get

#### ⭐ Supplier Quality Data

| Data | What It Tells You |
|------|-------------------|
| 🌟 Overall rating | Is this supplier trusted? (1-5 stars) |
| 📝 Review count | How many retailers ordered from them |
| 📊 Star breakdown | 5-star to 1-star distribution |
| ✅ Quality rating | Product quality score |
| 🚚 Fulfillment rating | Delivery reliability score |
| 💬 Communication rating | Customer service score |
| 🏅 Badges | Women-owned, eco-friendly, handmade, etc. |
| 📦 Product count | How many products they offer |
| 🏆 Top shop status | Featured supplier badge |

#### 💬 Customer Reviews

| Data | What It Tells You |
|------|-------------------|
| 📄 Review text | What retailers really think |
| ⭐ Rating | 1-5 star rating |
| 📍 Reviewer location | Where their customers are |
| 👤 Author name | First name of reviewer |
| 📅 Review date | When the review was posted |

#### 💰 Pricing & Orders

| Data | What It Tells You |
|------|-------------------|
| 💵 Wholesale price | Your actual cost (cents + USD) |
| 🏷️ Retail price | What customers pay (cents + USD) |
| 🛒 Minimum order | Smallest order allowed (USD formatted) |
| 💵 First order min | Minimum for first-time retailers (USD formatted) |

#### 🏭 Supplier Details

| Data | What It Tells You |
|------|-------------------|
| ⏱️ Lead time | How long shipping takes (in days) |
| 📅 Est. ship date | Estimated shipping date range (e.g., "Mar 10-19") |
| 🌍 Location | City, state, and country |
| 🏷️ Made in | Manufacturing country of origin |
| 💵 Min order USD | Minimum order amount formatted as USD (e.g., "$60.00") |
| 💵 First order min USD | Minimum for first-time retailers (e.g., "$44.67") |
| 📦 Product count | How many active products they offer |
| 🏅 Badges | Women-owned, eco-friendly, handmade, etc. |
| 🏷️ Categories | Primary product category |
| 🖼️ Profile image | Brand logo/image URL |
| 📸 Instagram | Brand's Instagram handle for direct outreach |

***

### 🎯 Why Use This Tool?

#### ⚡ Save Time

Research 10 **US suppliers** or **European wholesalers** in the time it takes to manually check one. Get all the data you need in a single run.

#### 🛡️ Reduce Risk

Read real reviews from other retailers before placing orders. Avoid **wholesale vendors** with shipping issues or quality problems.

#### 💵 Compare Wholesale Prices

Compare wholesale prices across **American suppliers** and **EU distributors** instantly. See your costs upfront before you order.

#### 📋 Plan Better

See lead times and minimum orders upfront. Know when your inventory will arrive from **US manufacturers** or **European brands**.

#### ✅ Find Quality Wholesale Suppliers

Check ratings, read reviews, and verify certifications. Find **B2B suppliers** that match your store values.

#### 🌎 Discover US & European Suppliers

Most Faire suppliers are based in the **United States** and **Europe**. This tool helps you:

- Find **American wholesalers** with fast shipping to US retailers
- Discover **European suppliers** with unique products
- Research **USA-based manufacturers** for domestic sourcing
- Compare **EU distributors** for international inventory

***

### 🚀 How to Use

#### 📍 Option 1: Direct Brand URLs

1. Go to Faire.com
2. Find a brand you want to research
3. Copy the brand URL (looks like: `https://www.faire.com/brand/b_xxx`)
4. Paste into the **Brand URLs** field

#### 🔍 Option 2: Discover Brands by Category

1. Go to Faire.com and browse categories
2. Copy category URLs (e.g., `https://www.faire.com/category/Jewelry`)
3. Paste into the **Category URLs** field
4. Set **Max Brands to Discover** (default: 50)

#### 🔎 Option 3: Search Brands by Keyword

1. Enter product keywords (e.g., `leather wallet`, `gold jewelry`)
2. Paste into the **Search Keywords** field
3. Set **Max Brands to Discover** (default: 50)

#### ⚙️ Choose What to Get

- 🏭 **Max Brands to Discover**: How many brands to find from categories/keywords (default: 50)
- 📦 **Max Products per Brand**: How many products to extract per brand (0 = skip)
- 💬 **Max Reviews per Brand**: How many reviews to read per brand (0 = skip)

#### 📥 Run & Download

Get your data in JSON, CSV, or Excel format.

***

### 🔍 Brand Discovery (NEW!)

Don't have specific brand URLs? **Discover brands automatically** using:

#### 🔎 Search by Keywords

Find brands by searching for products you're interested in:

```json
{
  "searchKeywords": ["leather wallet", "handmade jewelry"],
  "maxBrandsFromSearch": 50
}
```

**Result:** ✅ Discovers up to 50 brands selling leather wallets and handmade jewelry

#### 📂 Browse by Category

Discover brands from Faire category pages:

```json
{
  "categoryUrls": ["https://www.faire.com/category/New%20Brands"],
  "maxBrandsFromSearch": 30
}
```

**Result:** ✅ Finds up to 30 brands in the "New Brands" category

#### 🔄 Combine All Methods

Mix direct URLs, categories, and keywords in one run:

```json
{
  "brandUrls": ["https://www.faire.com/brand/b_knownbrand"],
  "categoryUrls": ["https://www.faire.com/category/Jewelry"],
  "searchKeywords": ["gold necklace"],
  "maxBrandsFromSearch": 100
}
```

**Result:** ✅ Scrapes known brand + discovers up to 100 brands from categories/keywords

***

### 📄 Sample Output

#### 🏭 Supplier Profile (Brand)

```json
{
  "type": "brand",
  "brand_token": "b_q8gu9by5sv",
  "brand_url": "https://www.faire.com/brand/b_q8gu9by5sv",
  "brand_name": "LE LIS",
  "brand_description": "LE LIS celebrates the vibrant spirit of today's trendy young women...",
  "brand_location": "Vernon",
  "brand_state": "CA",
  "brand_country": "USA",
  "brand_made_in": "CHN",
  "brand_profile_image": "https://cdn.faire.com/fastly/55fba71b...",
  "brand_min_order_usd": "$44.67",
  "brand_first_order_min_usd": "$44.67",
  "brand_lead_time_days": 2,
  "brand_estimated_ship_date": "Mar 10-19",
  "brand_instagram": "leliscollection",
  "brand_categories": "APPAREL",
  "brand_badges": [],
  "brand_is_top_shop": true,
  "brand_active_products_count": 945,
  "brand_rating": 4.8,
  "brand_review_count": 249,
  "brand_5_star_reviews": 234,
  "brand_4_star_reviews": 5,
  "brand_3_star_reviews": 3,
  "brand_2_star_reviews": 1,
  "brand_1_star_reviews": 6,
  "brand_quality_rating": 4.9,
  "brand_fulfillment_rating": 4.9,
  "brand_communication_rating": 4.9,
  "_scraped_at": "2026-03-09T23:27:00.000000+00:00"
}
```

#### 🛍️ Product with Pricing

```json
{
  "type": "product",
  "brand_token": "b_q8gu9by5sv",
  "product_token": "p_tm33c8g7jb",
  "product_name": "Cap Sleeve USA Baby Tee",
  "product_url": "https://www.faire.com/product/p_tm33c8g7jb",
  "product_state": "FOR_SALE",
  "wholesale_price_cents": 1500,
  "retail_price_cents": 4400,
  "wholesale_price_usd": 15,
  "retail_price_usd": 44,
  "product_image_url": null,
  "_scraped_at": "2026-03-08T22:24:12.525651+00:00"
}
```

#### 💬 Customer Review

```json
{
  "type": "review",
  "brand_token": "b_q8gu9by5sv",
  "review_id": "br_uak4sth9dp",
  "rating": 5,
  "review_body": "Great order and delivery process. Amazing quality products too!",
  "author_name": "Sadi",
  "author_location": "Wildwood, MO, United States",
  "author_business_type": null,
  "helpful_count": 0,
  "created_at": "2026-02-24 20:00:00",
  "_scraped_at": "2026-03-08T22:24:12.525651+00:00"
}
```

***

### ✨ What You Can Do

#### 📈 Analyze Wholesale Pricing

See **wholesale vs retail prices** instantly. Know your margins before ordering from **US distributors** or **European suppliers**.
*Example: Wholesale $18.50, Retail $52.00 = 65% margin*

#### ✅ Check Supplier Reliability

Read reviews from other retailers. Spot patterns in **wholesale vendor** feedback.
*Example: "Fast shipping" mentioned 50 times = reliable **US supplier***

#### 🏅 Verify Certifications

Confirm **women-owned**, **eco-friendly**, **handmade**, **small business** claims from **American suppliers**.
*Example: Filter for brands with "women\_owned" or "eco\_friendly" badges*

#### 📋 Plan Your Inventory

Know **lead times** and **minimum orders** from **wholesale distributors** upfront.
*Example: 5-day lead time, $60 minimum = plan accordingly*

#### 🔄 Compare Wholesale Suppliers

Research multiple **B2B suppliers** in one run. Export to compare **US wholesalers** side-by-side.
*Example: Compare 10 **American suppliers'** ratings, prices, and reviews*

#### 🌎 Filter by Location

Find **US-based suppliers** for fast shipping or **European brands** for unique products.
*Example: Filter results by `brand_country` to find USA or EU suppliers*

#### 📸 Contact Suppliers via Social Media

Reach out to **wholesale vendors** directly via Instagram for faster responses and partnership opportunities.
*Example: DM brands with `brand_instagram` handle for quick wholesale inquiries*

#### 🏷️ Verify Manufacturing Origin

Filter **American suppliers** vs **European wholesalers** by actual production location for transparency.
*Example: Filter for `brand_made_in: "USA"` to find domestically manufactured products*

#### 📅 Plan Shipments Accurately

Know exactly when inventory will ship with **estimated ship date ranges** from **wholesale distributors**.
*Example: "Mar 10-19" ship date = plan inventory arrival accordingly*

***

### ❓ Frequently Asked Questions

#### 🤔 How is this different from searching on Faire?

On Faire, you can only see products one at a time. This tool extracts complete **wholesale supplier** data: all products, all reviews, all ratings - in minutes.

#### 🇺🇸 Can I find US-based suppliers?

Yes! Most suppliers on Faire are **American wholesalers** and **US manufacturers**. The tool shows each supplier's location (city, state, country) so you can filter for **US-based suppliers** with fast domestic shipping.

#### 🇪🇺 What about European suppliers?

Faire has many **European wholesalers** from the UK, Germany, France, Italy, and other EU countries. Research **EU suppliers** just like US ones - all location data is included.

#### 🔐 Do I need a Faire account?

No account needed for basic data. **Wholesale prices** require retailer access (included automatically with the tool).

#### 📝 How many reviews can I get?

Up to 1,000 reviews per **wholesale vendor**. Most **B2B suppliers** have 50-500 reviews from other retailers.

#### 🔄 Can I research multiple suppliers at once?

Yes! Enter multiple brand URLs and research 10+ **wholesale distributors** in one run. Perfect for comparing **US suppliers** side-by-side.

#### 🔗 What's a brand URL?

It's the link to a **supplier's page** on Faire. Format: `https://www.faire.com/brand/b_xxx`

#### 📦 Can I get products without reviews?

Yes! Set "Max Reviews" to 0 to skip reviews and only get **wholesale product catalogs**.

#### 💬 Can I get reviews without products?

Yes! Set "Max Products" to 0 to skip products and only get **supplier reviews** and ratings.

#### ✅ How accurate is the data?

Data comes directly from Faire's platform in real-time. **Wholesale prices**, ratings, and availability are current.

***

### ⚠️ Free Tier Limitations

This Actor allows up to **10 results** for users on Apify's free plan.
To get **unlimited results**, upgrade to a [paid Apify plan](https://apify.com/pricing).

***

### 🔗 Related Tools

#### 🔍 Faire Data Scraper

**Looking for product discovery?** Check out our **[Faire Data Scraper →](https://apify.com/devcake/faire-data-scraper)**

> 🛒 **Search products by keyword** across thousands of Faire brands. Perfect for product discovery, market research, and finding new suppliers by category.

| Feature | Brand Scraper (This Tool) | Data Scraper |
|---------|---------------------------|--------------|
| **Input** | Brand URLs | Search keywords |
| **Purpose** | Deep supplier analysis | Product discovery |
| **Reviews** | ✅ Full text + details | ❌ Counts only |
| **Catalog** | ✅ Complete brand catalog | Search results only |
| **Best For** | Vetting specific suppliers | Finding new products |

**💡 Pro Tip:** Use both tools together! First, use the **Data Scraper** to discover interesting products and brands. Then, use this **Brand Scraper** to deep-dive into the suppliers you found.

***

<p align="center">
  <strong>🔍 Ready to research Faire suppliers?</strong><br>
  Get wholesale prices, reviews, and ratings in minutes.<br><br>
</p>

# Actor input Schema

## `brandUrls` (type: `array`):

List of Faire brand URLs to scrape. Each URL should be in the format: https://www.faire.com/brand/b\_xxx

## `categoryUrls` (type: `array`):

Faire category URLs to discover brands from. Example: https://www.faire.com/category/New%20Brands

## `searchKeywords` (type: `array`):

Keywords to search for brands. Example: leather wallet, jewelry, handbag

## `maxBrandsFromSearch` (type: `integer`):

Maximum number of brands to discover from category URLs and search keywords combined. Brands are covered by the default dataset item charge.

## `maxProductsPerBrand` (type: `integer`):

Maximum number of products to scrape from each brand. Set to 0 to skip product scraping. Pricing: $2 per 1,000 products ($0.002/product)

## `maxReviewsPerBrand` (type: `integer`):

Maximum number of reviews to scrape from each brand. Set to 0 to skip review scraping. Pricing: $2 per 1,000 reviews ($0.002/review)

## `useProxy` (type: `boolean`):

Use residential proxy for requests (recommended for reliability)

## Actor input object example

```json
{
  "brandUrls": [],
  "categoryUrls": [],
  "searchKeywords": [
    "leather bag"
  ],
  "maxBrandsFromSearch": 30,
  "maxProductsPerBrand": 0,
  "maxReviewsPerBrand": 0,
  "useProxy": true
}
```

# Actor output Schema

## `dataset` (type: `string`):

URL to the dataset containing all scraped data

## `brands` (type: `string`):

URL to view brand records only

## `products` (type: `string`):

URL to view product records only

## `reviews` (type: `string`):

URL to view review records only

## `summary` (type: `string`):

Run statistics including brands scraped, products, and reviews

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "brandUrls": [],
    "categoryUrls": [],
    "searchKeywords": [
        "leather bag"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("devcake/faire-brand-extractor").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "brandUrls": [],
    "categoryUrls": [],
    "searchKeywords": ["leather bag"],
}

# Run the Actor and wait for it to finish
run = client.actor("devcake/faire-brand-extractor").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "brandUrls": [],
  "categoryUrls": [],
  "searchKeywords": [
    "leather bag"
  ]
}' |
apify call devcake/faire-brand-extractor --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=devcake/faire-brand-extractor",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/AezhdeNc9mTGsDJMi/builds/qq1ec4aLSk1f92Su7/openapi.json