# Faire Brand & Product Data Scraper

> Faire Brand & Product Data Scraper is a paid API for AI agents from api.scrapeforagents.tech, paid per call via x402, $0.025/call, status unknown (last checked 2026-10-02).

Scrapes structured brand and product data from Faire.com, including brand profiles, categories, values filters, and product listings

## Facts

- Endpoint: POST https://api.scrapeforagents.tech/v1/faire?utm_source=zero.xyz
- Price: $0.025/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/faire-brand-product-data-scraper-10ee17a1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_UWiLwM72pcmkeyP7HpxzK

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability faire-brand-product-data-scraper-10ee17a1 -d '<json body>'
```

Example prompt: Can you pull me a list of up to 50 eco-friendly, women-owned brands from Faire's home goods category, including their descriptions, locations, and product counts — keep only brands with at least 5 active products?

## When to prefer this

Choose this endpoint when you need structured, filterable brand or product data from Faire.com without maintaining your own scraper. It is especially valuable for wholesale sourcing research, supplier discovery, and competitive analysis with filtering by brand values (e.g. eco-friendly, women-owned), geography, or category. Prefer this over general web scrapers when you need Faire-specific schema output with built-in enrichment and pay-only-on-success pricing.

## Known failure modes

- Empty result if keyword or filter matches no brands — not charged
- Category URL not publicly accessible returns empty items array
- Invalid brand token returns no matching record
- Rate limiting or scrape blocking by Faire returns error or empty run — not charged
- Malformed brandUrls or productUrls may silently return zero results

## How this service works

Pay-per-call structured web data. Failed or empty runs are not charged.

## Output

A JSON object with a count and an array of brand/product items, each containing brand name, brand token, brand URL, city, state, country, description, and brand type. Profile enrichment (when enabled) adds ratings, minimums, social links, and brand values.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "state": {
   "type": "string",
   "description": "Keep brands whose public state or region contains this text."
  },
  "country": {
   "type": "string",
   "description": "Keep brands whose public origin, production country, or shipping country contains this name or code."
  },
  "keyword": {
   "type": "string",
   "description": "Keep brands whose name, description, category, or subcategory contains this text. This filters discovered brands, not the site search."
  },
  "brandUrls": {
   "type": "array",
   "description": "Specific brand pages with a b_ token in the URL, or bare b_ tokens."
  },
  "startUrls": {
   "type": "array",
   "description": "Public category, supplier, brand-token, or product-token URLs on faire.com."
  },
  "categories": {
   "type": "array",
   "description": "Public category names or category URLs. Each category yields the brands shown in its first public listing."
  },
  "maxResults": {
   "type": "integer",
   "default": 100,
   "minimum": 0,
   "description": "Maximum total brand and product records. Set to 0 for no cap."
  },
  "brandTokens": {
   "type": "array",
   "description": "Specific b_ brand tokens."
  },
  "brandValues": {
   "type": "array",
   "description": "Keep brands with all selected values. One value also narrows a category URL. Options: women-owned, eco-friendly, hand-made, organic, gives-back, small-batch, not-sold-on-amazon."
  },
  "minProducts": {
   "type": "integer",
   "default": 0,
   "minimum": 0,
   "description": "Keep brands with at least this many active products."
  },
  "productUrls": {
   "type": "array",
   "description": "Specific product pages with a p_ token in the URL, or bare p_ tokens."
  },
  "scrapeAllBrands": {
   "type": "boolean",
   "default": false,
   "description": "Discover brand tokens through public brand sitemaps, then fetch profiles until the result limit is reached."
  },
  "enrichBrandProfile": {
   "type": "boolean",
   "default": true,
   "description": "Fetch each brand profile for description, location, values, rating details, minimums, and social link. Turn off for faster tile-only category results."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "items": [
   {
    "city": null,
    "name": null,
    "type": null,
    "state": null,
    "brandUrl": null,
    "brandToken": null,
    "description": null,
    "basedInCountry": null
   }
  ],
  "product": "faire"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/faire-brand-product-data-scraper-10ee17a1/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.scrapeforagents.tech](https://www.zero.xyz/host/api.scrapeforagents.tech/llms.txt)
