# Faire Product Search Scraper (`soft_alexist/faire-product-search-scraper`) Actor Extract detailed product listings from Faire.com wholesale marketplace. Scrape product names, images, pricing, brand info, promotional status, and 14+ fields per item — perfect for market research, price monitoring, and product catalog building. - **URL**: https://apify.com/soft\_alexist/faire-product-search-scraper.md - **Developed by:** [Soft Alexist](https://apify.com/soft_alexist) (community) - **Categories:** Automation, Developer tools, E-commerce - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.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/platform/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 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: ```json { "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 ```json { "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. # Actor input Schema ## `urls` (type: `array`): Add the URLs of the any faire product urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list. ## `ignore_url_failures` (type: `boolean`): If true, the scraper will continue running even if some URLs fail to be scraped. ## `max_items_per_url` (type: `integer`): The maximum number of items to scrape per URL. ## Actor input object example ```json { "urls": [ "https://www.faire.com/category/Food%20&%20Drink/subcategory/Coffee%20&%20Tea?page=2" ], "ignore_url_failures": true, "max_items_per_url": 20 } ``` # 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 = { "urls": [ "https://www.faire.com/category/Food%20&%20Drink/subcategory/Coffee%20&%20Tea?page=2" ], "ignore_url_failures": true, "max_items_per_url": 20 }; // Run the Actor and wait for it to finish const run = await client.actor("soft_alexist/faire-product-search-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 = { "urls": ["https://www.faire.com/category/Food%20&%20Drink/subcategory/Coffee%20&%20Tea?page=2"], "ignore_url_failures": True, "max_items_per_url": 20, } # Run the Actor and wait for it to finish run = client.actor("soft_alexist/faire-product-search-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 '{ "urls": [ "https://www.faire.com/category/Food%20&%20Drink/subcategory/Coffee%20&%20Tea?page=2" ], "ignore_url_failures": true, "max_items_per_url": 20 }' | apify call soft_alexist/faire-product-search-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=soft_alexist/faire-product-search-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Faire Product Search Scraper", "description": "Extract detailed product listings from Faire.com wholesale marketplace. Scrape product names, images, pricing, brand info, promotional status, and 14+ fields per item — perfect for market research, price monitoring, and product catalog building.", "version": "0.0", "x-build-id": "rZCO5syCcRsmOLyyn" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/soft_alexist~faire-product-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-soft_alexist-faire-product-search-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/soft_alexist~faire-product-search-scraper/runs": { "post": { "operationId": "runs-sync-soft_alexist-faire-product-search-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/soft_alexist~faire-product-search-scraper/run-sync": { "post": { "operationId": "run-sync-soft_alexist-faire-product-search-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": { "urls": { "title": "URLs of the any faire product urls to scrape", "type": "array", "description": "Add the URLs of the any faire product urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list.", "items": { "type": "string" } }, "ignore_url_failures": { "title": "Continue running even if some URLs fail to be scraped", "type": "boolean", "description": "If true, the scraper will continue running even if some URLs fail to be scraped." }, "max_items_per_url": { "title": "Max items per URL", "type": "integer", "description": "The maximum number of items to scrape per URL." } } }, "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 } } } } } } } } } } ```