# Faire Wholesale Scraper (`solidcode/faire-com-scraper`) Actor \[💰 $2.5 / 1K] Extract wholesale products and brand data from Faire.com — retail & wholesale prices, minimum orders, lead times, ratings, badges, and brand contacts. Search by keyword or paste category, search, and brand page URLs. - **URL**: https://apify.com/solidcode/faire-com-scraper.md - **Developed by:** [SolidCode](https://apify.com/solidcode) (community) - **Categories:** E-commerce, Automation, Developer tools - **Stats:** 2 total users, 1 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. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use 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 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: ```json { "searchTerms": ["candles"] } ```` #### Deeper Run with Multiple Terms ```json { "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: ```json { "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: ```json { "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: ```json { "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. # Actor input Schema ## `searchTerms` (type: `array`): 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` (type: `array`): Paste Faire.com URLs — search result pages, category pages, or brand pages. Products found on each page are collected. Leave empty if you are using search terms instead. ## `maxProductsPerQuery` (type: `integer`): Maximum number of products to collect for each search term or page URL. Results come in pages of 60, so small values round up to the nearest 60 (a value of 1 still returns 60). Lower this to keep runs fast and cheap; raise it to go deep on a category or brand. ## `brandEnrichment` (type: `boolean`): Add rich brand information to every product — location, ratings and review counts, badges (eco-friendly, women-owned, handmade), minimum order value, lead time, and social links. Turn off for a faster, product-only run. ## Actor input object example ```json { "searchTerms": [ "candles" ], "startUrls": [], "maxProductsPerQuery": 100, "brandEnrichment": true } ``` # Actor output Schema ## `overview` (type: `string`): Table of scraped products with pricing and brand fields. # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "searchTerms": [ "candles" ], "startUrls": [], "maxProductsPerQuery": 100, "brandEnrichment": true }; // Run the Actor and wait for it to finish const run = await client.actor("solidcode/faire-com-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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "searchTerms": ["candles"], "startUrls": [], "maxProductsPerQuery": 100, "brandEnrichment": True, } # Run the Actor and wait for it to finish run = client.actor("solidcode/faire-com-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 '{ "searchTerms": [ "candles" ], "startUrls": [], "maxProductsPerQuery": 100, "brandEnrichment": true }' | apify call solidcode/faire-com-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=solidcode/faire-com-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Faire Wholesale Scraper", "description": "[💰 $2.5 / 1K] Extract wholesale products and brand data from Faire.com — retail & wholesale prices, minimum orders, lead times, ratings, badges, and brand contacts. Search by keyword or paste category, search, and brand page URLs.", "version": "1.0", "x-build-id": "qtnlKHADEd8Dy0tqs" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solidcode~faire-com-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solidcode-faire-com-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/solidcode~faire-com-scraper/runs": { "post": { "operationId": "runs-sync-solidcode-faire-com-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/solidcode~faire-com-scraper/run-sync": { "post": { "operationId": "run-sync-solidcode-faire-com-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "searchTerms": { "title": "Search Terms", "type": "array", "description": "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.", "items": { "type": "string" } }, "startUrls": { "title": "Page URLs", "type": "array", "description": "Paste Faire.com URLs — search result pages, category pages, or brand pages. Products found on each page are collected. Leave empty if you are using search terms instead.", "items": { "type": "string" } }, "maxProductsPerQuery": { "title": "Max Products Per Search / URL", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum number of products to collect for each search term or page URL. Results come in pages of 60, so small values round up to the nearest 60 (a value of 1 still returns 60). Lower this to keep runs fast and cheap; raise it to go deep on a category or brand." }, "brandEnrichment": { "title": "Include Full Brand Details", "type": "boolean", "description": "Add rich brand information to every product — location, ratings and review counts, badges (eco-friendly, women-owned, handmade), minimum order value, lead time, and social links. Turn off for a faster, product-only run." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```