# Faire Product Details Scraper (`e-commerce/faire-product-details-scraper`) Actor

Use this scraper to collect data from the Faire marketplace. Extract detailed product information, including prices, descriptions, images, and in-stock availability. Download the data in multiple structured formats for easy analysis and integration.

- **URL**: https://apify.com/e-commerce/faire-product-details-scraper.md
- **Developed by:** [E Commerce](https://apify.com/e-commerce) (Apify)
- **Categories:** E-commerce
- **Stats:** 49 total users, 3 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.50 / 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

**Powered by [E-commerce Scraping Tool](https://apify.com/apify/e-commerce-scraping-tool).** Need data from other stores too? The E-commerce Scraping Tool gets you data from Faire, Amazon, eBay, and any other e-commerce site.

## Faire Product Details Scraper

> Extract wholesale product data from Faire.com by product URL or sitemap - wholesale and retail prices, minimum order quantities, case packs, lead times, brand details, variants, and GTINs - with no Faire account required.

### What does Faire Product Details Scraper do?

Faire Product Details Scraper collects structured product data from Faire.com, the B2B wholesale marketplace that connects independent retailers with brands and makers. Unlike a consumer storefront, every Faire listing carries wholesale economics - minimum order quantities, case-pack rules, unit multipliers, volume pricing, and brand lead times - and this Actor turns all of it into clean records. Paste product URLs or a Faire sitemap URL, set an optional per-URL cap, and export to JSON, CSV, or Excel. No Faire buyer account, approval, or API required.

- 💰 **Wholesale and retail pricing** - per-unit cost in cents plus suggested retail price
- 📦 **Order rules** - minimum order quantity, per-style minimums, and case-pack details
- 🏷️ **Brand intelligence** - rating, review count, lead time, and minimum order amount
- 🎨 **Every variant** - options with GTIN, available units, and measurements
- 📊 **Clean output** - structured records ready for sourcing analysis

### What data can you extract from Faire?

| Product and pricing | Wholesale order terms | Brand and variants |
|---|---|---|
| 🛍️ Product name | 📦 Minimum order quantity | 🏬 Brand name and token |
| 💰 Retail price (cents, currency) | 🔢 Per-style minimum quantity | ⭐ Brand average rating |
| 📈 Volume pricing by quantity | 🧰 Sold in pre-packs flag | 🗣️ Number of brand reviews |
| 🖼️ Product images and visuals | ✖️ Unit multiplier | ⏱️ Lead time in days |
| 📝 Attributes and specifications | 🆕 Preorderable and new flags | 🔖 Option GTIN and available units |

### How do Faire wholesale order terms work in the data?

Faire is built for retail buyers, so each record exposes the terms that matter when sourcing inventory: the brand `minimum_order_amount`, the product `min_order_quantity` and `per_style_min_order_quantity`, the `unit_multiplier` and `sold_in_pre_packs` flags for case packs, and `has_volume_pricing` plus a `wholesale_price_by_quantity_list` per option. That lets you model the true cost of stocking a line before you ever open a buyer account.

### How does Faire Product Details Scraper work?

1. Add one or more Faire product page URLs, or a Faire sitemap URL for bulk collection
2. (Optional) Set `maxProductsPerStartUrl` to cap how many products to pull from each start URL
3. The Actor visits each product and extracts product, pricing, order-term, and brand fields
4. Results stream to a dataset you can preview or export as JSON, CSV, or Excel

### How to use Faire Product Details Scraper

1. Create a free [Apify account](https://console.apify.com/sign-up)
2. Paste Faire product page URLs, or a Faire sitemap URL for bulk runs
3. (Optional) Set the maximum number of products per start URL
4. Click **Start**
5. Download your data from the **Dataset** tab

#### Input example

```json
{
  "startUrls": [{ "url": "https://www.faire.com/product/p_8x9adp4dzv" }],
  "maxProductsPerStartUrl": 50
}
```

### What does the output look like?

Each product is one structured record with nested `product` and `brand` objects:

```json
{
  "url": "https://www.faire.com/product/p_8x9adp4dzv",
  "scrapedAt": "2025-09-18T10:24:00.000Z",
  "product": {
    "token": "p_8x9adp4dzv",
    "name": { "translated": "Hand-Poured Soy Candle" },
    "state": "SALABLE",
    "purchase_information": {
      "min_order_quantity": 6,
      "per_style_min_order_quantity": 3,
      "unit_multiplier": 1,
      "has_pre_packs_available": false,
      "is_preorderable": false,
      "is_new": true
    },
    "options": {
      "po_6jkc4yfcf8": {
        "display_name": "Lavender",
        "gtin": "0810000000123",
        "available_units": 240,
        "min_order_quantity": 6,
        "sold_in_pre_packs": false,
        "retail_price": { "amount_cents": 1600, "currency": "USD" }
      }
    }
  },
  "brand": {
    "token": "b_a1b2c3",
    "name": "Northern Light Candle Co.",
    "average_rating": "4.8",
    "number_of_reviews": 312,
    "lead_time_days": 5,
    "has_volume_pricing": true,
    "minimum_order_amount": { "amount_cents": 10000, "currency": "USD" }
  }
}
```

### Why use Faire Product Details Scraper?

| Feature | Manual or copy-paste | Faire Product Details Scraper |
|---|---|---|
| Account | Requires an approved buyer login | No Faire account needed |
| Wholesale terms | Read each listing by hand | MOQ, case packs, and unit multipliers in every record |
| Volume pricing | Hidden in the cart | Volume price list per option |
| Brand vetting | Open each brand page | Rating, reviews, and lead time included |
| Export | None | JSON, CSV, Excel |

### What can you do with Faire wholesale data?

- **Retail buyer sourcing** - independent shop owners compare MOQs, case packs, and lead times across brands before committing open-to-buy budget
- **Wholesale price benchmarking** - merchandisers track per-unit wholesale and suggested retail prices to set margins and spot keystone opportunities
- **Brand and maker discovery** - buyers filter by brand rating, review count, and minimum order amount to surface vetted suppliers
- **Assortment and trend planning** - boutique and concept-store teams scan new and preorderable products to plan seasonal assortments
- **Catalog and PIM enrichment** - retailers pull GTINs, measurements, and variant data into their product information systems

For ongoing monitoring, schedule the Actor weekly for stable catalogs or daily for seasonal lines.

### How much does Faire Product Details Scraper cost?

Faire Product Details Scraper uses Apify's pay-per-event pricing: a small fee each time a run starts, plus a flat per-result fee of $2.50 per 1,000 products that stays the same on every plan. Apify gives you $5 in free usage credits every month on the [free plan](https://apify.com/pricing), enough to collect around 2,000 products at no cost. See the Actor's **Pricing** tab for the latest rates.

### How do I run Faire Product Details Scraper via the Apify API?

```bash
curl -X POST "https://api.apify.com/v2/acts/e-commerce~faire-product-details-scraper/runs?token=YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "startUrls": [{ "url": "https://www.faire.com/product/p_8x9adp4dzv" }],
    "maxProductsPerStartUrl": 50
  }'
```

### What can I integrate Faire Product Details Scraper with?

The Actor runs on the Apify platform, so its data feeds straight into the tools your team already uses:

- **Google Sheets and Excel** - build a wholesale sourcing and margin worksheet
- **Make, Zapier, and n8n** - trigger a workflow whenever new products are collected
- **Slack** - alert your buying team when a tracked brand restocks or relists
- **LangChain and MCP** - pipe wholesale product data into AI sourcing agents
- **Apify API and webhooks** - load product records into your PIM or data warehouse

### Limitations

- Collects only publicly visible product and brand data; it does not access buyer-only pricing tiers, private deals, or your account dashboard.
- Some fields, such as volume pricing or pre-pack details, appear only when the brand publishes them.
- Targets Faire.com product and sitemap pages; coverage depends on the current page structure.

### FAQ

#### Do I need a Faire buyer account to use this Actor?

No. Faire Product Details Scraper reads publicly available product and brand pages, so you do not need an approved buyer login, an invitation, or the Faire API to collect data.

#### Can I scrape many Faire products at once from a sitemap?

Yes. Pass a Faire sitemap URL as a start URL and set `maxProductsPerStartUrl` to control the batch size, instead of listing every product URL by hand.

#### What wholesale order terms does the output include?

Each record carries the brand minimum order amount, the product minimum order quantity, per-style minimums, the unit multiplier, pre-pack flags, and a per-option volume price list, so you can model true wholesale cost.

#### Can I get product variants and barcodes?

Yes. The `options` object lists each variant with its display name, GTIN, available units, minimum order quantity, retail price, and physical measurements.

#### How can I judge a brand before ordering?

The `brand` object includes the average rating, number of reviews, lead time in days, and whether the brand offers volume pricing, which together help you vet a maker quickly.

#### Is there an API for Faire Product Details Scraper?

Yes. Start and schedule runs over the Apify REST API and collect results programmatically with the `apify-client` packages for Node.js and Python.

#### Does it work with MCP and AI agents?

Yes. Expose the Actor through the Apify MCP server so your AI agents can fetch Faire wholesale product data on demand.

#### Is it legal to scrape Faire?

Faire Product Details Scraper gathers only publicly accessible product and brand information, not private buyer accounts or personal data. Many regions, including the EU under GDPR, regulate personal data, so keep your use case lawful and read [is web scraping legal?](https://blog.apify.com/is-web-scraping-legal/) if you are unsure.

### Related Actors

- 🛒 [E-commerce Scraping Tool](https://apify.com/apify/e-commerce-scraping-tool) - get product data from Faire, Amazon, eBay, and any other e-commerce site

### Your feedback

Found a bug or want a field added? Open an issue on the Issues tab - we read every one.

# Actor input Schema

## `startUrls` (type: `array`):

Product or sitemap URLs to start scraping from.

## `maxProductsPerStartUrl` (type: `integer`):

The maximum number of products to scrape from each start URL. If not set, all products from the start URL will be scraped. This is useful when start URL is sitemap URL.

## Actor input object example

```json
{
  "startUrls": [
    {
      "url": "https://www.faire.com/product/p_8x9adp4dzv"
    }
  ]
}
```

# Actor output Schema

## `overview` (type: `string`):

No description

# 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 = {
    "startUrls": [
        {
            "url": "https://www.faire.com/product/p_8x9adp4dzv"
        }
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("e-commerce/faire-product-details-scraper").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 = { "startUrls": [{ "url": "https://www.faire.com/product/p_8x9adp4dzv" }] }

# Run the Actor and wait for it to finish
run = client.actor("e-commerce/faire-product-details-scraper").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 '{
  "startUrls": [
    {
      "url": "https://www.faire.com/product/p_8x9adp4dzv"
    }
  ]
}' |
apify call e-commerce/faire-product-details-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=e-commerce/faire-product-details-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

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