# Faire Scraper | Wholesale Products & Brands (`lentic_clockss/faire-scraper`) Actor

Scrape Faire.com wholesale marketplace: products, brands, categories & discover search. Extract product tokens, MOQ, retail/tester prices, ratings, brand pages. Export Excel, CSV, JSON. Guest preview — no retailer login required.

- **URL**: https://apify.com/lentic\_clockss/faire-scraper.md
- **Developed by:** [kane liu](https://apify.com/lentic_clockss) (community)
- **Categories:** E-commerce, Lead generation, Automation
- **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.20 / 1,000 results

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.
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 Scraper | Wholesale Products & Brands

**Scrape [Faire.com](https://www.faire.com) wholesale products, brands, and categories — then download structured marketplace data as Excel, CSV, or JSON.**

Use this Actor as a practical **Faire wholesale data API** for brand discovery, category monitoring, discover/keyword research, and assortment intel. Pick a mode, set a category path, discover slug, brand token (`b_*`), or product token (`p_*`), and get Dataset rows with product/brand tokens, names, guest retail/tester prices, MOQ, ratings, and URLs.

- Browse **Faire categories** (`categoryPath`) with optional filters (`filterKeys`) and sort (`sortBy`)
- Run **discover / keyword** surfaces (`discoverSlug` or `keyword`) with auto-pagination
- Pull **brand shop** catalogs (`brandToken` / brand URLs) with optional `brandFilters`
- Fetch **product PDP** details (`productToken`) plus best-effort related products
- Enumerate the live **category taxonomy** (`mode=categories`)
- Harvest product/brand tokens from **suppliers** listing URLs (`mode=suppliers` + `startUrls`)
- Defaults: **`enrichDetails=true`**, **`autoPaginate=true`**, **`includeRelated=true`**
- Export to **Excel / CSV / JSON**, or connect Make, n8n, Zapier, Python, or the Apify API
- **Pay per event** — Actor start + each Dataset result; **platform usage is included** (you do not pay separate Apify compute on top)

> **Unofficial tool.** This Actor is not affiliated with, endorsed by, or sponsored by Faire Wholesale, Inc. It collects the **guest / public preview** surface (`contentDepth=guest_preview`) and does **not** log in as a retailer, unlock wholesale price ladders, or access private accounts.

***

### What does the Faire Scraper do?

[Faire Scraper](https://apify.com/lentic_clockss/faire-scraper) lets you **extract structured wholesale catalog data from Faire.com** without running your own proxy and browser fleet. Give it a category path (e.g. `Pets`, `Home Decor/subcategory/Kitchen & Tabletop`), a discover slug (`candles`, `mugs`), a brand token (`b_…`), a product token (`p_…`), or a batch of Faire URLs, then start a run.

Under the hood, the Actor:

1. Validates your input (mode, country, paths, tokens, filters)
2. Enforces free-tier caps when you are on a free Apify plan
3. Fetches Faire guest surfaces with geo-aligned residential egress
4. Normalizes product / brand / category / discover rows into a clean Dataset
5. Writes `INPUT_ECHO`, `RUN_SUMMARY` (and `ERROR_SUMMARY` on failure) to the key-value store

You run it like any other Apify Actor — schedule it, call it from the API, or plug it into automations.

***

### What Faire data can I extract?

| Data | Category | Discover | Brand | Product PDP | Categories | Suppliers |
| --- | :---: | :---: | :---: | :---: | :---: | :---: |
| productToken / url | ✅ | ✅ | ✅ | ✅ | — | ✅ harvest |
| brandToken / brand name | ✅ | ✅ | ✅ | ✅ | — | ✅ harvest |
| name / title | enrich | enrich | enrich | ✅ | path/name | varies |
| guest retail / tester price | enrich | enrich | enrich | ✅ | — | — |
| MOQ / order minimum | enrich | enrich | enrich | ✅ | — | — |
| ratings / review signals | enrich | enrich | enrich | ✅ | — | — |
| images | enrich | enrich | enrich | ✅ | — | — |
| categoryPath / taxonomy | ✅ | — | filters | ✅ | ✅ | — |
| discoverSlug / keyword | — | ✅ | — | — | — | — |
| contentDepth = guest\_preview | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |

**Wholesale login prices and retailer-only ladders are out of scope.** Guest preview fields are what this Actor returns.

***

### Why scrape Faire?

Faire is a major **B2B wholesale marketplace** connecting independent brands with retailers across fashion, home, beauty, food, and more. Teams scrape Faire for **brand discovery**, **assortment research**, **price monitoring**, and **lead generation**:

- Monitor **category and discover** surfaces for new products and seasonal demand
- Build **brand lists** with tokens, ratings, and catalog density
- Pull **product detail pages** with guest MOQ, retail/tester prices, and images
- Compare markets with ISO3 `country` (USA, GBR, DEU, AUS, …) and aligned egress
- Feed CRM, BI dashboards, Google Sheets, BigQuery, or AI agents with clean rows

Compared with generic URL scrapers, this Actor returns **Faire-specific fields** (`productToken`, `brandToken`, category paths, discover slugs, guest preview prices) in one input surface.

***

### More Actors like this

Need another wholesale marketplace, B2B directory, or a different vertical? Use a **dedicated Actor** below for structured fields. Use this Actor for **Faire.com** guest wholesale products, brands, and categories.

#### Similar wholesale & B2B scrapers

- [IndiaMART Scraper](https://apify.com/lentic_clockss/indiamart-scraper)
- [Europages Scraper](https://apify.com/lentic_clockss/europages-scraper)
- [GlobalSources Scraper](https://apify.com/lentic_clockss/globalsources-scraper)
- [iPROS Scraper](https://apify.com/lentic_clockss/ipros-scraper)
- [1688 Global Product Search Scraper](https://apify.com/lentic_clockss/1688-global-scraper)
- [Shopee Search Scraper](https://apify.com/lentic_clockss/shopee-search-scraper)
- [Amazon Search Scraper](https://apify.com/lentic_clockss/amazon-search-results-collector)
- [SHEIN Product Scraper](https://apify.com/lentic_clockss/shein-scraper)
- [Temu Product Scraper](https://apify.com/lentic_clockss/temu-scraper)
- [Costco Product Scraper](https://apify.com/lentic_clockss/costco-scraper)
- [Walmart Product Scraper](https://apify.com/lentic_clockss/walmart-scraper)
- [Etsy Scraper](https://apify.com/lentic_clockss/etsy-scraper)
- [Allegro Scraper](https://apify.com/lentic_clockss/allegro-scraper)
- [Lazada Scraper](https://apify.com/lentic_clockss/lazada-ph-search-results-collector)
- [MercadoLibre Scraper](https://apify.com/lentic_clockss/mercadolibre-scraper)

#### Prefer another specialized scraper?

If your target has a specialized Actor below, use that first — usually cheaper and more structured than a generic scrape.

**Jobs & Freelance**

- [LinkedIn Jobs Scraper](https://apify.com/lentic_clockss/linkedin-jobs-scraper)
- [Indeed Jobs Scraper](https://apify.com/lentic_clockss/indeed-jobs-scraper)
- [Upwork Jobs Scraper](https://apify.com/lentic_clockss/upwork-jobs-scraper)
- [Glassdoor Scraper](https://apify.com/lentic_clockss/glassdoor-scraper)
- [Fiverr Gigs Scraper](https://apify.com/lentic_clockss/fiverr-programming-tech-gigs-scraper)
- [Bayt Jobs Scraper](https://apify.com/lentic_clockss/bayt-scraper)

**Real Estate**

- [Zillow & Zumper Scraper](https://apify.com/lentic_clockss/us-real-estate-scraper)
- [Realtor.com Scraper](https://apify.com/lentic_clockss/realtor-com-scraper)
- [Apartments.com Rental Scraper](https://apify.com/lentic_clockss/apartments-com-rental-scraper)
- [Rightmove Scraper](https://apify.com/lentic_clockss/rightmove-property-scraper)
- [Idealista Scraper](https://apify.com/lentic_clockss/idealista-scraper)
- [realestate.com.au Scraper](https://apify.com/lentic_clockss/realestate-com-au-scraper)

**Travel & Stays**

- [Booking.com Hotels Scraper](https://apify.com/lentic_clockss/booking-hotels-scraper)
- [Airbnb Listings Scraper](https://apify.com/lentic_clockss/airbnb-listings-scraper)
- [Expedia Scraper](https://apify.com/lentic_clockss/expedia-scraper)
- [TripAdvisor Scraper](https://apify.com/lentic_clockss/tripadvisor-scraper)

**Social & Content**

- [YouTube Research Scraper](https://apify.com/lentic_clockss/youtube-research-scraper)
- [TikTok Scraper](https://apify.com/lentic_clockss/tiktok-scraper)
- [Reddit Scraper](https://apify.com/lentic_clockss/reddit-scraper)
- [YouTube Shorts Scraper](https://apify.com/lentic_clockss/youtube-shorts-scraper)

**Ads Intelligence**

- [Facebook Ad Library Scraper](https://apify.com/lentic_clockss/facebook-ad-library-scraper)
- [TikTok Ads Scraper](https://apify.com/lentic_clockss/tiktok-ads-top-ads-actor)

**Local & Maps**

- [Google Maps Scraper](https://apify.com/lentic_clockss/google-maps-scraper)

**General Tools**

- [Stealth Web Scraper](https://apify.com/lentic_clockss/stealth-web-scraper)
- [Email Risk Validator](https://apify.com/lentic_clockss/email-risk-validator)
- [Phone Number Intelligence](https://apify.com/lentic_clockss/phone-number-intelligence)

→ See the full catalog in [Related Actors](#related-actors) below, or browse [apify.com/lentic\_clockss](https://apify.com/lentic_clockss).

***

### How to scrape Faire (no code required)

1. Create a free [Apify](https://apify.com/) account
2. Open [Faire Scraper](https://apify.com/lentic_clockss/faire-scraper)
3. Choose a **mode**: `categories`, `category`, `discover`, `brand`, `product`, or `suppliers`
4. Enter a **categoryPath**, **discoverSlug**, **brandToken** (`b_*`), **productToken** (`p_*`), and/or **startUrls**
5. *(Optional)* Set `country` (ISO3), `filterKeys` / `sortBy`, turn off `enrichDetails` if you only need tokens, set `maxResults`
6. Click **Start** and download the Dataset as JSON, CSV, Excel, or JSONL

Start with `maxResults: 5–15` to verify the query, then scale up. For brand/product runs, paste a Faire URL into `startUrls` if you do not already have the token.

***

### How much does it cost to scrape Faire?

This Actor uses **pay-per-event** pricing. You are charged for:

| Event | Price |
| --- | --- |
| Actor Start (`apify-actor-start`) | **$0.005** per start |
| Result (`apify-default-dataset-item`) | **$3.00 / 1,000** results (**$0.003** each on FREE/BRONZE) |

**Platform usage costs are included** — you do **not** pay separate Apify compute/proxy usage for this Actor on top of the event prices above (**User pays platform usage costs = No**).

#### Volume discount tiers (per result)

| Tier | $/1,000 | per result |
| --- | ---: | ---: |
| FREE\* | $3.00 | $0.003 |
| BRONZE | $3.00 | $0.003 |
| SILVER | $2.60 | $0.0026 |
| GOLD | $2.20 | $0.0022 |
| PLATINUM | $2.00 | $0.002 |
| DIAMOND | $1.60 | $0.0016 |

\*FREE matches BRONZE for this Actor.

#### Example cost estimates (FREE/BRONZE)

| Results collected | Approx. event cost\* |
| --- | ---: |
| 100 | ~$0.31 |
| 1,000 | ~$3.01 |
| 10,000 | ~$30.01 |

\*Assumes one Actor start at default memory billing for start events, plus `$0.003` per Dataset item. Exact start billing can scale with allocated memory (one start event per GB, minimum one).

#### Free plan limits

On a **free Apify plan**, this Actor enforces developer limits of **10 runs** and **200 results per run**. Upgrade to a paid Apify plan for unlimited runs (event prices still apply).

***

### Input examples

#### Category browse

```json
{
  "mode": "category",
  "categoryPath": "Pets",
  "country": "USA",
  "maxResults": 20
}
```

#### Discover / keyword

```json
{
  "mode": "discover",
  "discoverSlug": "candles",
  "country": "GBR",
  "enrichDetails": true,
  "maxResults": 15
}
```

#### Brand shop

```json
{
  "mode": "brand",
  "brandToken": "b_egwyjc5kfs",
  "maxPages": 2,
  "maxResults": 30
}
```

#### Product PDP (+ related)

```json
{
  "mode": "product",
  "productToken": "p_zhkghurrv2",
  "includeRelated": true
}
```

#### Category taxonomy

```json
{
  "mode": "categories",
  "topLevelOnly": true,
  "country": "USA"
}
```

#### Batch start URLs

```json
{
  "mode": "category",
  "startUrls": [
    "https://www.faire.com/category/Pets",
    "https://www.faire.com/discover/mugs",
    "https://www.faire.com/product/p_zhkghurrv2"
  ],
  "maxResults": 25
}
```

***

### FAQ

**Q: Do I get wholesale (login) prices?**\
A: No. This Actor returns the **guest preview** surface only (`contentDepth=guest_preview`). Retailer-login wholesale ladders are out of scope.

**Q: Which countries are supported?**\
A: Pass ISO3 `country` (USA, GBR, CAN, AUS, DEU, …). The Actor auto-maps `proxyCountry` (ISO2) for egress alignment.

**Q: What does enrichDetails do?**\
A: When true (default), list cards are enriched via product detail calls so names, guest prices, MOQ, and images fill in. Turn it off for faster token-only harvests.

**Q: Can I pass Faire URLs instead of tokens?**\
A: Yes — use `startUrls` for category, discover, brand, product, or suppliers pages. Mixed URLs are processed in one run.

**Q: Why are related products empty?**\
A: Related tokens are best-effort on the guest surface and often unavailable. The primary PDP still returns.

**Q: Is this affiliated with Faire?**\
A: No. Unofficial third-party tool for publicly reachable guest data.

***

### Input reference

| Parameter | Type | Description |
| --- | --- | --- |
| `mode` | string | `categories` | `category` | `discover` | `brand` | `product` | `suppliers` |
| `country` | string | ISO3 market (default `USA`) |
| `locale` | string | Locale hint (default `en`) |
| `categoryPath` | string | e.g. `Pets` or nested subcategory path |
| `discoverSlug` / `keyword` | string | Discover surface slug |
| `brandToken` | string | `b_*` |
| `productToken` | string | `p_*` |
| `sortBy` | string | `featured` | `new` | `price_asc` | `price_desc` (best-effort) |
| `filterKeys` | array | cat-nav filter keys |
| `brandFilters` | string | Brand page `filters=` query value |
| `page` / `pageSize` / `maxPages` | integer | Pagination controls |
| `maxResults` | integer | Cap Dataset rows (free plan ≤ 200) |
| `autoPaginate` | boolean | Page until empty / caps (default `true`) |
| `enrichDetails` | boolean | PDP enrich for list cards (default `true`) |
| `enrichLimit` | integer | Cap enrich calls (`0` = auto) |
| `includeRelated` | boolean | Product mode related tokens (default `true`) |
| `crawlSubcategories` / `topLevelOnly` | boolean | Categories-mode options |
| `startUrls` | array | Batch Faire URLs |
| `proxyCountry` | string | ISO2 egress hint (auto from `country` when useful) |

Full output schema is available in the Dataset tab. Key-value records: `INPUT_ECHO`, `RUN_SUMMARY`, `ERROR_SUMMARY` (no internal worker URLs).

***

### Connect to your tools

| Platform | How to connect |
| --- | --- |
| **Make.com** | Search "Apify" → "Run Actor" → Actor ID: `lentic_clockss/faire-scraper` |
| **n8n** | Add Apify node → "Run Actor" → same Actor ID |
| **Zapier** | Apify integration → "Run Actor" |
| **Python / Node.js** | Apify SDK or direct HTTPS call |

#### API call example

```bash
curl "https://api.apify.com/v2/acts/lentic_clockss~faire-scraper/runs" \
  -X POST \
  -H "Authorization: Bearer YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"mode":"discover","discoverSlug":"candles","country":"USA","maxResults":10}'
```

Results:

```http
GET https://api.apify.com/v2/datasets/{datasetId}/items?format=json
```

***

### Live-view Standby API

This Actor enables Apify Standby and ships `.actor/openapi.json` for Live-view:

- `GET /` / `GET /health` — Actor readiness (no scrape)
- `GET /input-example` — safe low-cost example input
- `GET /openapi.json` — OpenAPI document
- `POST /search` — optional Live-view preview (capped `maxResults`); persist production results with a **normal Actor run**

Full jobs should be launched as normal Apify Actor runs so Dataset rows plus `INPUT_ECHO`, `RUN_SUMMARY`, and `ERROR_SUMMARY` are persisted.

***

### Runtime

| Setting | Value |
| --- | --- |
| Default memory | **1024 MB** |
| Timeout default | **3600 s** |
| Standby | Enabled (lightweight Live-view) |
| Free plan caps | **10 runs** / **200 results** per run |
| Content depth | **guest\_preview** (no retailer login) |

***

### Related Actors

All **77** public Actors from \[[lentic\_clockss](https://apify.com/lentic_clockss)]. Click a name to open the Store detail page.

#### Jobs & Freelance

- [LinkedIn Jobs Scraper](https://apify.com/lentic_clockss/linkedin-jobs-scraper)
- [Bayt Jobs Scraper](https://apify.com/lentic_clockss/bayt-scraper)
- [Fiverr Gigs Scraper](https://apify.com/lentic_clockss/fiverr-programming-tech-gigs-scraper)
- [Freelancer.com Scraper](https://apify.com/lentic_clockss/freelancer-scraper)
- [Glassdoor Scraper](https://apify.com/lentic_clockss/glassdoor-scraper)
- [Himalayas Jobs Scraper](https://apify.com/lentic_clockss/himalayas-jobs-scraper)
- [Indeed Jobs Scraper](https://apify.com/lentic_clockss/indeed-jobs-scraper)
- [Jobicy Remote Jobs Scraper](https://apify.com/lentic_clockss/jobicy-remote-jobs-scraper)
- [RemoteOK Jobs Scraper](https://apify.com/lentic_clockss/remoteok-all-jobs-scraper)
- [SEEK Jobs Scraper](https://apify.com/lentic_clockss/seek-scraper)
- [Upwork Jobs Scraper](https://apify.com/lentic_clockss/upwork-jobs-scraper)

#### Real Estate

- [Zillow & Zumper Scraper](https://apify.com/lentic_clockss/us-real-estate-scraper)
- [Realtor.com Scraper](https://apify.com/lentic_clockss/realtor-com-scraper)
- [99.co Scraper](https://apify.com/lentic_clockss/ninetynine-co-sg-scraper)
- [Realtor.com Agents Scraper](https://apify.com/lentic_clockss/realtor-com-agents-scraper)
- [Apartments.com Rental Scraper](https://apify.com/lentic_clockss/apartments-com-rental-scraper)
- [Bayut Scraper](https://apify.com/lentic_clockss/bayut-uae-scraper)
- [Craigslist Housing Scraper](https://apify.com/lentic_clockss/craigslist-housing-scraper)
- [Daft.ie Scraper](https://apify.com/lentic_clockss/daft-property-scraper)
- [Dot Property Scraper](https://apify.com/lentic_clockss/dot-property-th-scraper)
- [FINN.no Scraper](https://apify.com/lentic_clockss/finn-scraper)
- [Funda Scraper](https://apify.com/lentic_clockss/funda-scraper)
- [Hepsiemlak Scraper](https://apify.com/lentic_clockss/hepsiemlak-scraper)
- [Idealista Scraper](https://apify.com/lentic_clockss/idealista-scraper)
- [Immobiliare.it Scraper](https://apify.com/lentic_clockss/immobiliare-property-scraper)
- [ImmoScout24 Scraper](https://apify.com/lentic_clockss/immobilienscout24-scraper)
- [Naver Land Scraper](https://apify.com/lentic_clockss/naver-land-scraper)
- [OpenSooq Scraper](https://apify.com/lentic_clockss/opensooq-real-estate-scraper)
- [Otodom Scraper](https://apify.com/lentic_clockss/otodom-scraper)
- [Property Finder Scraper](https://apify.com/lentic_clockss/property-finder-uae-scraper)
- [PropertyGuru Scraper](https://apify.com/lentic_clockss/propertyguru-sg-scraper)
- [realestate.com.au Scraper](https://apify.com/lentic_clockss/realestate-com-au-scraper)
- [Realtor.ca Scraper](https://apify.com/lentic_clockss/realtor-ca-scraper)
- [Rightmove Scraper](https://apify.com/lentic_clockss/rightmove-property-scraper)
- [SeLoger Scraper](https://apify.com/lentic_clockss/seloger-property-scraper)
- [SUUMO Scraper](https://apify.com/lentic_clockss/suumo-property-scraper)
- [Zillow Group Scraper](https://apify.com/lentic_clockss/zillow-group-scraper)

#### E-commerce

- [Shopee Search Scraper](https://apify.com/lentic_clockss/shopee-search-scraper)
- [E-commerce Scraper](https://apify.com/lentic_clockss/ecommerce-scraper)
- [1688 Global Product Search Scraper](https://apify.com/lentic_clockss/1688-global-scraper)
- [Allegro Scraper](https://apify.com/lentic_clockss/allegro-scraper)
- [Amazon Search Scraper](https://apify.com/lentic_clockss/amazon-search-results-collector)
- [ASOS Product Scraper](https://apify.com/lentic_clockss/asos-scraper)
- [Cdiscount Product Scraper](https://apify.com/lentic_clockss/cdiscount-scraper)
- [Costco Product Scraper](https://apify.com/lentic_clockss/costco-scraper)
- [Coupang Product Scraper](https://apify.com/lentic_clockss/coupang-scraper)
- [Etsy Scraper](https://apify.com/lentic_clockss/etsy-scraper)
- [Lazada Scraper](https://apify.com/lentic_clockss/lazada-ph-search-results-collector)
- [MercadoLibre Scraper](https://apify.com/lentic_clockss/mercadolibre-scraper)
- [Mercari Japan Scraper](https://apify.com/lentic_clockss/mercari-scraper)
- [Rakuten Japan Scraper](https://apify.com/lentic_clockss/rakuten-scraper)
- [SHEIN Product Scraper](https://apify.com/lentic_clockss/shein-scraper)
- [Target Product Scraper](https://apify.com/lentic_clockss/target-scraper)
- [Temu Product Scraper](https://apify.com/lentic_clockss/temu-scraper)
- [Walmart Product Scraper](https://apify.com/lentic_clockss/walmart-scraper)

#### Travel & Stays

- [Booking.com & Airbnb Scraper](https://apify.com/lentic_clockss/booking-airbnb-scraper)
- [Agoda Scraper](https://apify.com/lentic_clockss/agoda-scraper)
- [Airbnb Listings Scraper](https://apify.com/lentic_clockss/airbnb-listings-scraper)
- [Booking.com Hotels Scraper](https://apify.com/lentic_clockss/booking-hotels-scraper)
- [Despegar Scraper](https://apify.com/lentic_clockss/despegar-scraper)
- [Expedia Scraper](https://apify.com/lentic_clockss/expedia-scraper)
- [Traveloka Scraper](https://apify.com/lentic_clockss/traveloka-scraper)
- [Travelstart Flights Scraper](https://apify.com/lentic_clockss/travelstart-scraper)
- [Trip.com Scraper](https://apify.com/lentic_clockss/trip-com-scraper)
- [TripAdvisor Scraper](https://apify.com/lentic_clockss/tripadvisor-scraper)

#### Social & Content

- [TikTok Scraper](https://apify.com/lentic_clockss/tiktok-scraper)
- [Reddit Scraper](https://apify.com/lentic_clockss/reddit-scraper)
- [YouTube Shorts Scraper](https://apify.com/lentic_clockss/youtube-shorts-scraper)
- [YouTube Research Scraper](https://apify.com/lentic_clockss/youtube-research-scraper)
- [Hacker News Scraper](https://apify.com/lentic_clockss/hacker-news-scraper)

#### Ads Intelligence

- [Facebook Ad Library Scraper](https://apify.com/lentic_clockss/facebook-ad-library-scraper)
- [Google Ads Transparency VN](https://apify.com/lentic_clockss/google-ads-transparency-center-vn)
- [TikTok Ads Scraper](https://apify.com/lentic_clockss/tiktok-ads-top-ads-actor)

#### Local & Maps

- [Google Maps Scraper](https://apify.com/lentic_clockss/google-maps-scraper)

#### General Tools

- [Stealth Web Scraper](https://apify.com/lentic_clockss/stealth-web-scraper)
- [Email Risk Validator](https://apify.com/lentic_clockss/email-risk-validator)
- [Phone Number Intelligence](https://apify.com/lentic_clockss/phone-number-intelligence)

→ Browse the full profile: [apify.com/lentic\_clockss](https://apify.com/lentic_clockss)

# Actor input Schema

## `mode` (type: `string`):

categories | category | discover | brand | product | suppliers

## `country` (type: `string`):

Faire market country. Auto-maps proxyCountry (USA→US, GBR→GB, …).

## `locale` (type: `string`):

Locale for taxonomy / pages (e.g. en)

## `categoryPath` (type: `string`):

e.g. Pets or Home Decor/subcategory/Kitchen & Tabletop (also accepts pipe form)

## `discoverSlug` (type: `string`):

Discover slug / keyword surface, e.g. candles

## `keyword` (type: `string`):

Alias of discoverSlug

## `brandToken` (type: `string`):

b\_\*

## `productToken` (type: `string`):

p\_\*

## `sortBy` (type: `string`):

category cat-nav sort hint: featured | new | price\_asc | price\_desc (best-effort)

## `filterKeys` (type: `array`):

cat-nav filter\_keys list (from Faire filter panel)

## `brandFilters` (type: `string`):

Brand page filters= query value, e.g. category:home\_living|kitchen\_tabletop

## `page` (type: `integer`):

Listing start page (?page=N)

## `pageSize` (type: `integer`):

cat-nav page size

## `maxPages` (type: `integer`):

Cap for autoPaginate / brand pagination

## `maxResults` (type: `integer`):

Maximum records to return (free plan capped at 200)

## `autoPaginate` (type: `boolean`):

Page until empty / maxResults / maxPages

## `enrichDetails` (type: `boolean`):

Fetch /api/v2/product for list cards (default on — fills name/prices)

## `enrichLimit` (type: `integer`):

0 = min(maxResults, 80)

## `includeRelated` (type: `boolean`):

On product mode, also pull related/similar tokens when present

## `crawlSubcategories` (type: `boolean`):

categories mode: prefer deeper paths

## `topLevelOnly` (type: `boolean`):

categories mode: only emit top-level nodes

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

Batch Faire URLs (category/discover/brand/product/suppliers). Mixed URLs are processed in one run.

## `proxyCountry` (type: `string`):

ISO2 egress hint. Auto-filled from country when left US default on non-USA markets.

## `workerBaseUrl` (type: `string`):

Optional https Cloud Run override (allowlisted)

## Actor input object example

```json
{
  "mode": "category",
  "country": "USA",
  "locale": "en",
  "page": 1,
  "pageSize": 60,
  "maxPages": 10,
  "maxResults": 50,
  "autoPaginate": true,
  "enrichDetails": true,
  "enrichLimit": 0,
  "includeRelated": true,
  "crawlSubcategories": false,
  "topLevelOnly": false,
  "proxyCountry": "US"
}
```

# Actor output Schema

## `results` (type: `string`):

Normalized Faire product / brand / category rows from the default dataset.

## `runSummary` (type: `string`):

Structured summary record stored in the default key-value store.

## `inputEcho` (type: `string`):

Normalized input saved at run start.

## `errorSummary` (type: `string`):

Present when a failed run stores structured terminal error information.

# 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 = {};

// Run the Actor and wait for it to finish
const run = await client.actor("lentic_clockss/faire-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 = {}

# Run the Actor and wait for it to finish
run = client.actor("lentic_clockss/faire-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 '{}' |
apify call lentic_clockss/faire-scraper --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/acts/3DwzlqKnI1WBML5VK/builds/Jp6qNuGBp7DxxwHsJ/openapi.json